fnts 2.2.0 → 3.0.0

package/either/operators/bimap/first.js

@@ -1,23 +1,16 @@
-"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 left_1 = require("../../left");
-var identity_1 = require("../../../identity");
-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 (0, permutation_2_1.default)(function (monad, mapLeft) {
-        return (0, guards_1.isLeft)(monad)
-            ? (0, compose_1.default)((0, compose_1.default)(left_1.default, mapLeft), bifoldl_1.default, monad)
-            : (0, identity_1.default)(monad);
-    }).apply(void 0, args);
+import { isLeft } from '../guards.js';
+import compose from '../../../compose.js';
+import bifoldl from '../bifold/bifoldl.js';
+import left from '../../left.js';
+import identity from '../../../identity.js';
+import permutation2 from '../../../permutation/permutation-2.js';
+export default function first(...args) {
+    return permutation2((monad, mapLeft) => {
+        return isLeft(monad)
+            ? compose(compose(left, mapLeft), bifoldl, monad)
+            : identity(monad);
+    })(...args);
 }
-exports.default = first;

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

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

package/either/operators/bimap/index.js

@@ -1,9 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.second = exports.first = exports.default = void 0;
-var bimap_1 = require("./bimap");
-Object.defineProperty(exports, "default", { enumerable: true, get: function () { return bimap_1.default; } });
-var first_1 = require("./first");
-Object.defineProperty(exports, "first", { enumerable: true, get: function () { return first_1.default; } });
-var second_1 = require("./second");
-Object.defineProperty(exports, "second", { enumerable: true, get: function () { return second_1.default; } });
+export { default } from './bimap.js';
+export { default as first } from './first.js';
+export { default as second } from './second.js';

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

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

package/either/operators/bimap/second.js

@@ -1,23 +1,16 @@
-"use strict";
 /**
  * @module Either Operators
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-var bifold_1 = require("../bifold");
-var guards_1 = require("../guards");
-var compose_1 = require("../../../compose");
-var identity_1 = require("../../../identity");
-var right_1 = require("../../right");
-var permutation_2_1 = require("../../../permutation/permutation-2");
-function second() {
-    var args = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        args[_i] = arguments[_i];
-    }
-    return (0, permutation_2_1.default)(function (monad, mapRight) {
-        return (0, guards_1.isRight)(monad)
-            ? (0, compose_1.default)((0, compose_1.default)(right_1.default, mapRight), bifold_1.bifoldr, monad)
-            : (0, identity_1.default)(monad);
-    }).apply(void 0, args);
+import { bifoldr } from '../bifold/index.js';
+import { isRight } from '../guards.js';
+import compose from '../../../compose.js';
+import identity from '../../../identity.js';
+import right from '../../right.js';
+import permutation2 from '../../../permutation/permutation-2.js';
+export default function second(...args) {
+    return permutation2((monad, mapRight) => {
+        return isRight(monad)
+            ? compose(compose(right, mapRight), bifoldr, monad)
+            : identity(monad);
+    })(...args);
 }
-exports.default = second;

package/either/operators/bindr.d.ts

@@ -2,7 +2,7 @@
  * @module Either Operators
  */
 import type { Map } from '../../types';
-import type { Either } from '../either';
+import type { Either } from '../either.js';
 /**
  * Maps right value to a new monad returning it.
  */

package/either/operators/bindr.js

@@ -1,22 +1,15 @@
-"use strict";
 /**
  * @module Either 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 bifold_1 = require("./bifold");
-var guards_1 = require("./guards");
-function bindr() {
-    var args = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        args[_i] = arguments[_i];
-    }
-    return (0, permutation_2_1.default)(function (monad, mapRight) {
-        return (0, guards_1.isRight)(monad)
-            ? (0, compose_1.default)(mapRight, bifold_1.bifoldr, 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 { bifoldr } from './bifold/index.js';
+import { isRight } from './guards.js';
+export default function bindr(...args) {
+    return permutation2((monad, mapRight) => {
+        return isRight(monad)
+            ? compose(mapRight, bifoldr, monad)
+            : identity(monad);
+    })(...args);
 }
-exports.default = bindr;

package/either/operators/guards.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';
 /**
  * Type guard function to tell if the provided `value` is `Left`.
  */

package/either/operators/guards.js

@@ -1,29 +1,23 @@
-"use strict";
 /**
  * @module Either Operators
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isEither = exports.isRight = exports.isLeft = void 0;
-var left_1 = require("../left");
-var right_1 = require("../right");
+import { lid } from '../left.js';
+import { rid } from '../right.js';
 /**
  * Type guard function to tell if the provided `value` is `Left`.
  */
-function isLeft(value) {
-    return Object.prototype.hasOwnProperty.call(value, left_1.lid);
+export function isLeft(value) {
+    return Object.prototype.hasOwnProperty.call(value, lid);
 }
-exports.isLeft = isLeft;
 /**
  * Type guard function to tell if the provided `value` is `Right`.
  */
-function isRight(value) {
-    return Object.prototype.hasOwnProperty.call(value, right_1.rid);
+export function isRight(value) {
+    return Object.prototype.hasOwnProperty.call(value, rid);
 }
-exports.isRight = isRight;
 /**
  * Type guard function to tell if the provided `value` is `Either`.
  */
-function isEither(value) {
+export function isEither(value) {
     return isLeft(value) || isRight(value);
 }
-exports.isEither = isEither;

package/either/operators/index.d.ts

@@ -1,5 +1,5 @@
-export { bifoldl, Bifoldl, bifoldr, Bifoldr, default as bifold, Bifold, } from './bifold';
-export * from './guards';
-export { default as bindr } from './bindr';
-export { default as bifoldMap } from './bifold-map';
-export { default as bimap, first, second } from './bimap';
+export { bifoldl, Bifoldl, bifoldr, Bifoldr, default as bifold, Bifold, } from './bifold/index.js';
+export * from './guards.js';
+export { default as bindr } from './bindr.js';
+export { default as bifoldMap } from './bifold-map/index.js';
+export { default as bimap, first, second } from './bimap/index.js';

package/either/operators/index.js

@@ -1,30 +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.second = exports.first = exports.bimap = exports.bifoldMap = exports.bindr = exports.bifold = exports.bifoldr = exports.bifoldl = void 0;
-var bifold_1 = require("./bifold");
-Object.defineProperty(exports, "bifoldl", { enumerable: true, get: function () { return bifold_1.bifoldl; } });
-Object.defineProperty(exports, "bifoldr", { enumerable: true, get: function () { return bifold_1.bifoldr; } });
-Object.defineProperty(exports, "bifold", { enumerable: true, get: function () { return bifold_1.default; } });
-__exportStar(require("./guards"), exports);
-var bindr_1 = require("./bindr");
-Object.defineProperty(exports, "bindr", { enumerable: true, get: function () { return bindr_1.default; } });
-var bifold_map_1 = require("./bifold-map");
-Object.defineProperty(exports, "bifoldMap", { enumerable: true, get: function () { return bifold_map_1.default; } });
-var bimap_1 = require("./bimap");
-Object.defineProperty(exports, "bimap", { enumerable: true, get: function () { return bimap_1.default; } });
-Object.defineProperty(exports, "first", { enumerable: true, get: function () { return bimap_1.first; } });
-Object.defineProperty(exports, "second", { enumerable: true, get: function () { return bimap_1.second; } });
+export { bifoldl, bifoldr, default as bifold, } from './bifold/index.js';
+export * from './guards.js';
+export { default as bindr } from './bindr.js';
+export { default as bifoldMap } from './bifold-map/index.js';
+export { default as bimap, first, second } from './bimap/index.js';

package/either/right.js

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

package/guard.d.ts

@@ -2,8 +2,8 @@
  * @module Guard
  */
 import type { VariadicFunction } from './types/function';
-export type GuardQualifier<Function extends VariadicFunction> = [
-    validator: <Result extends boolean>(...args: Parameters<Function>) => Result,
+export type GuardQualifier<Function extends VariadicFunction, Validator extends (...args: Parameters<Function>) => boolean> = [
+    validator: Validator,
     executor: Function
 ];
 /**
@@ -16,4 +16,4 @@ export type GuardQualifier<Function extends VariadicFunction> = [
  *
  * When no `validator` succeeds, the default executor is run.
  */
-export default function guard<Function extends VariadicFunction>(...qualifiers: [...GuardQualifier<Function>[], Function]): Function;
+export default function guard<Function extends VariadicFunction, Validators extends Array<(...args: Parameters<Function>) => boolean>>(...qualifiers: [...GuardQualifier<Function, Validators[number]>[], Function]): Function;

package/guard.js

@@ -1,8 +1,6 @@
-"use strict";
 /**
  * @module Guard
  */
-Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * A function which accepts the pairs of guards:
  * the first one is the `validator`, expected to return a boolean value.
@@ -13,24 +11,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
  *
  * When no `validator` succeeds, the default executor is run.
  */
-function guard() {
-    var qualifiers = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        qualifiers[_i] = arguments[_i];
-    }
-    return (function () {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        var length = qualifiers.length - 1;
-        for (var index = 0; index < length; index += 1) {
-            var _a = qualifiers[index], validator = _a[0], expression = _a[1];
-            if (validator.apply(void 0, args)) {
-                return expression.apply(void 0, args);
+export default function guard(...qualifiers) {
+    return ((...args) => {
+        const length = qualifiers.length - 1;
+        for (let index = 0; index < length; index += 1) {
+            const [validator, expression] = qualifiers[index];
+            if (validator(...args)) {
+                return expression(...args);
             }
         }
-        return qualifiers[length].apply(qualifiers, args);
+        return qualifiers[length](...args);
     });
 }
-exports.default = guard;

package/identity.js

@@ -1,12 +1,9 @@
-"use strict";
 /**
  * @module Identity
  */
-Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * A function which returns the provided value.
  */
-function identity(x) {
+export default function identity(x) {
     return x;
 }
-exports.default = identity;

package/index.d.ts

@@ -1,11 +1,9 @@
-export { default as get } from './get';
-export { default as set } from './set';
-export { default as tap } from './tap';
-export { default as pipe } from './pipe';
-export { default as apply } from './apply';
-export { default as curry } from './curry';
-export { default as guard } from './guard';
-export { default as inject } from './inject';
-export { default as compose } from './compose';
-export { default as rethrow } from './rethrow';
-export { default as identity } from './identity';
+export { default as tap } from './tap.js';
+export { default as pipe } from './pipe.js';
+export { default as apply } from './apply.js';
+export { default as curry } from './curry.js';
+export { default as guard } from './guard.js';
+export { default as inject } from './inject.js';
+export { default as compose } from './compose.js';
+export { default as rethrow } from './rethrow.js';
+export { default as identity } from './identity.js';

package/index.js

@@ -1,25 +1,9 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.identity = exports.rethrow = exports.compose = exports.inject = exports.guard = exports.curry = exports.apply = exports.pipe = exports.tap = exports.set = exports.get = void 0;
-var get_1 = require("./get");
-Object.defineProperty(exports, "get", { enumerable: true, get: function () { return get_1.default; } });
-var set_1 = require("./set");
-Object.defineProperty(exports, "set", { enumerable: true, get: function () { return set_1.default; } });
-var tap_1 = require("./tap");
-Object.defineProperty(exports, "tap", { enumerable: true, get: function () { return tap_1.default; } });
-var pipe_1 = require("./pipe");
-Object.defineProperty(exports, "pipe", { enumerable: true, get: function () { return pipe_1.default; } });
-var apply_1 = require("./apply");
-Object.defineProperty(exports, "apply", { enumerable: true, get: function () { return apply_1.default; } });
-var curry_1 = require("./curry");
-Object.defineProperty(exports, "curry", { enumerable: true, get: function () { return curry_1.default; } });
-var guard_1 = require("./guard");
-Object.defineProperty(exports, "guard", { enumerable: true, get: function () { return guard_1.default; } });
-var inject_1 = require("./inject");
-Object.defineProperty(exports, "inject", { enumerable: true, get: function () { return inject_1.default; } });
-var compose_1 = require("./compose");
-Object.defineProperty(exports, "compose", { enumerable: true, get: function () { return compose_1.default; } });
-var rethrow_1 = require("./rethrow");
-Object.defineProperty(exports, "rethrow", { enumerable: true, get: function () { return rethrow_1.default; } });
-var identity_1 = require("./identity");
-Object.defineProperty(exports, "identity", { enumerable: true, get: function () { return identity_1.default; } });
+export { default as tap } from './tap.js';
+export { default as pipe } from './pipe.js';
+export { default as apply } from './apply.js';
+export { default as curry } from './curry.js';
+export { default as guard } from './guard.js';
+export { default as inject } from './inject.js';
+export { default as compose } from './compose.js';
+export { default as rethrow } from './rethrow.js';
+export { default as identity } from './identity.js';

package/inject.js

@@ -1,23 +1,12 @@
-"use strict";
 /**
  * @module Side Effects
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-var permutation_2_1 = require("./permutation/permutation-2");
-function inject() {
-    var args = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        args[_i] = arguments[_i];
-    }
-    return (0, permutation_2_1.default)(function (fn, effect) {
-        return (function () {
-            var args = [];
-            for (var _i = 0; _i < arguments.length; _i++) {
-                args[_i] = arguments[_i];
-            }
-            effect.apply(void 0, args);
-            return fn.apply(void 0, args);
+import permutation2 from './permutation/permutation-2.js';
+export default function inject(...args) {
+    return permutation2((fn, effect) => {
+        return ((...args) => {
+            effect(...args);
+            return fn(...args);
         });
-    }).apply(void 0, args);
+    })(...args);
 }
-exports.default = inject;

package/{get.d.ts → lens/get.d.ts}

@@ -1,12 +1,17 @@
 /**
- * @module Get
+ * @module Lens
  */
-import type { Flatten, Flattenable } from './types/flatten';
+import type { Flatten, Flattenable } from '../types/flatten';
 /**
  * Gets the value type inside a nested object type `Source` by provided `Path`
  * written in dot-notation.
  */
-export type Get<Source extends Flattenable, Path extends string> = Source extends Record<string, unknown> ? Path extends `${number}.${infer Right}` ? Get<Source, Right> : Path extends `${infer Left extends keyof Source}.${infer Right}` ? Get<Exclude<Source[Left], undefined>, Right> | Extract<Source[Left], undefined> : Path extends keyof Source ? Source[Path] : never : Source extends any[] ? Path extends `${infer Left extends number}.${infer Right}` ? Get<Exclude<Source[Left], undefined>, Right> | Extract<Source[Left], undefined> : Path extends `${infer Index extends number}` ? Source[Index] : never : never;
+export type Get<Source extends Flattenable, Path extends string> = Source extends Record<string, unknown> ? Path extends `${number}.${infer Right}` ? Get<Source, Right> : Path extends `${infer Left extends keyof Source}.${infer Right}` ? Get<Exclude<Source[Left], undefined>, Right> | Extract<Source[Left], undefined> : Path extends keyof Source ? Source[Path] : never : Source extends any[] ? Path extends `${infer Index extends number}.${infer Right}` ? Get<Exclude<Source[Index], undefined>, Right> | Extract<Source[Index], undefined> : Path extends `${infer Index extends number}` ? Source[Index] : never : never;
+/**
+ * Gets the value inside a nested `source` object by provided `path`
+ * written in dot-notation.
+ */
+export default function get<Source extends Flattenable>(source: Source): <Path extends Flatten<Source>>(path: Path) => Get<Source, Path>;
 /**
  * Gets the value inside a nested `source` object by provided `path`
  * written in dot-notation.

package/lens/get.js

@@ -0,0 +1,29 @@
+/**
+ * @module Lens
+ */
+import permutation2 from '../permutation/permutation-2.js';
+/**
+ * Gets the value inside a nested `source` object by provided `path`
+ * written in dot-notation.
+ */
+export default function get(...args) {
+    // @ts-ignore
+    return permutation2((sourceOrPath, pathOrSource) => {
+        let source, path;
+        if (typeof sourceOrPath === 'string') {
+            source = pathOrSource;
+            path = sourceOrPath;
+        }
+        else {
+            source = sourceOrPath;
+            path = pathOrSource;
+        }
+        const keys = path.split('.');
+        const length = keys.length;
+        let result = source;
+        for (let index = 0; index < length; index += 1) {
+            result = result?.[keys?.[index]];
+        }
+        return result;
+    })(...args);
+}

package/lens/index.d.ts

@@ -0,0 +1,3 @@
+export { default } from './lens.js';
+export { default as set } from './set.js';
+export { default as get } from './get.js';

package/lens/index.js

@@ -0,0 +1,3 @@
+export { default } from './lens.js';
+export { default as set } from './set.js';
+export { default as get } from './get.js';

package/lens/lens.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @module Lens
+ */
+import type { Flatten, Flattenable } from '../types';
+import { Get } from './get.js';
+import { Set } from './set.js';
+/**
+ * Creates a wrapper for a given `Source` type that provides access to both `get` and `set` functionalities for it,
+ * effectively creating a functional lens.
+ */
+export interface Lens<Source extends Flattenable> {
+    <Path extends Flatten<Source>>(path: Path): Get<Source, Path>;
+    <Path extends Flatten<Source>, Value extends Get<Source, Path>>(path: Path, value: Value): Set<Source, Path, Value>;
+}
+/**
+ * Creates a wrapper for a given `source` that provides access to both `get` and `set` functionalities for it,
+ * effectively creating a functional lens.
+ */
+export default function lens<Source extends Flattenable>(source: Source): Lens<Source>;

package/lens/lens.js

@@ -0,0 +1,17 @@
+/**
+ * @module Lens
+ */
+import get from './get.js';
+import set from './set.js';
+/**
+ * Creates a wrapper for a given `source` that provides access to both `get` and `set` functionalities for it,
+ * effectively creating a functional lens.
+ */
+export default function lens(source) {
+    const getter = get(source);
+    const setter = set(source);
+    // @ts-ignore
+    return (...args) => {
+        return args.length === 1 ? getter(args[0]) : setter(args[0], args[1]);
+    };
+}

package/lens/set.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @module Lens
+ */
+import type { Unshift } from '../types/unshift';
+import type { Flatten, Flattenable } from '../types/flatten';
+import type { Get } from './get.js';
+/**
+ * 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>(source: Source): <Path extends Flatten<Source>, Value extends Get<Source, Path>>(path: Path, value: Value) => 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 extends Get<Source, Path>>(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 extends Get<Source, Path>>(source: Source, path: Path, value: Value): Set<Source, Path, Value>;

package/lens/set.js

@@ -0,0 +1,44 @@
+/**
+ * @module Lens
+ */
+/**
+ * Sets the `value` inside a nested `source` object by provided `path`
+ * written in dot-notation.
+ */
+export default function set(...args) {
+    switch (args.length) {
+        case 1: {
+            // @ts-ignore
+            return (path, value) => _set(args[0], path, value);
+        }
+        case 2: {
+            // @ts-ignore
+            return (source) => _set(source, args[1], args[2]);
+        }
+        case 3: {
+            return _set;
+        }
+    }
+}
+function _set(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;
+}