fnts 1.6.0 → 1.7.0

package/compose.d.ts

@@ -2,7 +2,7 @@
  * @module Composition
  */
 import type { Last } from './types/last';
-import type { UnaryFunction } from './types/function';
+import type { UnaryFunction, VariadicFunction } from './types/function';
 /**
  * Creates a `Composition` type which parses all of the provided functions' types.
  * Any function with either an incorrect argument or a return type will not fit
@@ -10,12 +10,11 @@ import type { UnaryFunction } from './types/function';
  * type matches the return type of the next function and its return type
  * matches the type of the previous function's argument.
  */
-export declare type Composition<Functions extends UnaryFunction[], Length extends number = Functions['length']> = Length extends 1 ? Functions : Functions extends [...infer Rest, infer Penultimate, infer Last] ? [
-    ...Composition<Rest extends UnaryFunction[] ? Last extends UnaryFunction ? Penultimate extends UnaryFunction ? [...Rest, (arg: ReturnType<Last>) => ReturnType<Penultimate>] : never : never : never>,
+export declare type Composition<Functions extends [...UnaryFunction[], VariadicFunction], Length extends number = Functions['length']> = Length extends 1 ? Functions : Functions extends [...infer Rest, infer Penultimate, infer Last] ? [
+    ...Composition<Rest extends UnaryFunction[] ? Last extends UnaryFunction ? Penultimate extends UnaryFunction ? [...Rest, (arg: ReturnType<Last>) => ReturnType<Penultimate>] : never : Last extends VariadicFunction ? Penultimate extends UnaryFunction ? [...Rest, (arg: ReturnType<Last>) => ReturnType<Penultimate>] : never : never : never>,
     Last
 ] : Functions;
 /**
- * Applies all of the provided `functions` one-by-one in right-to-left order
- * starting from the `argument`.
+ * Applies all of the provided `functions` one-by-one in right-to-left order.
  */
-export default function compose<Functions extends UnaryFunction[]>(...functions: Composition<Functions>): (arg: Parameters<Last<Functions>>[0]) => ReturnType<Functions[0]>;
+export default function compose<Functions extends [...UnaryFunction[], VariadicFunction]>(...functions: Composition<Functions>): (...args: Parameters<Last<Functions>>) => ReturnType<Functions[0]>;

package/compose.js

@@ -4,19 +4,24 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 /**
- * Applies all of the provided `functions` one-by-one in right-to-left order
- * starting from the `argument`.
+ * Applies all of the provided `functions` one-by-one in right-to-left order.
  */
 function compose() {
     var functions = [];
     for (var _i = 0; _i < arguments.length; _i++) {
         functions[_i] = arguments[_i];
     }
-    return function (arg) {
+    return function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
         var length = functions.length;
-        var composition = arg;
-        for (var index = length - 1; index >= 0; index -= 1) {
-            composition = functions[index](composition);
+        var composition = functions[length - 1].apply(functions, args);
+        if (length > 1) {
+            for (var index = length - 2; index >= 0; index -= 1) {
+                composition = functions[index](composition);
+            }
         }
         return composition;
     };

package/either/either-sync.js

@@ -12,10 +12,10 @@ var right_1 = require("./right");
  */
 function eitherSync(value) {
     try {
-        return right_1.default(value());
+        return (0, right_1.default)(value());
     }
     catch (error) {
-        return left_1.default(error);
+        return (0, left_1.default)(error);
     }
 }
 exports.default = eitherSync;

package/either/left.js

@@ -19,7 +19,7 @@ function left(value) {
         _a[exports.lid] = value,
         // @ts-expect-error: Undocumented API for external use
         _a.toString = function () {
-            return "Left " + value;
+            return "Left ".concat(value);
         },
         _a;
 }

package/either/operators/bifold/bifold.js

@@ -10,6 +10,6 @@ var bifoldr_1 = require("./bifoldr");
  */
 function bifold(monad) {
     var _a;
-    return (_a = bifoldl_1.default(monad)) !== null && _a !== void 0 ? _a : bifoldr_1.default(monad);
+    return (_a = (0, bifoldl_1.default)(monad)) !== null && _a !== void 0 ? _a : (0, bifoldr_1.default)(monad);
 }
 exports.default = bifold;

package/either/operators/bifold/bifoldl.js

@@ -10,8 +10,8 @@ var left_1 = require("../../left");
  * If the `monad` is `Right`, returns `undefined`.
  */
 function bifoldl(monad) {
-    return guards_1.isLeft(monad)
+    return ((0, guards_1.isLeft)(monad)
         ? monad[left_1.lid]
-        : undefined;
+        : undefined);
 }
 exports.default = bifoldl;

package/either/operators/bifold/bifoldr.js

@@ -10,8 +10,8 @@ var right_1 = require("../../right");
  * If the `monad` is `Left`, returns `undefined`.
  */
 function bifoldr(monad) {
-    return guards_1.isRight(monad)
+    return ((0, guards_1.isRight)(monad)
         ? monad[right_1.rid]
-        : undefined;
+        : undefined);
 }
 exports.default = bifoldr;

package/either/operators/bifold-map.js

@@ -14,13 +14,15 @@ function bifoldMap() {
         args[_i] = arguments[_i];
     }
     if (args.length === 1) {
-        return function (monad) { return args[0](monad); };
+        return function (monad) {
+            return (0, compose_1.default)(args[0], bifold_1.default)(monad);
+        };
     }
-    if (args.length === 2 && guards_1.isEither(args[0])) {
-        return compose_1.default(args[1], bifold_1.default)(args[0]);
+    if (args.length === 2 && (0, guards_1.isEither)(args[0])) {
+        return (0, compose_1.default)(args[1], bifold_1.default)(args[0]);
     }
-    return permutation_3_1.default(function (monad, mapLeft, mapRight) {
-        return ternary_1.default(guards_1.isLeft, compose_1.default(mapLeft, bifold_1.bifoldl), compose_1.default(mapRight, bifold_1.bifoldr))(monad);
+    return (0, permutation_3_1.default)(function (monad, mapLeft, mapRight) {
+        return (0, ternary_1.default)(guards_1.isLeft, (0, compose_1.default)(mapLeft, bifold_1.bifoldl), (0, compose_1.default)(mapRight, bifold_1.bifoldr))(monad);
     }).apply(void 0, args);
 }
 exports.default = bifoldMap;

package/either/operators/bimap/bimap.js

@@ -13,8 +13,8 @@ function bimap() {
     for (var _i = 0; _i < arguments.length; _i++) {
         args[_i] = arguments[_i];
     }
-    return permutation_3_1.default(function (monad, mapLeft, mapRight) {
-        return ternary_1.default(guards_1.isLeft, first_1.default(mapLeft), second_1.default(mapRight))(monad);
+    return (0, permutation_3_1.default)(function (monad, mapLeft, mapRight) {
+        return (0, ternary_1.default)(guards_1.isLeft, (0, first_1.default)(mapLeft), (0, second_1.default)(mapRight))(monad);
     }).apply(void 0, args);
 }
 exports.default = bimap;

package/either/operators/bimap/first.js

@@ -15,8 +15,8 @@ function first() {
     for (var _i = 0; _i < arguments.length; _i++) {
         args[_i] = arguments[_i];
     }
-    return permutation_2_1.default(function (monad, mapLeft) {
-        return ternary_1.default(guards_1.isLeft, compose_1.default(left_1.default, mapLeft, bifold_1.bifoldl), identity_1.default)(monad);
+    return (0, permutation_2_1.default)(function (monad, mapLeft) {
+        return (0, ternary_1.default)(guards_1.isLeft, (0, compose_1.default)(left_1.default, mapLeft, bifold_1.bifoldl), identity_1.default)(monad);
     }).apply(void 0, args);
 }
 exports.default = first;

package/either/operators/bimap/second.js

@@ -15,8 +15,8 @@ function second() {
     for (var _i = 0; _i < arguments.length; _i++) {
         args[_i] = arguments[_i];
     }
-    return permutation_2_1.default(function (monad, mapRight) {
-        return ternary_1.default(guards_1.isRight, compose_1.default(right_1.default, mapRight, bifold_1.bifoldr), identity_1.default)(monad);
+    return (0, permutation_2_1.default)(function (monad, mapRight) {
+        return (0, ternary_1.default)(guards_1.isRight, (0, compose_1.default)(right_1.default, mapRight, bifold_1.bifoldr), identity_1.default)(monad);
     }).apply(void 0, args);
 }
 exports.default = second;

package/either/operators/bindr.js

@@ -14,8 +14,8 @@ function bindr() {
     for (var _i = 0; _i < arguments.length; _i++) {
         args[_i] = arguments[_i];
     }
-    return permutation_2_1.default(function (monad, mapRight) {
-        return ternary_1.default(guards_1.isRight, compose_1.default(mapRight, bifold_1.bifoldr), identity_1.default)(monad);
+    return (0, permutation_2_1.default)(function (monad, mapRight) {
+        return (0, ternary_1.default)(guards_1.isRight, (0, compose_1.default)(mapRight, bifold_1.bifoldr), identity_1.default)(monad);
     }).apply(void 0, args);
 }
 exports.default = bindr;

package/either/operators/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/either/right.js

@@ -19,7 +19,7 @@ function right(value) {
         _a[exports.rid] = value,
         // @ts-expect-error: Undocumented API for external use
         _a.toString = function () {
-            return "Right " + value;
+            return "Right ".concat(value);
         },
         _a;
 }

package/inject.js

@@ -9,7 +9,7 @@ function inject() {
     for (var _i = 0; _i < arguments.length; _i++) {
         args[_i] = arguments[_i];
     }
-    return permutation_2_1.default(function (fn, effect) {
+    return (0, permutation_2_1.default)(function (fn, effect) {
         return (function () {
             var args = [];
             for (var _i = 0; _i < arguments.length; _i++) {

package/maybe/just.js

@@ -19,7 +19,7 @@ function just(value) {
         _a[exports.jid] = value,
         // @ts-expect-error: Undocumented API for external use
         _a.toString = function () {
-            return "Just " + value;
+            return "Just ".concat(value);
         },
         _a;
 }

package/maybe/maybe.js

@@ -11,7 +11,7 @@ var nothing_1 = require("./nothing");
  */
 function maybe(value) {
     return value === null || value === undefined
-        ? nothing_1.default()
-        : just_1.default(value);
+        ? (0, nothing_1.default)()
+        : (0, just_1.default)(value);
 }
 exports.default = maybe;

package/maybe/operators/bind.js

@@ -14,8 +14,8 @@ function bind() {
     for (var _i = 0; _i < arguments.length; _i++) {
         args[_i] = arguments[_i];
     }
-    return permutation_2_1.default(function (monad, map) {
-        return ternary_1.default(guards_1.isJust, compose_1.default(map, fold_1.default), identity_1.default)(monad);
+    return (0, permutation_2_1.default)(function (monad, map) {
+        return (0, ternary_1.default)(guards_1.isJust, (0, compose_1.default)(map, fold_1.default), identity_1.default)(monad);
     }).apply(void 0, args);
 }
 exports.default = bind;

package/maybe/operators/fmap.js

@@ -15,8 +15,8 @@ function fmap() {
     for (var _i = 0; _i < arguments.length; _i++) {
         args[_i] = arguments[_i];
     }
-    return permutation_2_1.default(function (monad, map) {
-        return ternary_1.default(guards_1.isJust, compose_1.default(maybe_1.default, map, fold_1.default), identity_1.default)(monad);
+    return (0, permutation_2_1.default)(function (monad, map) {
+        return (0, ternary_1.default)(guards_1.isJust, (0, compose_1.default)(maybe_1.default, map, fold_1.default), identity_1.default)(monad);
     }).apply(void 0, args);
 }
 exports.default = fmap;

package/maybe/operators/fold-map.js

@@ -13,8 +13,8 @@ function foldMap() {
     for (var _i = 0; _i < arguments.length; _i++) {
         args[_i] = arguments[_i];
     }
-    return permutation_2_1.default(function (monad, map) {
-        return ternary_1.default(guards_1.isJust, compose_1.default(map, fold_1.default), function () { return null; })(monad);
+    return (0, permutation_2_1.default)(function (monad, map) {
+        return (0, ternary_1.default)(guards_1.isJust, (0, compose_1.default)(map, fold_1.default), function () { return null; })(monad);
     }).apply(void 0, args);
 }
 exports.default = foldMap;

package/maybe/operators/fold.js

@@ -10,7 +10,7 @@ var guards_1 = require("./guards");
  * Returns the value of the provided `monad`.
  */
 function fold(monad) {
-    return guards_1.isJust(monad)
+    return (0, guards_1.isJust)(monad)
         ? monad[just_1.jid]
         : monad[nothing_1.nid];
 }

package/maybe/operators/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fnts",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "license": "MIT",
   "author": "Dmytro Vasylkivskyi",
   "description": "TypeScript / JavaScript FP utilities",

package/pipe.d.ts

@@ -2,7 +2,7 @@
  * @module Composition
  */
 import type { Last } from './types/last';
-import type { UnaryFunction } from './types/function';
+import type { UnaryFunction, VariadicFunction } from './types/function';
 /**
  * Creates a `Pipeline` type which parses all of the provided functions' types.
  * Any function with either an incorrect argument or a return type will not fit
@@ -10,12 +10,11 @@ import type { UnaryFunction } from './types/function';
  * type matches the return type of the previous function and its return type
  * matches the type of the next function's argument.
  */
-export declare type Pipeline<Functions extends UnaryFunction[], Length extends number = Functions['length']> = Length extends 1 ? Functions : Functions extends [infer First, infer Second, ...infer Rest] ? [
+export declare type Pipeline<Functions extends [VariadicFunction, ...UnaryFunction[]], Length extends number = Functions['length']> = Length extends 1 ? Functions : Functions extends [infer First, infer Second, ...infer Rest] ? [
     First,
-    ...Pipeline<First extends UnaryFunction ? Second extends UnaryFunction ? Rest extends UnaryFunction[] ? [(arg: ReturnType<First>) => ReturnType<Second>, ...Rest] : never : never : never>
+    ...Pipeline<First extends UnaryFunction ? Second extends UnaryFunction ? Rest extends UnaryFunction[] ? [(arg: ReturnType<First>) => ReturnType<Second>, ...Rest] : never : never : First extends VariadicFunction ? Second extends UnaryFunction ? Rest extends UnaryFunction[] ? [(arg: ReturnType<First>) => ReturnType<Second>, ...Rest] : never : never : never>
 ] : Functions;
 /**
- * Applies all of the provided `functions` one-by-one in left-to-right order
- * starting from the `argument`.
+ * Applies all of the provided `functions` one-by-one in left-to-right order.
  */
-export default function pipe<Functions extends Array<(arg: any) => any>>(...functions: Pipeline<Functions>): (arg: Parameters<Functions[0]>[0]) => ReturnType<Last<Functions>>;
+export default function pipe<Functions extends [VariadicFunction, ...UnaryFunction[]]>(...functions: Pipeline<Functions>): (...args: Parameters<Functions[0]>) => ReturnType<Last<Functions>>;

package/pipe.js

@@ -4,19 +4,24 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 /**
- * Applies all of the provided `functions` one-by-one in left-to-right order
- * starting from the `argument`.
+ * Applies all of the provided `functions` one-by-one in left-to-right order.
  */
 function pipe() {
     var functions = [];
     for (var _i = 0; _i < arguments.length; _i++) {
         functions[_i] = arguments[_i];
     }
-    return function (arg) {
+    return function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
         var length = functions.length;
-        var pipeline = arg;
-        for (var index = 0; index < length; index += 1) {
-            pipeline = functions[index](pipeline);
+        var pipeline = functions[0].apply(functions, args);
+        if (length > 1) {
+            for (var index = 1; index < length; index += 1) {
+                pipeline = functions[index](pipeline);
+            }
         }
         return pipeline;
     };

package/rethrow.js

@@ -9,7 +9,7 @@ var inject_1 = require("./inject");
  * performing an optional side effect.
  */
 function rethrow(effect) {
-    return inject_1.default(function (error) {
+    return (0, inject_1.default)(function (error) {
         throw error;
     }, effect);
 }

package/tap.js

@@ -10,6 +10,6 @@ var identity_1 = require("./identity");
  * passing the received argument through itself.
  */
 function tap(effect) {
-    return inject_1.default(identity_1.default, effect);
+    return (0, inject_1.default)(identity_1.default, effect);
 }
 exports.default = tap;