fnts 2.2.0 → 3.0.1

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2021-2021 Dmytro Vasylkivskyi
+Copyright (c) 2021-2024 Dmytro Vasylkivskyi
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

package/README.md

@@ -21,7 +21,7 @@ TypeScript / JavaScript functional programming utilities inspired by the
 
 ## Installation
 
-**TypeScript 4.7 is required for this package's typings to work properly.**
+**TypeScript 5.0 is required for this package's typings to work properly.**
 
 ```shell
 npm i fnts

package/apply.js

@@ -1,27 +1,16 @@
-"use strict";
 /**
  * @module Application
  */
-Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * Applies all functions on curried arguments and returns an array of results.
  */
-function apply() {
-    var functions = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        functions[_i] = arguments[_i];
-    }
-    return function () {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        var length = functions.length;
-        var result = new Array(length);
-        for (var index = 0; index < length; index += 1) {
-            result[index] = functions[index].apply(functions, args);
+export default function apply(...functions) {
+    return (...args) => {
+        const length = functions.length;
+        const result = new Array(length);
+        for (let index = 0; index < length; index += 1) {
+            result[index] = functions[index](...args);
         }
         return result;
     };
 }
-exports.default = apply;

package/compose.js

@@ -1,24 +1,11 @@
-"use strict";
 /**
  * @module Composition
  */
-Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * (B -> C) . (A -> B) = A -> C
  */
-function compose(f, g) {
-    var maybeArgs = [];
-    for (var _i = 2; _i < arguments.length; _i++) {
-        maybeArgs[_i - 2] = arguments[_i];
-    }
+export default function compose(f, g, ...maybeArgs) {
     return maybeArgs.length === 0
-        ? function () {
-            var args = [];
-            for (var _i = 0; _i < arguments.length; _i++) {
-                args[_i] = arguments[_i];
-            }
-            return f(g.apply(void 0, args));
-        }
-        : f(g.apply(void 0, maybeArgs));
+        ? (...args) => f(g(...args))
+        : f(g(...maybeArgs));
 }
-exports.default = compose;

package/curry.js

@@ -1,8 +1,6 @@
-"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,
@@ -11,27 +9,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * 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;
+export default function curry(fn, length = fn.length) {
+    return (...args) => {
+        const argsLength = args.length;
         if (argsLength === length) {
-            return fn.apply(void 0, args);
+            return fn(...args);
         }
         if (argsLength > length) {
-            return fn.apply(void 0, args.slice(0, length));
+            return fn(...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);
+        return curry((...nextArgs) => fn(...args.concat(nextArgs)), length - argsLength);
     };
 }
-exports.default = curry;

package/either/either-sync.d.ts

@@ -1,7 +1,7 @@
 /**
  * @module Either
  */
-import type { Either } from './either';
+import type { Either } from './either.js';
 /**
  * Type constructor for `Either`.
  * Creates either `Right` of the value provided,

package/either/either-sync.js

@@ -1,21 +1,18 @@
-"use strict";
 /**
  * @module Either
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-var left_1 = require("./left");
-var right_1 = require("./right");
+import left from './left.js';
+import right from './right.js';
 /**
  * Type constructor for `Either`.
  * Creates either `Right` of the value provided,
  * or `Left` of the thrown error.
  */
-function eitherSync(value) {
+export default function eitherSync(value) {
     try {
-        return (0, right_1.default)(value());
+        return right(value());
     }
     catch (error) {
-        return (0, left_1.default)(error);
+        return left(error);
     }
 }
-exports.default = eitherSync;

package/either/either.d.ts

@@ -1,8 +1,8 @@
 /**
  * @module Either
  */
-import { Left } from './left';
-import { Right } from './right';
+import { Left } from './left.js';
+import { Right } from './right.js';
 /**
  * Type constructor for `Either`.
  * Can be either `Right` of the value provided,

package/either/either.js

@@ -1,18 +1,15 @@
-"use strict";
 /**
  * @module Either
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-var left_1 = require("./left");
-var right_1 = require("./right");
+import left from './left.js';
+import right from './right.js';
 /**
  * Type constructor for `Either`.
  * Creates either `Right` of the value provided,
  * or `Left` of the error thrown.
  */
-function either(value) {
+export default function either(value) {
     return value()
-        .then(right_1.default)
-        .catch(left_1.default);
+        .then(right)
+        .catch(left);
 }
-exports.default = either;

package/either/index.d.ts

@@ -1,4 +1,4 @@
-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';
+export { default, Either } from './either.js';
+export { default as left, Left } from './left.js';
+export { default as right, Right } from './right.js';
+export { default as eitherSync } from './either-sync.js';

package/either/index.js

@@ -1,11 +1,4 @@
-"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; } });
+export { default } from './either.js';
+export { default as left } from './left.js';
+export { default as right } from './right.js';
+export { default as eitherSync } from './either-sync.js';

package/either/left.js

@@ -1,26 +1,21 @@
-"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');
+export const 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,
+export default function left(value) {
+    return {
+        [lid]: value,
         // @ts-expect-error: Undocumented API for external use
-        _a.toString = function () {
-            return "Left ".concat(value);
-        },
-        _a;
+        toString() {
+            return `Left ${value}`;
+        }
+    };
 }
-exports.default = left;

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

@@ -1,9 +1,9 @@
 /**
  * @module Either Operators
  */
-import { Left } from '../../left';
-import { Right } from '../../right';
-import type { Either } from '../../either';
+import { Left } from '../../left.js';
+import { Right } from '../../right.js';
+import type { Either } from '../../either.js';
 /**
  * A type to unwrap either the left or the right value type
  * of the provided `Monad`.

package/either/operators/bifold/bifold.js

@@ -1,17 +1,14 @@
-"use strict";
 /**
  * @module Either Operators
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-var guards_1 = require("../guards");
-var left_1 = require("../../left");
-var right_1 = require("../../right");
+import { isLeft } from '../guards.js';
+import { lid } from '../../left.js';
+import { rid } from '../../right.js';
 /**
  * Unwraps either the left or the right value of the provided `monad`.
  */
-function bifold(monad) {
-    return (0, guards_1.isLeft)(monad)
-        ? monad[left_1.lid]
-        : monad[right_1.rid];
+export default function bifold(monad) {
+    return isLeft(monad)
+        ? monad[lid]
+        : monad[rid];
 }
-exports.default = bifold;

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

@@ -1,8 +1,8 @@
 /**
  * @module Either Operators
  */
-import { Left } from '../../left';
-import type { Either } from '../../either';
+import { Left } from '../../left.js';
+import type { Either } from '../../either.js';
 /**
  * A type to unwrap the left value type of the provided `Monad`.
  * If the `Monad` is `Right`, returns `undefined`.

package/either/operators/bifold/bifoldl.js

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

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

@@ -1,8 +1,8 @@
 /**
  * @module Either Operators
  */
-import { Right } from '../../right';
-import type { Either } from '../../either';
+import { Right } from '../../right.js';
+import type { Either } from '../../either.js';
 /**
  * A type to unwrap the right value type of the provided `Monad`.
  * If the `Monad` is `Left`, returns `undefined`.

package/either/operators/bifold/bifoldr.js

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

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

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

package/either/operators/bifold/index.js

@@ -1,9 +1,3 @@
-"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; } });
+export { default } from './bifold.js';
+export { default as bifoldl } from './bifoldl.js';
+export { default as bifoldr } from './bifoldr.js';

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

@@ -1,7 +1,7 @@
 /**
  * @module Either Operators
  */
-import type { Either } from '../../either';
+import type { Either } from '../../either.js';
 import type { Map } from '../../../types/map';
 /**
  * Maps provided `monad` to a value,

package/either/operators/bifold-map/bifold-map.js

@@ -1,31 +1,24 @@
-"use strict";
 /**
  * @module Either Operators
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-var bifold_1 = require("../bifold");
-var compose_1 = require("../../../compose");
-var guards_1 = require("../guards");
-var permutation_3_1 = require("../../../permutation/permutation-3");
-var bifoldl_map_1 = require("./bifoldl-map");
-var bifoldr_map_1 = require("./bifoldr-map");
-function bifoldMap() {
-    var args = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        args[_i] = arguments[_i];
-    }
+import bifold from '../bifold/index.js';
+import compose from '../../../compose.js';
+import { isEither, isLeft } from '../guards.js';
+import permutation3 from '../../../permutation/permutation-3.js';
+import bifoldlMap from './bifoldl-map.js';
+import bifoldrMap from './bifoldr-map.js';
+export default function bifoldMap(...args) {
     if (args.length === 1) {
-        return function (monad) {
-            return (0, compose_1.default)(args[0], bifold_1.default, monad);
+        return (monad) => {
+            return compose(args[0], bifold, monad);
         };
     }
-    if (args.length === 2 && (0, guards_1.isEither)(args[0])) {
-        return (0, compose_1.default)(args[1], bifold_1.default, args[0]);
+    if (args.length === 2 && isEither(args[0])) {
+        return compose(args[1], bifold, args[0]);
     }
-    return (0, permutation_3_1.default)(function (monad, mapLeft, mapRight) {
-        return ((0, guards_1.isLeft)(monad)
-            ? (0, bifoldl_map_1.default)(monad, mapLeft)
-            : (0, bifoldr_map_1.default)(monad, mapRight));
-    }).apply(void 0, args);
+    return permutation3((monad, mapLeft, mapRight) => {
+        return (isLeft(monad)
+            ? bifoldlMap(monad, mapLeft)
+            : bifoldrMap(monad, mapRight));
+    })(...args);
 }
-exports.default = bifoldMap;

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

@@ -1,10 +1,10 @@
 /**
  * @module Either Operators
  */
-import type { Left } from '../../left';
-import type { Either } from '../../either';
+import type { Left } from '../../left.js';
+import type { Either } from '../../either.js';
 import type { Map } from '../../../types/map';
-import { Bifoldl } from '../bifold/bifoldl';
+import { Bifoldl } from '../bifold/bifoldl.js';
 /**
  * Maps provided `monad`'s left value to a new value,
  * then returns it or `undefined`.

package/either/operators/bifold-map/bifoldl-map.js

@@ -1,21 +1,14 @@
-"use strict";
 /**
  * @module Either Operators
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-var guards_1 = require("../guards");
-var compose_1 = require("../../../compose");
-var bifoldl_1 = require("../bifold/bifoldl");
-var permutation_2_1 = require("../../../permutation/permutation-2");
-function bifoldlMap() {
-    var args = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        args[_i] = arguments[_i];
-    }
-    return (0, permutation_2_1.default)(function (monad, map) {
-        return (0, guards_1.isLeft)(monad)
-            ? (0, compose_1.default)(map, bifoldl_1.default, monad)
+import { isLeft } from '../guards.js';
+import compose from '../../../compose.js';
+import bifoldl from '../bifold/bifoldl.js';
+import permutation2 from '../../../permutation/permutation-2.js';
+export default function bifoldlMap(...args) {
+    return permutation2((monad, map) => {
+        return isLeft(monad)
+            ? compose(map, bifoldl, monad)
             : undefined;
-    }).apply(void 0, args);
+    })(...args);
 }
-exports.default = bifoldlMap;

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

@@ -1,10 +1,10 @@
 /**
  * @module Either Operators
  */
-import { Right } from '../../right';
-import type { Either } from '../../either';
+import { Right } from '../../right.js';
+import type { Either } from '../../either.js';
 import type { Map } from '../../../types/map';
-import { Bifoldr } from '../bifold/bifoldr';
+import { Bifoldr } from '../bifold/bifoldr.js';
 /**
  * Maps provided `monad`'s right value to a new value,
  * then returns it or `undefined`.

package/either/operators/bifold-map/bifoldr-map.js

@@ -1,21 +1,14 @@
-"use strict";
 /**
  * @module Either Operators
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-var guards_1 = require("../guards");
-var compose_1 = require("../../../compose");
-var bifoldr_1 = require("../bifold/bifoldr");
-var permutation_2_1 = require("../../../permutation/permutation-2");
-function bifoldrMap() {
-    var args = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        args[_i] = arguments[_i];
-    }
-    return (0, permutation_2_1.default)(function (monad, map) {
-        return (0, guards_1.isRight)(monad)
-            ? (0, compose_1.default)(map, bifoldr_1.default, monad)
+import { isRight } from '../guards.js';
+import compose from '../../../compose.js';
+import bifoldr from '../bifold/bifoldr.js';
+import permutation2 from '../../../permutation/permutation-2.js';
+export default function bifoldrMap(...args) {
+    return permutation2((monad, map) => {
+        return isRight(monad)
+            ? compose(map, bifoldr, monad)
             : undefined;
-    }).apply(void 0, args);
+    })(...args);
 }
-exports.default = bifoldrMap;

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

@@ -1,3 +1,3 @@
-export { default } from './bifold-map';
-export { default as bifoldlMap } from './bifoldl-map';
-export { default as bifoldrMap } from './bifoldr-map';
+export { default } from './bifold-map.js';
+export { default as bifoldlMap } from './bifoldl-map.js';
+export { default as bifoldrMap } from './bifoldr-map.js';

package/either/operators/bifold-map/index.js

@@ -1,9 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.bifoldrMap = exports.bifoldlMap = exports.default = void 0;
-var bifold_map_1 = require("./bifold-map");
-Object.defineProperty(exports, "default", { enumerable: true, get: function () { return bifold_map_1.default; } });
-var bifoldl_map_1 = require("./bifoldl-map");
-Object.defineProperty(exports, "bifoldlMap", { enumerable: true, get: function () { return bifoldl_map_1.default; } });
-var bifoldr_map_1 = require("./bifoldr-map");
-Object.defineProperty(exports, "bifoldrMap", { enumerable: true, get: function () { return bifoldr_map_1.default; } });
+export { default } from './bifold-map.js';
+export { default as bifoldlMap } from './bifoldl-map.js';
+export { default as bifoldrMap } from './bifoldr-map.js';

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

@@ -1,7 +1,7 @@
 /**
  * @module Either Operators
  */
-import type { Either } from '../../either';
+import type { Either } from '../../either.js';
 import type { Map } from '../../../types/map';
 /**
  * Maps left and right values of the provided `monad` to a new `Either` monad.

package/either/operators/bimap/bimap.js

@@ -1,21 +1,14 @@
-"use strict";
 /**
  * @module Either Operators
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-var guards_1 = require("../guards");
-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 (0, permutation_3_1.default)(function (monad, mapLeft, mapRight) {
-        return (0, guards_1.isLeft)(monad)
-            ? (0, first_1.default)(monad, mapLeft)
-            : (0, second_1.default)(monad, mapRight);
-    }).apply(void 0, args);
+import { isLeft } from '../guards.js';
+import permutation3 from '../../../permutation/permutation-3.js';
+import first from './first.js';
+import second from './second.js';
+export default function bimap(...args) {
+    return permutation3((monad, mapLeft, mapRight) => {
+        return isLeft(monad)
+            ? first(monad, mapLeft)
+            : second(monad, mapRight);
+    })(...args);
 }
-exports.default = bimap;

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

@@ -1,8 +1,8 @@
 /**
  * @module Either Operators
  */
-import { Left } from '../../left';
-import type { Either } from '../../either';
+import { Left } from '../../left.js';
+import type { Either } from '../../either.js';
 import type { Map } from '../../../types/map';
 export type First<Monad extends Either<any, any>> = Monad extends Left<infer LeftValue> ? LeftValue : Monad extends Either<infer LeftValue, any> ? LeftValue : never;
 /**