fnts 1.1.0 → 1.3.1

package/README.md

@@ -1,6 +1,6 @@
 <p align="center">
   <img src="https://raw.githubusercontent.com/drizzer14/fnts/main/logo.svg" height="64" />
-  <h1 align="center">fnts</h1>
+  <h1 align="center">λ fnts</h1>
 </p>
 
 <p align="center">
@@ -24,62 +24,16 @@ TypeScript / JavaScript functional programming utilities inspired by the
 **TypeScript 4.2.2 is required for this package's typings to work properly.**
 
 ```shell
-λ npm i fnts typescript@4.2.2
+npm i fnts
 ```
 
 ```shell
-λ yarn add fnts typescript@4.2.2
+yarn add fnts
 ```
 
 ## Usage
 
-Every function comes with its own module providing the named export of every public API 
-and default export of the function itself:
-
-```typescript
-import compose from 'fnts/compose'
-import maybe, { Maybe } from 'fnts/maybe'
-```
-
-Also, it is possible to import everything from the root by name:
-
-```typescript
-import { compose, maybe, identity } from 'fnts'
-```
-
-### Currying
-
-The [curry](src/curry.ts) function is an attempt to create 
-a generic currying without relying on overloads.
-It supports the currying of functions with a set amount of arguments, 
-as well as variadic functions or the functions with optional arguments.
-The last two, though, require you to set the threshold upon which to curry them,
-as JavaScript does not supply the information about the number of arguments
-in those kinds of functions.
-
-### Composition and pipelines
-
-[Compose](src/compose.ts) and [pipe](src/pipe.ts) functions you'll encounter
-here are pretty unique in their implementation, as they also are described 
-generically rather than through overloads. 
-If you encounter any unexpected behaviour in them, 
-please feel free to create an [issue](https://github.com/drizzer14/fnts/issues).
-
-### Monads
-
-There are two commonly used monads in this package: 
-[Maybe](src/maybe/maybe.ts) and [Either](src/either/either.ts).
-
-Both have their own set of constructors, which rely upon special tags
-represented through symbols – this way the "operators" know you pass them
-the objects related to those monads 
-(e.g. [just](src/maybe/maybe.ts) and [nothing](src/maybe/maybe.ts) from `Maybe` monad).
-
-For both monads there are aforementioned operators, 
-which can perform different transformations on their monads.
-These operators look just like plain functions, so, 
-if you are familiar with Haskell or RxJS, 
-you should quickly get a grasp on them.
+Please, visit the [documentation](https://drizzer14.github.io/fnts) to obtain the information about the usage and API of `fnts`.
 
 ## Motivation
 

package/compose.d.ts

@@ -1,4 +1,7 @@
-import type { Last } from './.internal/last';
+/**
+ * @module Composition
+ */
+import type { Last } from './types/last';
 /**
  * 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
@@ -17,5 +20,4 @@ export declare type Composition<Functions extends Array<(...args: any[]) => any>
  * Applies all of the provided `functions` one-by-one in right-to-left order
  * starting from the `argument`.
  */
-export declare function compose<Functions extends Array<(arg: any) => any>>(...functions: Composition<Functions>): (arg: Parameters<Last<Functions>>[0]) => ReturnType<Functions[0]>;
-export default compose;
+export default function compose<Functions extends Array<(arg: any) => any>>(...functions: Composition<Functions>): (arg: Parameters<Last<Functions>>[0]) => ReturnType<Functions[0]>;

package/compose.js

@@ -1 +1,25 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.compose=compose,exports.default=void 0;function compose(){for(var a=arguments.length,b=Array(a),c=0;c<a;c++)b[c]=arguments[c];return a=>{for(var c,d=b.length,e=a,f=d-1;0<=f;f-=1)c=b[f],e=c(e);return e}}var _default=compose;exports.default=_default;
+"use strict";
+/**
+ * @module Composition
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Applies all of the provided `functions` one-by-one in right-to-left order
+ * starting from the `argument`.
+ */
+function compose() {
+    var functions = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        functions[_i] = arguments[_i];
+    }
+    return function (arg) {
+        var length = functions.length;
+        var composition = arg;
+        for (var index = length - 1; index >= 0; index -= 1) {
+            var current = functions[index];
+            composition = current(composition);
+        }
+        return composition;
+    };
+}
+exports.default = compose;

package/curry.d.ts

@@ -1,5 +1,8 @@
-import type { Slice } from './.internal/slice';
-import type { Gradual } from './.internal/gradual';
+/**
+ * @module Curry
+ */
+import type { Slice } from './types/slice';
+import type { Gradual } from './types/gradual';
 /**
  * Creates a type for an auto-curried function.
  */
@@ -12,5 +15,4 @@ export declare type Currying<Function extends (...args: any[]) => any, Length ex
  * of arguments.
  * Any excess arguments will not be applied.
  */
-export declare function curry<Function extends (...args: any[]) => any, Length extends number = Parameters<Function>['length']>(fn: Function, length?: Length): Currying<Function, Length>;
-export default curry;
+export default function curry<Function extends (...args: any[]) => any, Length extends number = Parameters<Function>['length']>(fn: Function, length?: Length): Currying<Function, Length>;

package/curry.js

@@ -1 +1,37 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.curry=curry,exports.default=void 0;function curry(a){var b=1<arguments.length&&arguments[1]!==void 0?arguments[1]:a.length;return function(){for(var c=arguments.length,d=Array(c),e=0;e<c;e++)d[e]=arguments[e];var f=d.length;return f===b?a.apply(void 0,d):f>b?a.apply(void 0,d.slice(0,b)):curry(a.bind(void 0,...d))}}var _default=curry;exports.default=_default;
+"use strict";
+/**
+ * @module Curry
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Creates an auto-curried function from the one provided.
+ * Until the curried function receives an expected number of arguments,
+ * defined by either its `length` property or the `length` argument of `curry`,
+ * it will return new function which receives from one to the remaining amount
+ * of arguments.
+ * Any excess arguments will not be applied.
+ */
+function curry(fn, length) {
+    if (length === void 0) { length = fn.length; }
+    return function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        var argsLength = args.length;
+        if (argsLength === length) {
+            return fn.apply(void 0, args);
+        }
+        if (argsLength > length) {
+            return fn.apply(void 0, args.slice(0, length));
+        }
+        return curry(function () {
+            var nextArgs = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                nextArgs[_i] = arguments[_i];
+            }
+            return fn.apply(void 0, args.concat(nextArgs));
+        }, length - argsLength);
+    };
+}
+exports.default = curry;

package/either/either-sync.d.ts

@@ -1,8 +1,10 @@
+/**
+ * @module Either
+ */
 import type { Either } from './either';
 /**
  * Type constructor for `Either`.
  * Creates either `Right` of the value provided,
  * or `Left` of the thrown error.
  */
-export declare function eitherSync<LeftValue, RightValue>(value: () => RightValue): Either<LeftValue, RightValue>;
-export default eitherSync;
+export default function eitherSync<LeftValue, RightValue>(value: () => RightValue): Either<LeftValue, RightValue>;

package/either/either-sync.js

@@ -1 +1,21 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.eitherSync=eitherSync,exports.default=void 0;var _left=_interopRequireDefault(require("./left")),_right=_interopRequireDefault(require("./right"));function _interopRequireDefault(a){return a&&a.__esModule?a:{default:a}}function eitherSync(a){try{return(0,_right.default)(a())}catch(a){return(0,_left.default)(a)}}var _default=eitherSync;exports.default=_default;
+"use strict";
+/**
+ * @module Either
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+var left_1 = require("./left");
+var right_1 = require("./right");
+/**
+ * Type constructor for `Either`.
+ * Creates either `Right` of the value provided,
+ * or `Left` of the thrown error.
+ */
+function eitherSync(value) {
+    try {
+        return right_1.default(value());
+    }
+    catch (error) {
+        return left_1.default(error);
+    }
+}
+exports.default = eitherSync;

package/either/either.d.ts

@@ -1,56 +1,17 @@
-export declare const lid: unique symbol;
 /**
- * Type constructor for `Left`.
- * Describes the special object with one property, represented as unique symbol
- * key, holding the provided value type.
+ * @module Either
  */
-export declare type Left<Value> = {
-    [lid]: Value;
-};
-/**
- * Constructor function for `Left`.
- * Creates the special object with one property, represented as unique symbol
- * key, holding the provided value.
- */
-export declare const left: <Value>(value: Value) => Left<Value>;
-/**
- * Internal unique identifier for `Right`.
- */
-export declare const rid: unique symbol;
-/**
- * Type constructor for `Right`.
- * Describes the special object with one property, represented as unique symbol
- * key, holding the provided value type.
- */
-export declare type Right<Value> = {
-    [rid]: Value;
-};
-/**
- * Constructor function for `Right`.
- * Creates the special object with one property, represented as unique symbol
- * key, holding the provided value.
- */
-export declare const right: <Value>(value: Value) => Right<Value>;
-/**
- * Type constructor for `Either`.
- * This can be either `Right` of the resolved promise provided,
- * or `Left` of the rejected one.
-=======
-import left, { Left } from './left'
-import right, { Right } from './right'
-
+import { Left } from './left';
+import { Right } from './right';
 /**
  * Type constructor for `Either`.
  * Can be either `Right` of the value provided,
  * or `Left` of the error thrown.
->>>>>>> origin/release-1.1.0
  */
 export declare type Either<LeftValue, RightValue> = Left<LeftValue> | Right<RightValue>;
 /**
  * Type constructor for `Either`.
-<<<<<<< HEAD
- * This creates either `Right` of the resolved promise provided,
- * or `Left` of the rejected one.
+ * Creates either `Right` of the value provided,
+ * or `Left` of the error thrown.
  */
-export declare const either: <LeftValue, RightValue>(value: () => Promise<RightValue>) => Promise<Either<LeftValue, RightValue>>;
-export default either;
+export default function either<LeftValue, RightValue>(value: () => Promise<RightValue>): Promise<Either<LeftValue, RightValue>>;

package/either/either.js

@@ -1 +1,18 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.either=either,exports.default=void 0;var _left=_interopRequireWildcard(require("./left")),_right=_interopRequireWildcard(require("./right"));function _getRequireWildcardCache(){if("function"!=typeof WeakMap)return null;var a=new WeakMap;return _getRequireWildcardCache=function(){return a},a}function _interopRequireWildcard(a){if(a&&a.__esModule)return a;if(null===a||"object"!=typeof a&&"function"!=typeof a)return{default:a};var b=_getRequireWildcardCache();if(b&&b.has(a))return b.get(a);var c={},d=Object.defineProperty&&Object.getOwnPropertyDescriptor;for(var e in a)if(Object.prototype.hasOwnProperty.call(a,e)){var f=d?Object.getOwnPropertyDescriptor(a,e):null;f&&(f.get||f.set)?Object.defineProperty(c,e,f):c[e]=a[e]}return c.default=a,b&&b.set(a,c),c}function either(a){return a().then(_right.default).catch(_left.default)}var _default=either;exports.default=_default;
+"use strict";
+/**
+ * @module Either
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+var left_1 = require("./left");
+var right_1 = require("./right");
+/**
+ * Type constructor for `Either`.
+ * Creates either `Right` of the value provided,
+ * or `Left` of the error thrown.
+ */
+function either(value) {
+    return value()
+        .then(right_1.default)
+        .catch(left_1.default);
+}
+exports.default = either;

package/either/index.d.ts

@@ -1,4 +1,4 @@
-export { left, Left } from './left';
-export { right, Right } from './right';
-export { eitherSync } from './either-sync';
 export { default, Either } from './either';
+export { default as left, Left } from './left';
+export { default as right, Right } from './right';
+export { default as eitherSync } from './either-sync';

package/either/index.js

@@ -1 +1,11 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"left",{enumerable:!0,get:function get(){return _left.left}}),Object.defineProperty(exports,"Left",{enumerable:!0,get:function get(){return _left.Left}}),Object.defineProperty(exports,"right",{enumerable:!0,get:function get(){return _right.right}}),Object.defineProperty(exports,"Right",{enumerable:!0,get:function get(){return _right.Right}}),Object.defineProperty(exports,"eitherSync",{enumerable:!0,get:function get(){return _eitherSync.eitherSync}}),Object.defineProperty(exports,"default",{enumerable:!0,get:function get(){return _either.default}}),Object.defineProperty(exports,"Either",{enumerable:!0,get:function get(){return _either.Either}});var _left=require("./left"),_right=require("./right"),_eitherSync=require("./either-sync"),_either=_interopRequireWildcard(require("./either"));function _getRequireWildcardCache(){if("function"!=typeof WeakMap)return null;var a=new WeakMap;return _getRequireWildcardCache=function(){return a},a}function _interopRequireWildcard(a){if(a&&a.__esModule)return a;if(null===a||"object"!=typeof a&&"function"!=typeof a)return{default:a};var b=_getRequireWildcardCache();if(b&&b.has(a))return b.get(a);var c={},d=Object.defineProperty&&Object.getOwnPropertyDescriptor;for(var e in a)if(Object.prototype.hasOwnProperty.call(a,e)){var f=d?Object.getOwnPropertyDescriptor(a,e):null;f&&(f.get||f.set)?Object.defineProperty(c,e,f):c[e]=a[e]}return c.default=a,b&&b.set(a,c),c}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eitherSync = exports.right = exports.left = exports.default = void 0;
+var either_1 = require("./either");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return either_1.default; } });
+var left_1 = require("./left");
+Object.defineProperty(exports, "left", { enumerable: true, get: function () { return left_1.default; } });
+var right_1 = require("./right");
+Object.defineProperty(exports, "right", { enumerable: true, get: function () { return right_1.default; } });
+var either_sync_1 = require("./either-sync");
+Object.defineProperty(exports, "eitherSync", { enumerable: true, get: function () { return either_sync_1.default; } });

package/either/left.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Either
+ */
 /**
  * Internal unique identifier for `Left`.
  */
@@ -15,5 +18,4 @@ export declare type Left<Value> = {
  * Creates the special object with one property, represented as unique symbol
  * key, holding the provided value.
  */
-export declare function left<Value>(value: Value): Left<Value>;
-export default left;
+export default function left<Value>(value: Value): Left<Value>;

package/either/left.js

@@ -1 +1,22 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.left=left,exports.default=exports.lid=void 0;var lid=Symbol.for("@@functional/left");exports.lid=lid;function left(a){return{[lid]:a}}var _default=left;exports.default=_default;
+"use strict";
+/**
+ * @module Either
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lid = void 0;
+/**
+ * Internal unique identifier for `Left`.
+ */
+exports.lid = Symbol.for('@@functional/left');
+/**
+ * Constructor function for `Left`.
+ * Creates the special object with one property, represented as unique symbol
+ * key, holding the provided value.
+ */
+function left(value) {
+    var _a;
+    return _a = {},
+        _a[exports.lid] = value,
+        _a;
+}
+exports.default = left;

package/either/operators/bifold/bifold.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Either Operators
+ */
 import type { Left } from '../../left';
 import type { Right } from '../../right';
 import type { Either } from '../../either';
@@ -9,5 +12,4 @@ export declare type Bifold<Monad extends Either<any, any>> = Monad extends Left<
 /**
  * Unwraps either the left or the right value of the provided `monad`.
  */
-export declare function bifold<Monad extends Either<any, any>>(monad: Monad): Bifold<Monad>;
-export default bifold;
+export default function bifold<Monad extends Either<any, any>>(monad: Monad): Bifold<Monad>;

package/either/operators/bifold/bifold.js

@@ -1 +1,15 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.bifold=bifold,exports.default=void 0;var _bifoldl2=_interopRequireDefault(require("./bifoldl")),_bifoldr=_interopRequireDefault(require("./bifoldr"));function _interopRequireDefault(a){return a&&a.__esModule?a:{default:a}}function bifold(a){var b;return null!==(b=(0,_bifoldl2.default)(a))&&void 0!==b?b:(0,_bifoldr.default)(a)}var _default=bifold;exports.default=_default;
+"use strict";
+/**
+ * @module Either Operators
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+var bifoldl_1 = require("./bifoldl");
+var bifoldr_1 = require("./bifoldr");
+/**
+ * Unwraps either the left or the right value of the provided `monad`.
+ */
+function bifold(monad) {
+    var _a;
+    return (_a = bifoldl_1.default(monad)) !== null && _a !== void 0 ? _a : bifoldr_1.default(monad);
+}
+exports.default = bifold;

package/either/operators/bifold/bifoldl.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Either Operators
+ */
 import { Left } from '../../left';
 import type { Either } from '../../either';
 /**
@@ -9,5 +12,4 @@ export declare type Bifoldl<Monad extends Either<any, any>> = Monad extends Left
  * Returns the left value of the provided `monad`.
  * If the `monad` is `Right`, returns `undefined`.
  */
-export declare function bifoldl<Monad extends Either<any, any>>(monad: Monad): Bifoldl<Monad>;
-export default bifoldl;
+export default function bifoldl<Monad extends Either<any, any>>(monad: Monad): Bifoldl<Monad>;

package/either/operators/bifold/bifoldl.js

@@ -1 +1,17 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.bifoldl=bifoldl,exports.default=void 0;var _guards=require("../guards"),_left=require("../../left");function bifoldl(a){return(0,_guards.isLeft)(a)?a[_left.lid]:void 0}var _default=bifoldl;exports.default=_default;
+"use strict";
+/**
+ * @module Either Operators
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+var guards_1 = require("../guards");
+var left_1 = require("../../left");
+/**
+ * Returns the left value of the provided `monad`.
+ * If the `monad` is `Right`, returns `undefined`.
+ */
+function bifoldl(monad) {
+    return guards_1.isLeft(monad)
+        ? monad[left_1.lid]
+        : undefined;
+}
+exports.default = bifoldl;

package/either/operators/bifold/bifoldr.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @module Either Operators
+ */
 import { Right } from '../../right';
 import type { Either } from '../../either';
 /**
@@ -9,5 +12,4 @@ export declare type Bifoldr<Monad extends Either<any, any>> = Monad extends Righ
  * Returns the right value of the provided `monad`.
  * If the `monad` is `Left`, returns `undefined`.
  */
-export declare function bifoldr<Monad extends Either<any, any>>(monad: Monad): Bifoldr<Monad>;
-export default bifoldr;
+export default function bifoldr<Monad extends Either<any, any>>(monad: Monad): Bifoldr<Monad>;

package/either/operators/bifold/bifoldr.js

@@ -1 +1,17 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.bifoldr=bifoldr,exports.default=void 0;var _guards=require("../guards"),_right=require("../../right");function bifoldr(a){return(0,_guards.isRight)(a)?a[_right.rid]:void 0}var _default=bifoldr;exports.default=_default;
+"use strict";
+/**
+ * @module Either Operators
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+var guards_1 = require("../guards");
+var right_1 = require("../../right");
+/**
+ * Returns the right value of the provided `monad`.
+ * If the `monad` is `Left`, returns `undefined`.
+ */
+function bifoldr(monad) {
+    return guards_1.isRight(monad)
+        ? monad[right_1.rid]
+        : undefined;
+}
+exports.default = bifoldr;

package/either/operators/bifold/index.d.ts

@@ -1,3 +1,3 @@
-export { bifoldl, Bifoldl } from './bifoldl';
-export { bifoldr, Bifoldr } from './bifoldr';
-export { default, bifold, Bifold } from './bifold';
+export { default, Bifold } from './bifold';
+export { default as bifoldl, Bifoldl } from './bifoldl';
+export { default as bifoldr, Bifoldr } from './bifoldr';

package/either/operators/bifold/index.js

@@ -1 +1,9 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"bifoldl",{enumerable:!0,get:function get(){return _bifoldl.bifoldl}}),Object.defineProperty(exports,"Bifoldl",{enumerable:!0,get:function get(){return _bifoldl.Bifoldl}}),Object.defineProperty(exports,"bifoldr",{enumerable:!0,get:function get(){return _bifoldr.bifoldr}}),Object.defineProperty(exports,"Bifoldr",{enumerable:!0,get:function get(){return _bifoldr.Bifoldr}}),Object.defineProperty(exports,"default",{enumerable:!0,get:function get(){return _bifold.default}}),Object.defineProperty(exports,"bifold",{enumerable:!0,get:function get(){return _bifold.bifold}}),Object.defineProperty(exports,"Bifold",{enumerable:!0,get:function get(){return _bifold.Bifold}});var _bifoldl=require("./bifoldl"),_bifoldr=require("./bifoldr"),_bifold=_interopRequireWildcard(require("./bifold"));function _getRequireWildcardCache(){if("function"!=typeof WeakMap)return null;var a=new WeakMap;return _getRequireWildcardCache=function(){return a},a}function _interopRequireWildcard(a){if(a&&a.__esModule)return a;if(null===a||"object"!=typeof a&&"function"!=typeof a)return{default:a};var b=_getRequireWildcardCache();if(b&&b.has(a))return b.get(a);var c={},d=Object.defineProperty&&Object.getOwnPropertyDescriptor;for(var e in a)if(Object.prototype.hasOwnProperty.call(a,e)){var f=d?Object.getOwnPropertyDescriptor(a,e):null;f&&(f.get||f.set)?Object.defineProperty(c,e,f):c[e]=a[e]}return c.default=a,b&&b.set(a,c),c}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bifoldr = exports.bifoldl = exports.default = void 0;
+var bifold_1 = require("./bifold");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return bifold_1.default; } });
+var bifoldl_1 = require("./bifoldl");
+Object.defineProperty(exports, "bifoldl", { enumerable: true, get: function () { return bifoldl_1.default; } });
+var bifoldr_1 = require("./bifoldr");
+Object.defineProperty(exports, "bifoldr", { enumerable: true, get: function () { return bifoldr_1.default; } });

package/either/operators/bifold-map.d.ts

@@ -1,4 +1,15 @@
+/**
+ * @module Either Operators
+ */
 import type { Either } from '../either';
-import type { Map } from '../../.internal/map';
-export declare function bifoldMap<LeftValue, RightValue, MappedValue>(monad: Either<LeftValue, RightValue>, mapLeft: Map<LeftValue, MappedValue>, mapRight: Map<RightValue, MappedValue>): MappedValue;
-export default bifoldMap;
+import type { Map } from '../../types/map';
+/**
+ * Maps left and right values of the provided `monad` to a value,
+ * then returns it.
+ */
+export default function bifoldMap<LeftValue, RightValue, MappedValue>(mapLeft: Map<LeftValue, MappedValue>, mapRight: Map<RightValue, MappedValue>): (monad: Either<LeftValue, RightValue>) => MappedValue;
+/**
+ * Maps left and right values of the provided `monad` to a value,
+ * then returns it.
+ */
+export default function bifoldMap<LeftValue, RightValue, MappedValue>(monad: Either<LeftValue, RightValue>, mapLeft: Map<LeftValue, MappedValue>, mapRight: Map<RightValue, MappedValue>): MappedValue;

package/either/operators/bifold-map.js

@@ -1 +1,20 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.bifoldMap=bifoldMap,exports.default=void 0;var _compose=_interopRequireDefault(require("../../compose")),_permutationOf=_interopRequireDefault(require("../../.internal/permutation-of-3")),_guards=require("./guards"),_bifold=require("./bifold");function _interopRequireDefault(a){return a&&a.__esModule?a:{default:a}}function bifoldMap(){return(0,_permutationOf.default)((a,b,c)=>(0,_guards.isLeft)(a)?(0,_compose.default)(b,_bifold.bifoldl)(a):(0,_compose.default)(c,_bifold.bifoldr)(a))(...arguments)}var _default=bifoldMap;exports.default=_default;
+"use strict";
+/**
+ * @module Either Operators
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+var compose_1 = require("../../compose");
+var ternary_1 = require("../../ternary");
+var permutation_3_1 = require("../../permutation/permutation-3");
+var guards_1 = require("./guards");
+var bifold_1 = require("./bifold");
+function bifoldMap() {
+    var args = [];
+    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, compose_1.default(mapLeft, bifold_1.bifoldl), compose_1.default(mapRight, bifold_1.bifoldr))(monad);
+    }).apply(void 0, args);
+}
+exports.default = bifoldMap;

package/either/operators/bimap/bimap.d.ts

@@ -1,11 +1,13 @@
+/**
+ * @module Either Operators
+ */
 import type { Either } from '../../either';
-import type { Map } from '../../../.internal/map';
+import type { Map } from '../../../types/map';
 /**
  * Maps left and right values of the provided `monad` to a new `Either` monad.
  */
-export declare function bimap<LeftValue, RightValue, NextLeftValue, NextRightValue>(mapLeft: Map<LeftValue, NextLeftValue>, mapRight: Map<RightValue, NextRightValue>): (monad: Either<LeftValue, RightValue>) => Either<NextLeftValue, NextRightValue>;
+export default function bimap<LeftValue, RightValue, NextLeftValue, NextRightValue>(mapLeft: Map<LeftValue, NextLeftValue>, mapRight: Map<RightValue, NextRightValue>): (monad: Either<LeftValue, RightValue>) => Either<NextLeftValue, NextRightValue>;
 /**
  * Maps left and right values of the provided `monad` to a new `Either` monad.
  */
-export declare function bimap<LeftValue, RightValue, NextLeftValue, NextRightValue>(monad: Either<LeftValue, RightValue>, mapLeft: Map<LeftValue, NextLeftValue>, mapRight: Map<RightValue, NextRightValue>): Either<NextLeftValue, NextRightValue>;
-export default bimap;
+export default function bimap<LeftValue, RightValue, NextLeftValue, NextRightValue>(monad: Either<LeftValue, RightValue>, mapLeft: Map<LeftValue, NextLeftValue>, mapRight: Map<RightValue, NextRightValue>): Either<NextLeftValue, NextRightValue>;

package/either/operators/bimap/bimap.js

@@ -1 +1,20 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.bimap=bimap,exports.default=void 0;var _guards=require("../guards"),_permutationOf=_interopRequireDefault(require("../../../.internal/permutation-of-3")),_first=_interopRequireDefault(require("./first")),_second=_interopRequireDefault(require("./second"));function _interopRequireDefault(a){return a&&a.__esModule?a:{default:a}}function bimap(){return(0,_permutationOf.default)((a,b,c)=>(0,_guards.isLeft)(a)?(0,_first.default)(a,b):(0,_second.default)(a,c))(...arguments)}var _default=bimap;exports.default=_default;
+"use strict";
+/**
+ * @module Either Operators
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+var guards_1 = require("../guards");
+var ternary_1 = require("../../../ternary");
+var permutation_3_1 = require("../../../permutation/permutation-3");
+var first_1 = require("./first");
+var second_1 = require("./second");
+function bimap() {
+    var args = [];
+    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);
+    }).apply(void 0, args);
+}
+exports.default = bimap;

package/either/operators/bimap/first.d.ts

@@ -1,13 +1,15 @@
+/**
+ * @module Either Operators
+ */
 import type { Either } from '../../either';
-import type { Map } from '../../../.internal/map';
+import type { Map } from '../../../types/map';
 /**
  * Maps the left value of the provided `monad` to a new `Either` monad
  * with the same right value.
  */
-export declare function first<LeftValue, RightValue, NextLeftValue>(mapLeft: Map<LeftValue, NextLeftValue>): (monad: Either<LeftValue, RightValue>) => Either<NextLeftValue, RightValue>;
+export default function first<LeftValue, RightValue, NextLeftValue>(mapLeft: Map<LeftValue, NextLeftValue>): (monad: Either<LeftValue, RightValue>) => Either<NextLeftValue, RightValue>;
 /**
  * Maps the left value of the provided `monad` to a new `Either` monad
  * with the same right value.
  */
-export declare function first<LeftValue, RightValue, NextLeftValue>(monad: Either<LeftValue, RightValue>, mapLeft: Map<LeftValue, NextLeftValue>): Either<NextLeftValue, RightValue>;
-export default first;
+export default function first<LeftValue, RightValue, NextLeftValue>(monad: Either<LeftValue, RightValue>, mapLeft: Map<LeftValue, NextLeftValue>): Either<NextLeftValue, RightValue>;

package/either/operators/bimap/first.js

@@ -1 +1,22 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.first=first,exports.default=void 0;var _guards=require("../guards"),_bifold=require("../bifold"),_compose=_interopRequireDefault(require("../../../compose")),_left=_interopRequireWildcard(require("../../left")),_permutationOf=_interopRequireDefault(require("../../../.internal/permutation-of-2"));function _getRequireWildcardCache(){if("function"!=typeof WeakMap)return null;var a=new WeakMap;return _getRequireWildcardCache=function(){return a},a}function _interopRequireWildcard(a){if(a&&a.__esModule)return a;if(null===a||"object"!=typeof a&&"function"!=typeof a)return{default:a};var b=_getRequireWildcardCache();if(b&&b.has(a))return b.get(a);var c={},d=Object.defineProperty&&Object.getOwnPropertyDescriptor;for(var e in a)if(Object.prototype.hasOwnProperty.call(a,e)){var f=d?Object.getOwnPropertyDescriptor(a,e):null;f&&(f.get||f.set)?Object.defineProperty(c,e,f):c[e]=a[e]}return c.default=a,b&&b.set(a,c),c}function _interopRequireDefault(a){return a&&a.__esModule?a:{default:a}}function first(){return(0,_permutationOf.default)((a,b)=>(0,_guards.isLeft)(a)?(0,_compose.default)(_left.default,b,_bifold.bifoldl)(a):a)(...arguments)}var _default=first;exports.default=_default;
+"use strict";
+/**
+ * @module Either Operators
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+var guards_1 = require("../guards");
+var bifold_1 = require("../bifold");
+var compose_1 = require("../../../compose");
+var left_1 = require("../../left");
+var identity_1 = require("../../../identity");
+var ternary_1 = require("../../../ternary");
+var permutation_2_1 = require("../../../permutation/permutation-2");
+function first() {
+    var args = [];
+    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);
+    }).apply(void 0, args);
+}
+exports.default = first;

package/either/operators/bimap/index.d.ts

@@ -1,3 +1,3 @@
-export { first } from './first';
-export { second } from './second';
-export { default, bimap } from './bimap';
+export { default } from './bimap';
+export { default as first } from './first';
+export { default as second } from './second';