fnts 2.1.1 → 3.0.0

package/maybe/index.d.ts

@@ -1,3 +1,3 @@
-export { default, Maybe } from './maybe';
-export { default as just, Just } from './just';
-export { default as nothing, Nothing } from './nothing';
+export { default, Maybe } from './maybe.js';
+export { default as just, Just } from './just.js';
+export { default as nothing, Nothing } from './nothing.js';

package/maybe/index.js

@@ -1,9 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.nothing = exports.just = exports.default = void 0;
-var maybe_1 = require("./maybe");
-Object.defineProperty(exports, "default", { enumerable: true, get: function () { return maybe_1.default; } });
-var just_1 = require("./just");
-Object.defineProperty(exports, "just", { enumerable: true, get: function () { return just_1.default; } });
-var nothing_1 = require("./nothing");
-Object.defineProperty(exports, "nothing", { enumerable: true, get: function () { return nothing_1.default; } });
+export { default } from './maybe.js';
+export { default as just } from './just.js';
+export { default as nothing } from './nothing.js';

package/maybe/just.js

@@ -1,26 +1,21 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.jid = void 0;
 /**
  * @module Maybe
  */
 /**
  * Internal unique identifier for `Just`.
  */
-exports.jid = Symbol.for('@@functional/just');
+export const jid = Symbol.for('@@functional/just');
 /**
  * Constructor function for `Just`.
  * Creates the special object with one property, represented as unique symbol
  * key, holding the provided value.
  */
-function just(value) {
-    var _a;
-    return _a = {},
-        _a[exports.jid] = value,
+export default function just(value) {
+    return {
+        [jid]: value,
         // @ts-expect-error: Undocumented API for external use
-        _a.toString = function () {
-            return "Just ".concat(value);
-        },
-        _a;
+        toString() {
+            return `Just ${value}`;
+        }
+    };
 }
-exports.default = just;

package/maybe/maybe.d.ts

@@ -1,8 +1,8 @@
 /**
  * @module Maybe
  */
-import { Just } from './just';
-import { Nothing } from './nothing';
+import { Just } from './just.js';
+import { Nothing } from './nothing.js';
 /**
  * Type constructor for `Maybe`.
  * Can be either `Just` of a provided value type, or `Nothing`.

package/maybe/maybe.js

@@ -1,17 +1,14 @@
-"use strict";
 /**
  * @module Maybe
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-var just_1 = require("./just");
-var nothing_1 = require("./nothing");
+import just from './just.js';
+import nothing from './nothing.js';
 /**
  * Constructor function for `Maybe`.
  * Creates either `just` of a provided value, or `nothing`.
  */
-function maybe(value) {
+export default function maybe(value) {
     return value === null || value === undefined
-        ? (0, nothing_1.default)()
-        : (0, just_1.default)(value);
+        ? nothing()
+        : just(value);
 }
-exports.default = maybe;

package/maybe/nothing.js

@@ -1,26 +1,21 @@
-"use strict";
 /**
  * @module Maybe
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.nid = void 0;
 /**
  * Internal unique identifier for `Nothing`.
  */
-exports.nid = Symbol.for('@@functional/nothing');
+export const nid = Symbol.for('@@functional/nothing');
 /**
  * Constructor function for `Nothing`.
  * Creates the special object with one property, represented as unique symbol
  * key, holding the `null` value.
  */
-function nothing() {
-    var _a;
-    return _a = {},
-        _a[exports.nid] = undefined,
+export default function nothing() {
+    return {
+        [nid]: undefined,
         // @ts-expect-error: Undocumented API for external use
-        _a.toString = function () {
+        toString() {
             return 'Nothing';
-        },
-        _a;
+        }
+    };
 }
-exports.default = nothing;

package/maybe/operators/bind.d.ts

@@ -1,7 +1,7 @@
 /**
  * @module Maybe Operators
  */
-import type { Maybe } from '../maybe';
+import type { Maybe } from '../maybe.js';
 import type { Map } from '../../types/map';
 /**
  * Binds the value of the `monad` to new monad created

package/maybe/operators/bind.js

@@ -1,22 +1,15 @@
-"use strict";
 /**
  * @module Maybe Operators
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-var compose_1 = require("../../compose");
-var identity_1 = require("../../identity");
-var permutation_2_1 = require("../../permutation/permutation-2");
-var fold_1 = require("./fold");
-var guards_1 = require("./guards");
-function bind() {
-    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.isJust)(monad)
-            ? (0, compose_1.default)(map, fold_1.default, monad)
-            : (0, identity_1.default)(monad);
-    }).apply(void 0, args);
+import compose from '../../compose.js';
+import identity from '../../identity.js';
+import permutation2 from '../../permutation/permutation-2.js';
+import fold from './fold.js';
+import { isJust } from './guards.js';
+export default function bind(...args) {
+    return permutation2((monad, map) => {
+        return isJust(monad)
+            ? compose(map, fold, monad)
+            : identity(monad);
+    })(...args);
 }
-exports.default = bind;

package/maybe/operators/fmap.d.ts

@@ -1,7 +1,7 @@
 /**
  * @module Maybe Operators
  */
-import { Maybe } from '../maybe';
+import { Maybe } from '../maybe.js';
 import type { Map } from '../../types/map';
 /**
  * Maps the value of the provided `monad` through the `transition` function

package/maybe/operators/fmap.js

@@ -1,23 +1,16 @@
-"use strict";
 /**
  * @module Maybe Operators
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-var compose_1 = require("../../compose");
-var identity_1 = require("../../identity");
-var maybe_1 = require("../maybe");
-var permutation_2_1 = require("../../permutation/permutation-2");
-var fold_map_1 = require("./fold-map");
-var guards_1 = require("./guards");
-function fmap() {
-    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.isJust)(monad)
-            ? (0, compose_1.default)((maybe_1.default), (0, fold_map_1.default)(map), monad)
-            : (0, identity_1.default)(monad);
-    }).apply(void 0, args);
+import compose from '../../compose.js';
+import identity from '../../identity.js';
+import maybe from '../maybe.js';
+import permutation2 from '../../permutation/permutation-2.js';
+import foldMap from './fold-map.js';
+import { isJust } from './guards.js';
+export default function fmap(...args) {
+    return permutation2((monad, map) => {
+        return isJust(monad)
+            ? compose((maybe), foldMap(map), monad)
+            : identity(monad);
+    })(...args);
 }
-exports.default = fmap;

package/maybe/operators/fold-map.d.ts

@@ -1,9 +1,9 @@
 /**
  * @module Maybe Operators
  */
-import type { Just } from '../just';
-import type { Maybe } from '../maybe';
-import type { Nothing } from '../nothing';
+import type { Just } from '../just.js';
+import type { Maybe } from '../maybe.js';
+import type { Nothing } from '../nothing.js';
 import type { Map } from '../../types/map';
 /**
  * A type to unwrap the provided `Monad` into the new value type.

package/maybe/operators/fold-map.js

@@ -1,21 +1,14 @@
-"use strict";
 /**
  * @module Maybe Operators
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-var compose_1 = require("../../compose");
-var permutation_2_1 = require("../../permutation/permutation-2");
-var fold_1 = require("./fold");
-var guards_1 = require("./guards");
-function foldMap() {
-    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.isJust)(monad)
-            ? (0, compose_1.default)(map, fold_1.default, monad)
+import compose from '../../compose.js';
+import permutation2 from '../../permutation/permutation-2.js';
+import fold from './fold.js';
+import { isJust } from './guards.js';
+export default function foldMap(...args) {
+    return permutation2((monad, map) => {
+        return isJust(monad)
+            ? compose(map, fold, monad)
             : undefined;
-    }).apply(void 0, args);
+    })(...args);
 }
-exports.default = foldMap;

package/maybe/operators/fold.d.ts

@@ -1,9 +1,9 @@
 /**
  * @module Maybe Operators
  */
-import { Just } from '../just';
-import type { Maybe } from '../maybe';
-import { Nothing } from '../nothing';
+import { Just } from '../just.js';
+import type { Maybe } from '../maybe.js';
+import { Nothing } from '../nothing.js';
 /**
  * A type to unwrap the value type of the provided `Monad`.
  */

package/maybe/operators/fold.js

@@ -1,17 +1,14 @@
-"use strict";
 /**
  * @module Maybe Operators
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-var just_1 = require("../just");
-var nothing_1 = require("../nothing");
-var guards_1 = require("./guards");
+import { jid } from '../just.js';
+import { nid } from '../nothing.js';
+import { isJust } from './guards.js';
 /**
  * Returns the value of the provided `monad`.
  */
-function fold(monad) {
-    return (0, guards_1.isJust)(monad)
-        ? monad[just_1.jid]
-        : monad[nothing_1.nid];
+export default function fold(monad) {
+    return isJust(monad)
+        ? monad[jid]
+        : monad[nid];
 }
-exports.default = fold;

package/maybe/operators/guards.d.ts

@@ -1,9 +1,9 @@
 /**
  * @module Maybe Operators
  */
-import { Just } from '../just';
-import type { Maybe } from '../maybe';
-import { Nothing } from '../nothing';
+import { Just } from '../just.js';
+import type { Maybe } from '../maybe.js';
+import { Nothing } from '../nothing.js';
 /**
  * Type guard function to tell if the provided `value` is `Just`.
  */

package/maybe/operators/guards.js

@@ -1,29 +1,23 @@
-"use strict";
 /**
  * @module Maybe Operators
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isMaybe = exports.isNothing = exports.isJust = void 0;
-var just_1 = require("../just");
-var nothing_1 = require("../nothing");
+import { jid } from '../just.js';
+import { nid } from '../nothing.js';
 /**
  * Type guard function to tell if the provided `value` is `Just`.
  */
-function isJust(value) {
-    return Object.prototype.hasOwnProperty.call(value, just_1.jid);
+export function isJust(value) {
+    return Object.prototype.hasOwnProperty.call(value, jid);
 }
-exports.isJust = isJust;
 /**
  * Type guard function to tell if the provided `value` is `Nothing`.
  */
-function isNothing(value) {
-    return Object.prototype.hasOwnProperty.call(value, nothing_1.nid);
+export function isNothing(value) {
+    return Object.prototype.hasOwnProperty.call(value, nid);
 }
-exports.isNothing = isNothing;
 /**
  * Type guard function to tell if the provided `value` is `Maybe`.
  */
-function isMaybe(value) {
+export function isMaybe(value) {
     return isJust(value) || isNothing(value);
 }
-exports.isMaybe = isMaybe;

package/maybe/operators/index.d.ts

@@ -1,5 +1,5 @@
-export * from './guards';
-export { default as fmap } from './fmap';
-export { default as bind } from './bind';
-export { default as fold } from './fold';
-export { default as foldMap, FoldMap } from './fold-map';
+export * from './guards.js';
+export { default as fmap } from './fmap.js';
+export { default as bind } from './bind.js';
+export { default as fold } from './fold.js';
+export { default as foldMap, FoldMap } from './fold-map.js';

package/maybe/operators/index.js

@@ -1,26 +1,5 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = 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];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.foldMap = exports.fold = exports.bind = exports.fmap = void 0;
-__exportStar(require("./guards"), exports);
-var fmap_1 = require("./fmap");
-Object.defineProperty(exports, "fmap", { enumerable: true, get: function () { return fmap_1.default; } });
-var bind_1 = require("./bind");
-Object.defineProperty(exports, "bind", { enumerable: true, get: function () { return bind_1.default; } });
-var fold_1 = require("./fold");
-Object.defineProperty(exports, "fold", { enumerable: true, get: function () { return fold_1.default; } });
-var fold_map_1 = require("./fold-map");
-Object.defineProperty(exports, "foldMap", { enumerable: true, get: function () { return fold_map_1.default; } });
+export * from './guards.js';
+export { default as fmap } from './fmap.js';
+export { default as bind } from './bind.js';
+export { default as fold } from './fold.js';
+export { default as foldMap } from './fold-map.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fnts",
-  "version": "2.1.1",
+  "version": "3.0.0",
   "license": "MIT",
   "author": "Dmytro Vasylkivskyi",
   "description": "TypeScript / JavaScript FP utilities",
@@ -14,13 +14,20 @@
   ],
   "homepage": "https://drizzer14.github.io/fnts",
   "repository": "https://github.com/drizzer14/fnts",
+  "type": "module",
+  "module": "index.js",
+  "types": "index.d.ts",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20.13.1",
+    "npm": ">=10.5.2"
+  },
   "peerDependencies": {
-    "typescript": ">=4.7"
+    "typescript": ">=5.0"
   },
   "peerDependenciesMeta": {
     "typescript": {
       "optional": true
     }
-  },
-  "main": "index.js"
+  }
 }

package/permutation/index.d.ts

@@ -1,2 +1,2 @@
-export { default as permutation2 } from './permutation-2';
-export { default as permutation3 } from './permutation-3';
+export { default as permutation2 } from './permutation-2.js';
+export { default as permutation3 } from './permutation-3.js';

package/permutation/index.js

@@ -1,7 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.permutation3 = exports.permutation2 = void 0;
-var permutation_2_1 = require("./permutation-2");
-Object.defineProperty(exports, "permutation2", { enumerable: true, get: function () { return permutation_2_1.default; } });
-var permutation_3_1 = require("./permutation-3");
-Object.defineProperty(exports, "permutation3", { enumerable: true, get: function () { return permutation_3_1.default; } });
+export { default as permutation2 } from './permutation-2.js';
+export { default as permutation3 } from './permutation-3.js';

package/permutation/permutation-2.js

@@ -1,18 +1,11 @@
-"use strict";
 /**
  * @module Permutation
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-function permutation2(fn, shouldCurry) {
-    return function () {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        var a1 = args[0], b = args[1];
-        return (shouldCurry === null || shouldCurry === void 0 ? void 0 : shouldCurry(a1, b)) || args.length < fn.length
-            ? function (a2) { return fn(a2, a1); }
+export default function permutation2(fn, shouldCurry) {
+    return (...args) => {
+        const [a1, b] = args;
+        return shouldCurry?.(a1, b) || args.length < fn.length
+            ? (a2) => fn(a2, a1)
             : fn(a1, b);
     };
 }
-exports.default = permutation2;

package/permutation/permutation-3.d.ts

@@ -2,7 +2,7 @@
  * @module Permutation
  */
 import type { VariadicFunction } from './../types/function';
-import type { FirstParameter, SecondParameter } from './permutation-2';
+import type { FirstParameter, SecondParameter } from './permutation-2.js';
 export type TernaryFunction = (a: any, b: any, c: any) => any;
 export type ThirdParameter<Function extends VariadicFunction> = Parameters<Function>[2];
 export default function permutation3<Function extends TernaryFunction>(fn: Function, shouldCurry?: (a: FirstParameter<Function> | SecondParameter<Function>, b: SecondParameter<Function> | ThirdParameter<Function>, c: ThirdParameter<Function> | undefined) => boolean): VariadicFunction;

package/permutation/permutation-3.js

@@ -1,18 +1,11 @@
-"use strict";
 /**
  * @module Permutation
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-function permutation3(fn, shouldCurry) {
-    return function () {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        var a1 = args[0], b = args[1], c = args[2];
-        return (shouldCurry === null || shouldCurry === void 0 ? void 0 : shouldCurry(a1, b, c)) || args.length < fn.length
-            ? function (a2) { return fn(a2, a1, b); }
+export default function permutation3(fn, shouldCurry) {
+    return (...args) => {
+        const [a1, b, c] = args;
+        return shouldCurry?.(a1, b, c) || args.length < fn.length
+            ? (a2) => fn(a2, a1, b)
             : fn(a1, b, c);
     };
 }
-exports.default = permutation3;

package/pipe.js

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

package/rethrow.js

@@ -1,16 +1,13 @@
-"use strict";
 /**
  * @module Side Effects
  */
-Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * Rethrows a received error
  * performing an optional side effect.
  */
-function rethrow(effect) {
-    return function (error) {
-        effect === null || effect === void 0 ? void 0 : effect(error);
+export default function rethrow(effect) {
+    return (error) => {
+        effect?.(error);
         throw error;
     };
 }
-exports.default = rethrow;

package/set.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @module Set
+ */
+import type { Unshift } from './types/unshift';
+import type { Flatten, Flattenable } from './types/flatten';
+/**
+ * Sets the `Value` type inside a nested object type `Source` by provided `Path`
+ * written in dot-notation.
+ */
+export type Set<Source extends Flattenable, Path extends string, Value> = Source extends Record<string, unknown> ? Path extends `${number}.${infer Right}` ? Set<Source, Right, Value> : Path extends `${infer Left extends keyof Source}.${infer Right}` ? {
+    [Key in keyof Source]: Key extends Exclude<keyof Source, Left> ? Source[Key] : Set<Exclude<Source[Left], undefined>, Right, Value>;
+} : Path extends keyof Source ? {
+    [Key in keyof Source]: Key extends Exclude<keyof Source, Path> ? Source[Key] : Value;
+} : never : Source extends any[] ? Path extends `${infer Index extends number}.${infer Right}` ? Unshift<Source, Index, Set<Exclude<Source[Index], undefined>, Right, Value>> : Path extends `${infer Index extends number}` ? Unshift<Source, Index, Value> : never : never;
+/**
+ * Sets the `value` inside a nested `source` object by provided `path`
+ * written in dot-notation.
+ */
+export default function set<Source extends Flattenable, Path extends Flatten<Source>, Value>(path: Path, value: Value): (source: Source) => Set<Source, Path, Value>;
+/**
+ * Sets the `value` inside a nested `source` object by provided `path`
+ * written in dot-notation.
+ */
+export default function set<Source extends Flattenable, Path extends Flatten<Source>, Value>(source: Source, path: Path, value: Value): Set<Source, Path, Value>;

package/set.js

@@ -0,0 +1,35 @@
+/**
+ * @module Set
+ */
+import permutation3 from './permutation/permutation-3.js';
+/**
+ * Sets the `value` inside a nested `source` object by provided `path`
+ * written in dot-notation.
+ */
+export default function set(...args) {
+    // @ts-ignore
+    return permutation3(
+    // @ts-ignore
+    (source, path, value
+    // @ts-ignore
+    ) => {
+        // @ts-ignore
+        const keys = path.split('.');
+        const length = keys.length;
+        let result = structuredClone(source);
+        if (length === 0) {
+            result[path] = value;
+        }
+        let scope = result[keys[0]];
+        for (let index = 1; index < length; index += 1) {
+            if (index === length - 1) {
+                scope[keys?.[index]] = value;
+            }
+            else {
+                scope = scope?.[keys?.[index]];
+            }
+        }
+        // @ts-ignore
+        return result;
+    })(...args);
+}

package/tap.d.ts

@@ -2,7 +2,7 @@
  * @module Side Effects
  */
 import type { Map } from './types/map';
-import type { Identity } from './identity';
+import type { Identity } from './identity.js';
 import type { Effect } from './types/effect';
 /**
  * Performs a side effect