es-toolkit 1.48.1 → 1.49.0

package/dist/fp/pipe.d.mts

@@ -0,0 +1,235 @@
+//#region src/fp/pipe.d.ts
+/**
+ * Returns `value` unchanged — the identity case of {@link pipe} with no functions.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @returns `value`, unchanged.
+ */
+declare function pipe<A>(value: A): A;
+/**
+ * Pipes `value` through `fn1`, returning its result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @returns The result of `fn1`.
+ */
+declare function pipe<A, B>(value: A, fn1: (input: A) => B): B;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn2`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @returns The result of `fn2` — the value returned by the last function.
+ */
+declare function pipe<A, B, C>(value: A, fn1: (input: A) => B, fn2: (input: B) => C): C;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn3`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @returns The result of `fn3` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D): D;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn4`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @returns The result of `fn4` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E): E;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn5`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @returns The result of `fn5` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F): F;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn6`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @returns The result of `fn6` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G): G;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn7`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @param fn7 - Applied to the result of `fn6`.
+ * @returns The result of `fn7` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G, H>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G, fn7: (input: G) => H): H;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn8`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @param fn7 - Applied to the result of `fn6`.
+ * @param fn8 - Applied to the result of `fn7`.
+ * @returns The result of `fn8` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G, H, I>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G, fn7: (input: G) => H, fn8: (input: H) => I): I;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn9`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @param fn7 - Applied to the result of `fn6`.
+ * @param fn8 - Applied to the result of `fn7`.
+ * @param fn9 - Applied to the result of `fn8`.
+ * @returns The result of `fn9` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G, H, I, J>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G, fn7: (input: G) => H, fn8: (input: H) => I, fn9: (input: I) => J): J;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn10`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @param fn7 - Applied to the result of `fn6`.
+ * @param fn8 - Applied to the result of `fn7`.
+ * @param fn9 - Applied to the result of `fn8`.
+ * @param fn10 - Applied to the result of `fn9`.
+ * @returns The result of `fn10` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G, H, I, J, K>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G, fn7: (input: G) => H, fn8: (input: H) => I, fn9: (input: I) => J, fn10: (input: J) => K): K;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn11`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @param fn7 - Applied to the result of `fn6`.
+ * @param fn8 - Applied to the result of `fn7`.
+ * @param fn9 - Applied to the result of `fn8`.
+ * @param fn10 - Applied to the result of `fn9`.
+ * @param fn11 - Applied to the result of `fn10`.
+ * @returns The result of `fn11` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G, fn7: (input: G) => H, fn8: (input: H) => I, fn9: (input: I) => J, fn10: (input: J) => K, fn11: (input: K) => L): L;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn12`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @param fn7 - Applied to the result of `fn6`.
+ * @param fn8 - Applied to the result of `fn7`.
+ * @param fn9 - Applied to the result of `fn8`.
+ * @param fn10 - Applied to the result of `fn9`.
+ * @param fn11 - Applied to the result of `fn10`.
+ * @param fn12 - Applied to the result of `fn11`.
+ * @returns The result of `fn12` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L, M>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G, fn7: (input: G) => H, fn8: (input: H) => I, fn9: (input: I) => J, fn10: (input: J) => K, fn11: (input: K) => L, fn12: (input: L) => M): M;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn13`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @param fn7 - Applied to the result of `fn6`.
+ * @param fn8 - Applied to the result of `fn7`.
+ * @param fn9 - Applied to the result of `fn8`.
+ * @param fn10 - Applied to the result of `fn9`.
+ * @param fn11 - Applied to the result of `fn10`.
+ * @param fn12 - Applied to the result of `fn11`.
+ * @param fn13 - Applied to the result of `fn12`.
+ * @returns The result of `fn13` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L, M, N>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G, fn7: (input: G) => H, fn8: (input: H) => I, fn9: (input: I) => J, fn10: (input: J) => K, fn11: (input: K) => L, fn12: (input: L) => M, fn13: (input: M) => N): N;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn14`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @param fn7 - Applied to the result of `fn6`.
+ * @param fn8 - Applied to the result of `fn7`.
+ * @param fn9 - Applied to the result of `fn8`.
+ * @param fn10 - Applied to the result of `fn9`.
+ * @param fn11 - Applied to the result of `fn10`.
+ * @param fn12 - Applied to the result of `fn11`.
+ * @param fn13 - Applied to the result of `fn12`.
+ * @param fn14 - Applied to the result of `fn13`.
+ * @returns The result of `fn14` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L, M, N, O>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G, fn7: (input: G) => H, fn8: (input: H) => I, fn9: (input: I) => J, fn10: (input: J) => K, fn11: (input: K) => L, fn12: (input: L) => M, fn13: (input: M) => N, fn14: (input: N) => O): O;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn15`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @param fn7 - Applied to the result of `fn6`.
+ * @param fn8 - Applied to the result of `fn7`.
+ * @param fn9 - Applied to the result of `fn8`.
+ * @param fn10 - Applied to the result of `fn9`.
+ * @param fn11 - Applied to the result of `fn10`.
+ * @param fn12 - Applied to the result of `fn11`.
+ * @param fn13 - Applied to the result of `fn12`.
+ * @param fn14 - Applied to the result of `fn13`.
+ * @param fn15 - Applied to the result of `fn14`.
+ * @returns The result of `fn15` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G, fn7: (input: G) => H, fn8: (input: H) => I, fn9: (input: I) => J, fn10: (input: J) => K, fn11: (input: K) => L, fn12: (input: L) => M, fn13: (input: M) => N, fn14: (input: N) => O, fn15: (input: O) => P): P;
+//#endregion
+export { pipe };

package/dist/fp/pipe.d.ts

@@ -0,0 +1,235 @@
+//#region src/fp/pipe.d.ts
+/**
+ * Returns `value` unchanged — the identity case of {@link pipe} with no functions.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @returns `value`, unchanged.
+ */
+declare function pipe<A>(value: A): A;
+/**
+ * Pipes `value` through `fn1`, returning its result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @returns The result of `fn1`.
+ */
+declare function pipe<A, B>(value: A, fn1: (input: A) => B): B;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn2`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @returns The result of `fn2` — the value returned by the last function.
+ */
+declare function pipe<A, B, C>(value: A, fn1: (input: A) => B, fn2: (input: B) => C): C;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn3`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @returns The result of `fn3` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D): D;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn4`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @returns The result of `fn4` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E): E;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn5`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @returns The result of `fn5` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F): F;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn6`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @returns The result of `fn6` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G): G;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn7`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @param fn7 - Applied to the result of `fn6`.
+ * @returns The result of `fn7` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G, H>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G, fn7: (input: G) => H): H;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn8`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @param fn7 - Applied to the result of `fn6`.
+ * @param fn8 - Applied to the result of `fn7`.
+ * @returns The result of `fn8` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G, H, I>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G, fn7: (input: G) => H, fn8: (input: H) => I): I;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn9`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @param fn7 - Applied to the result of `fn6`.
+ * @param fn8 - Applied to the result of `fn7`.
+ * @param fn9 - Applied to the result of `fn8`.
+ * @returns The result of `fn9` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G, H, I, J>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G, fn7: (input: G) => H, fn8: (input: H) => I, fn9: (input: I) => J): J;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn10`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @param fn7 - Applied to the result of `fn6`.
+ * @param fn8 - Applied to the result of `fn7`.
+ * @param fn9 - Applied to the result of `fn8`.
+ * @param fn10 - Applied to the result of `fn9`.
+ * @returns The result of `fn10` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G, H, I, J, K>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G, fn7: (input: G) => H, fn8: (input: H) => I, fn9: (input: I) => J, fn10: (input: J) => K): K;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn11`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @param fn7 - Applied to the result of `fn6`.
+ * @param fn8 - Applied to the result of `fn7`.
+ * @param fn9 - Applied to the result of `fn8`.
+ * @param fn10 - Applied to the result of `fn9`.
+ * @param fn11 - Applied to the result of `fn10`.
+ * @returns The result of `fn11` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G, fn7: (input: G) => H, fn8: (input: H) => I, fn9: (input: I) => J, fn10: (input: J) => K, fn11: (input: K) => L): L;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn12`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @param fn7 - Applied to the result of `fn6`.
+ * @param fn8 - Applied to the result of `fn7`.
+ * @param fn9 - Applied to the result of `fn8`.
+ * @param fn10 - Applied to the result of `fn9`.
+ * @param fn11 - Applied to the result of `fn10`.
+ * @param fn12 - Applied to the result of `fn11`.
+ * @returns The result of `fn12` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L, M>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G, fn7: (input: G) => H, fn8: (input: H) => I, fn9: (input: I) => J, fn10: (input: J) => K, fn11: (input: K) => L, fn12: (input: L) => M): M;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn13`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @param fn7 - Applied to the result of `fn6`.
+ * @param fn8 - Applied to the result of `fn7`.
+ * @param fn9 - Applied to the result of `fn8`.
+ * @param fn10 - Applied to the result of `fn9`.
+ * @param fn11 - Applied to the result of `fn10`.
+ * @param fn12 - Applied to the result of `fn11`.
+ * @param fn13 - Applied to the result of `fn12`.
+ * @returns The result of `fn13` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L, M, N>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G, fn7: (input: G) => H, fn8: (input: H) => I, fn9: (input: I) => J, fn10: (input: J) => K, fn11: (input: K) => L, fn12: (input: L) => M, fn13: (input: M) => N): N;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn14`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @param fn7 - Applied to the result of `fn6`.
+ * @param fn8 - Applied to the result of `fn7`.
+ * @param fn9 - Applied to the result of `fn8`.
+ * @param fn10 - Applied to the result of `fn9`.
+ * @param fn11 - Applied to the result of `fn10`.
+ * @param fn12 - Applied to the result of `fn11`.
+ * @param fn13 - Applied to the result of `fn12`.
+ * @param fn14 - Applied to the result of `fn13`.
+ * @returns The result of `fn14` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L, M, N, O>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G, fn7: (input: G) => H, fn8: (input: H) => I, fn9: (input: I) => J, fn10: (input: J) => K, fn11: (input: K) => L, fn12: (input: L) => M, fn13: (input: M) => N, fn14: (input: N) => O): O;
+/**
+ * Pipes `value` left-to-right through `fn1` to `fn15`, returning the final result.
+ *
+ * @param value - The initial value fed into the pipe.
+ * @param fn1 - Applied to `value`.
+ * @param fn2 - Applied to the result of `fn1`.
+ * @param fn3 - Applied to the result of `fn2`.
+ * @param fn4 - Applied to the result of `fn3`.
+ * @param fn5 - Applied to the result of `fn4`.
+ * @param fn6 - Applied to the result of `fn5`.
+ * @param fn7 - Applied to the result of `fn6`.
+ * @param fn8 - Applied to the result of `fn7`.
+ * @param fn9 - Applied to the result of `fn8`.
+ * @param fn10 - Applied to the result of `fn9`.
+ * @param fn11 - Applied to the result of `fn10`.
+ * @param fn12 - Applied to the result of `fn11`.
+ * @param fn13 - Applied to the result of `fn12`.
+ * @param fn14 - Applied to the result of `fn13`.
+ * @param fn15 - Applied to the result of `fn14`.
+ * @returns The result of `fn15` — the value returned by the last function.
+ */
+declare function pipe<A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P>(value: A, fn1: (input: A) => B, fn2: (input: B) => C, fn3: (input: C) => D, fn4: (input: D) => E, fn5: (input: E) => F, fn6: (input: F) => G, fn7: (input: G) => H, fn8: (input: H) => I, fn9: (input: I) => J, fn10: (input: J) => K, fn11: (input: K) => L, fn12: (input: L) => M, fn13: (input: M) => N, fn14: (input: N) => O, fn15: (input: O) => P): P;
+//#endregion
+export { pipe };

package/dist/fp/pipe.js

@@ -0,0 +1,116 @@
+//#region src/fp/pipe.ts
+/**
+* Performs left-to-right function composition, threading `value` through each
+* function in sequence. Every function receives the output of the previous
+* one, so the data flows top-to-bottom in the same order it is read. This
+* turns deeply nested calls into clear, sequential steps without temporary
+* variables.
+*
+* This is the entry point of `es-toolkit/fp`. Each `es-toolkit/fp` function is
+* called with its configuration (e.g. `map(fn)`, `take(2)`) and returns a
+* function that takes the data, which `pipe` then supplies.
+*
+* When consecutive **lazy-capable** functions (`map`, `filter`, `take`, ...)
+* appear together, `pipe` fuses them and processes the input element-by-element
+* instead of building an intermediate array after every step. This allows
+* early termination: a trailing `take(n)` stops the walk as soon as `n`
+* results exist, so the remaining input is never visited.
+*
+* @param value - The initial value fed into the pipe.
+* @param functions - Data-last operators (or any unary functions) applied in order.
+* @returns The result of applying every function, left to right.
+*
+* @example
+* import { pipe, map, filter, take } from 'es-toolkit/fp';
+*
+* pipe([1, 2, 3], map(x => x * 3)); // => [3, 6, 9]
+*
+* @example
+* // Lazy evaluation with early termination: only the first two even squares
+* // are ever computed, the rest of the array is never touched.
+* pipe(
+*   [1, 2, 3, 4, 5, 6, 7, 8],
+*   map(x => x * x),
+*   filter(x => x % 2 === 0),
+*   take(2)
+* ); // => [4, 16]
+*
+* @example
+* // Any unary function works inside a pipe, not just es-toolkit operators.
+* pipe(
+*   '  Hello  ',
+*   s => s.trim(),
+*   s => s.toLowerCase()
+* ); // => 'hello'
+*/
+function pipe(value, ...functions) {
+	let output = value;
+	const groups = chunkFunctions(functions);
+	for (let groupIndex = 0; groupIndex < groups.length; groupIndex++) {
+		const group = groups[groupIndex];
+		if (group.lazy && isIterable(output) && (group.shortCircuit || !Array.isArray(output))) output = lazyPipe(output, group);
+		else for (let index = 0; index < group.length; index++) output = group[index](output);
+	}
+	return output;
+}
+function chunkFunctions(functions) {
+	if (functions.length === 0) return [];
+	let currentGroup = [functions[0]];
+	const result = [currentGroup];
+	let previousIsLazy = currentGroup[0].lazy != null;
+	if (previousIsLazy) currentGroup.lazy = true;
+	if (currentGroup[0].shortCircuit) currentGroup.shortCircuit = true;
+	for (let index = 1; index < functions.length; index++) {
+		const func = functions[index];
+		const isLazy = func.lazy != null;
+		if (isLazy !== previousIsLazy) {
+			currentGroup = [func];
+			result.push(currentGroup);
+		} else currentGroup.push(func);
+		if (isLazy) currentGroup.lazy = true;
+		if (func.shortCircuit) currentGroup.shortCircuit = true;
+		previousIsLazy = isLazy;
+	}
+	return result;
+}
+/**
+* Fuses a run of lazy functions into a single pass over `data`. The functions'
+* push transforms are composed (last function first) into one sink, then `data`
+* is driven through it element-by-element. A short-circuiting function (e.g.
+* `take`) returns `false`, which stops the drive loop at once, so the functions
+* before it never run on the rest of the input — no intermediate arrays.
+*
+* @param data - The iterable fed into the run (an array, `Set`, generator, ...).
+* @param lazyFunctions - The consecutive lazy functions to fuse, in order.
+* @returns The collected results.
+*/
+function lazyPipe(data, lazyFunctions) {
+	const result = [];
+	let sink = (value) => {
+		result.push(value);
+		return true;
+	};
+	for (let index = lazyFunctions.length - 1; index >= 0; index--) sink = lazyFunctions[index].lazy(sink);
+	if (Array.isArray(data)) {
+		for (let index = 0; index < data.length; index++) if (sink(data[index]) === false) break;
+	} else {
+		const iterator = data[Symbol.iterator]();
+		let step = iterator.next();
+		while (!step.done) {
+			if (sink(step.value) === false) break;
+			step = iterator.next();
+		}
+	}
+	return result;
+}
+/**
+* Whether `value` can be fed through the lazy path. A non-array iterable (a
+* `Set`, a generator, ...) can only go through `lazyPipe`, since the eager path
+* relies on array methods. Primitives and plain objects (no `Symbol.iterator`)
+* fall through to the eager branch.
+*/
+function isIterable(value) {
+	return typeof value === "object" && value !== null && Symbol.iterator in value;
+}
+//#endregion
+exports.pipe = pipe;