effect 2.0.0-next.42 → 2.0.0-next.43

package/Option/dist/effect-Option.cjs.dev.js

@@ -2,82 +2,1140 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-require('../../dist/Equal-281b6ca8.cjs.dev.js');
-require('../../dist/Equivalence-de7a0d51.cjs.dev.js');
-require('../../dist/Function-41ce433d.cjs.dev.js');
-require('../../dist/Either-9c349424.cjs.dev.js');
-require('../../dist/Number-588f6483.cjs.dev.js');
-require('../../dist/Order-28bdebd2.cjs.dev.js');
-require('../../dist/Utils-b0c14d1b.cjs.dev.js');
-var Option_dist_effectOption = require('../../dist/Option-03997d77.cjs.dev.js');
-require('../../dist/Hash-bd154268.cjs.dev.js');
-require('../../dist/GlobalValue-81ab6908.cjs.dev.js');
-require('../../dist/Inspectable-ac929af4.cjs.dev.js');
-require('../../dist/Effectable-a6403e5f.cjs.dev.js');
-require('../../dist/Data-85559fb3.cjs.dev.js');
-require('../../dist/Pipeable-4698db72.cjs.dev.js');
-require('../../dist/Predicate-9e859c9c.cjs.dev.js');
-
-
-
-exports.Do = Option_dist_effectOption.Do;
-exports.TypeId = Option_dist_effectOption.TypeId;
-exports.all = Option_dist_effectOption.all;
-exports.ap = Option_dist_effectOption.ap;
-exports.as = Option_dist_effectOption.as;
-exports.asUnit = Option_dist_effectOption.asUnit;
-exports.bind = Option_dist_effectOption.bind;
-exports.bindTo = Option_dist_effectOption.bindTo;
-exports.composeK = Option_dist_effectOption.composeK;
-exports.contains = Option_dist_effectOption.contains;
-exports.containsWith = Option_dist_effectOption.containsWith;
-exports.divide = Option_dist_effectOption.divide;
-exports.exists = Option_dist_effectOption.exists;
-exports.filter = Option_dist_effectOption.filter;
-exports.filterMap = Option_dist_effectOption.filterMap;
-exports.firstSomeOf = Option_dist_effectOption.firstSomeOf;
-exports.flatMap = Option_dist_effectOption.flatMap;
-exports.flatMapNullable = Option_dist_effectOption.flatMapNullable;
-exports.flatten = Option_dist_effectOption.flatten;
-exports.fromIterable = Option_dist_effectOption.fromIterable;
-exports.fromNullable = Option_dist_effectOption.fromNullable;
-exports.gen = Option_dist_effectOption.gen;
-exports.getEquivalence = Option_dist_effectOption.getEquivalence;
-exports.getLeft = Option_dist_effectOption.getLeft;
-exports.getOrElse = Option_dist_effectOption.getOrElse;
-exports.getOrNull = Option_dist_effectOption.getOrNull;
-exports.getOrThrow = Option_dist_effectOption.getOrThrow;
-exports.getOrThrowWith = Option_dist_effectOption.getOrThrowWith;
-exports.getOrUndefined = Option_dist_effectOption.getOrUndefined;
-exports.getOrder = Option_dist_effectOption.getOrder;
-exports.getRight = Option_dist_effectOption.getRight;
-exports.isNone = Option_dist_effectOption.isNone;
-exports.isOption = Option_dist_effectOption.isOption;
-exports.isSome = Option_dist_effectOption.isSome;
-exports["let"] = Option_dist_effectOption.let_;
-exports.lift2 = Option_dist_effectOption.lift2;
-exports.liftNullable = Option_dist_effectOption.liftNullable;
-exports.liftPredicate = Option_dist_effectOption.liftPredicate;
-exports.liftThrowable = Option_dist_effectOption.liftThrowable;
-exports.map = Option_dist_effectOption.map;
-exports.match = Option_dist_effectOption.match;
-exports.multiply = Option_dist_effectOption.multiply;
-exports.multiplyCompact = Option_dist_effectOption.multiplyCompact;
-exports.none = Option_dist_effectOption.none;
-exports.orElse = Option_dist_effectOption.orElse;
-exports.orElseEither = Option_dist_effectOption.orElseEither;
-exports.partitionMap = Option_dist_effectOption.partitionMap;
-exports.product = Option_dist_effectOption.product;
-exports.productMany = Option_dist_effectOption.productMany;
-exports.reduceCompact = Option_dist_effectOption.reduceCompact;
-exports.some = Option_dist_effectOption.some;
-exports.subtract = Option_dist_effectOption.subtract;
-exports.sum = Option_dist_effectOption.sum;
-exports.sumCompact = Option_dist_effectOption.sumCompact;
-exports.tap = Option_dist_effectOption.tap;
-exports.toArray = Option_dist_effectOption.toArray;
-exports.toRefinement = Option_dist_effectOption.toRefinement;
-exports.unit = Option_dist_effectOption.unit;
-exports.zipLeft = Option_dist_effectOption.zipLeft;
-exports.zipRight = Option_dist_effectOption.zipRight;
-exports.zipWith = Option_dist_effectOption.zipWith;
+var Equal_dist_effectEqual = require('../../Equal/dist/effect-Equal.cjs.dev.js');
+var Equivalence_dist_effectEquivalence = require('../../Equivalence/dist/effect-Equivalence.cjs.dev.js');
+var Function_dist_effectFunction = require('../../Function/dist/effect-Function.cjs.dev.js');
+var Either = require('../../dist/Either-12bbe00c.cjs.dev.js');
+var Number_dist_effectNumber = require('../../Number/dist/effect-Number.cjs.dev.js');
+var Order_dist_effectOrder = require('../../Order/dist/effect-Order.cjs.dev.js');
+var Utils_dist_effectUtils = require('../../Utils/dist/effect-Utils.cjs.dev.js');
+require('../../Hash/dist/effect-Hash.cjs.dev.js');
+require('../../GlobalValue/dist/effect-GlobalValue.cjs.dev.js');
+require('../../Inspectable/dist/effect-Inspectable.cjs.dev.js');
+require('../../dist/Effectable-2f022879.cjs.dev.js');
+require('../../Data/dist/effect-Data.cjs.dev.js');
+require('../../Pipeable/dist/effect-Pipeable.cjs.dev.js');
+require('../../Predicate/dist/effect-Predicate.cjs.dev.js');
+
+/**
+ * @since 2.0.0
+ */
+
+/**
+ * @category models
+ * @since 2.0.0
+ */
+
+/**
+ * @category symbols
+ * @since 2.0.0
+ */
+const TypeId = /*#__PURE__*/Symbol.for("effect/Option");
+
+/**
+ * @category symbols
+ * @since 2.0.0
+ */
+
+/**
+ * @category models
+ * @since 2.0.0
+ */
+
+/**
+ * @category models
+ * @since 2.0.0
+ */
+
+/**
+ * @category models
+ * @since 2.0.0
+ */
+
+/**
+ * @category models
+ * @since 2.0.0
+ */
+
+/**
+ * @category type lambdas
+ * @since 2.0.0
+ */
+
+/**
+ * Creates a new `Option` that represents the absence of a value.
+ *
+ * @category constructors
+ * @since 2.0.0
+ */
+const none = () => Either.none;
+
+/**
+ * Creates a new `Option` that wraps the given value.
+ *
+ * @param value - The value to wrap.
+ *
+ * @category constructors
+ * @since 2.0.0
+ */
+const some = Either.some;
+
+/**
+ * Tests if a value is a `Option`.
+ *
+ * @param input - The value to check.
+ *
+ * @example
+ * import { some, none, isOption } from 'effect/Option'
+ *
+ * assert.deepStrictEqual(isOption(some(1)), true)
+ * assert.deepStrictEqual(isOption(none()), true)
+ * assert.deepStrictEqual(isOption({}), false)
+ *
+ * @category guards
+ * @since 2.0.0
+ */
+const isOption = Either.isOption;
+
+/**
+ * Determine if a `Option` is a `None`.
+ *
+ * @param self - The `Option` to check.
+ *
+ * @example
+ * import { some, none, isNone } from 'effect/Option'
+ *
+ * assert.deepStrictEqual(isNone(some(1)), false)
+ * assert.deepStrictEqual(isNone(none()), true)
+ *
+ * @category guards
+ * @since 2.0.0
+ */
+const isNone = Either.isNone;
+
+/**
+ * Determine if a `Option` is a `Some`.
+ *
+ * @param self - The `Option` to check.
+ *
+ * @example
+ * import { some, none, isSome } from 'effect/Option'
+ *
+ * assert.deepStrictEqual(isSome(some(1)), true)
+ * assert.deepStrictEqual(isSome(none()), false)
+ *
+ * @category guards
+ * @since 2.0.0
+ */
+const isSome = Either.isSome;
+
+/**
+ * Matches the given `Option` and returns either the provided `onNone` value or the result of the provided `onSome`
+ * function when passed the `Option`'s value.
+ *
+ * @param self - The `Option` to match
+ * @param onNone - The value to be returned if the `Option` is `None`
+ * @param onSome - The function to be called if the `Option` is `Some`, it will be passed the `Option`'s value and its result will be returned
+ *
+ * @example
+ * import { some, none, match } from 'effect/Option'
+ * import { pipe } from "effect/Function"
+ *
+ * assert.deepStrictEqual(
+ *   pipe(some(1), match({ onNone: () => 'a none', onSome: (a) => `a some containing ${a}` })),
+ *   'a some containing 1'
+ * )
+ *
+ * assert.deepStrictEqual(
+ *   pipe(none(), match({ onNone: () => 'a none', onSome: (a) => `a some containing ${a}` })),
+ *   'a none'
+ * )
+ *
+ * @category pattern matching
+ * @since 2.0.0
+ */
+const match = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, {
+  onNone,
+  onSome
+}) => isNone(self) ? onNone() : onSome(self.value));
+
+/**
+ * Returns a type guard from a `Option` returning function.
+ * This function ensures that a type guard definition is type-safe.
+ *
+ * @example
+ * import * as O from "effect/Option"
+ *
+ * const parsePositive = (n: number): O.Option<number> =>
+ *   n > 0 ? O.some(n) : O.none()
+ *
+ * const isPositive = O.toRefinement(parsePositive)
+ *
+ * assert.deepStrictEqual(isPositive(1), true)
+ * assert.deepStrictEqual(isPositive(-1), false)
+ *
+ * @category conversions
+ * @since 2.0.0
+ */
+const toRefinement = f => a => isSome(f(a));
+
+/**
+ * Converts an `Iterable` of values into an `Option`. Returns the first value of the `Iterable` wrapped in a `Some`
+ * if the `Iterable` is not empty, otherwise returns `None`.
+ *
+ * @param collection - The `Iterable` to be converted to an `Option`.
+ *
+ * @example
+ * import { fromIterable, some, none } from 'effect/Option'
+ *
+ * assert.deepStrictEqual(fromIterable([1, 2, 3]), some(1))
+ * assert.deepStrictEqual(fromIterable([]), none())
+ *
+ * @category conversions
+ * @since 2.0.0
+ */
+const fromIterable = collection => {
+  for (const a of collection) {
+    return some(a);
+  }
+  return none();
+};
+
+/**
+ * Converts a `Either` to an `Option` discarding the error.
+ *
+ * Alias of {@link fromEither}.
+ *
+ * @example
+ * import * as O from "effect/Option"
+ * import * as E from "effect/Either"
+ *
+ * assert.deepStrictEqual(O.getRight(E.right('ok')), O.some('ok'))
+ * assert.deepStrictEqual(O.getRight(E.left('err')), O.none())
+ *
+ * @category conversions
+ * @since 2.0.0
+ */
+const getRight = Either.getRight;
+
+/**
+ * Converts a `Either` to an `Option` discarding the value.
+ *
+ * @example
+ * import * as O from "effect/Option"
+ * import * as E from "effect/Either"
+ *
+ * assert.deepStrictEqual(O.getLeft(E.right("ok")), O.none())
+ * assert.deepStrictEqual(O.getLeft(E.left("a")), O.some("a"))
+ *
+ * @category conversions
+ * @since 2.0.0
+ */
+const getLeft = Either.getLeft;
+
+/**
+ * Returns the value of the `Option` if it is `Some`, otherwise returns `onNone`
+ *
+ * @param self - The `Option` to get the value of.
+ * @param onNone - Function that returns the default value to return if the `Option` is `None`.
+ *
+ * @example
+ * import { some, none, getOrElse } from 'effect/Option'
+ * import { pipe } from "effect/Function"
+ *
+ * assert.deepStrictEqual(pipe(some(1), getOrElse(() => 0)), 1)
+ * assert.deepStrictEqual(pipe(none(), getOrElse(() => 0)), 0)
+ *
+ * @category getters
+ * @since 2.0.0
+ */
+const getOrElse = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, onNone) => isNone(self) ? onNone() : self.value);
+
+/**
+ * Returns the provided `Option` `that` if `self` is `None`, otherwise returns `self`.
+ *
+ * @param self - The first `Option` to be checked.
+ * @param that - The `Option` to return if `self` is `None`.
+ *
+ * @example
+ * import * as O from "effect/Option"
+ * import { pipe } from "effect/Function"
+ *
+ * assert.deepStrictEqual(
+ *   pipe(
+ *     O.none(),
+ *     O.orElse(() => O.none())
+ *   ),
+ *   O.none()
+ * )
+ * assert.deepStrictEqual(
+ *   pipe(
+ *     O.some('a'),
+ *     O.orElse(() => O.none())
+ *   ),
+ *   O.some('a')
+ * )
+ * assert.deepStrictEqual(
+ *   pipe(
+ *     O.none(),
+ *     O.orElse(() => O.some('b'))
+ *   ),
+ *   O.some('b')
+ * )
+ * assert.deepStrictEqual(
+ *   pipe(
+ *     O.some('a'),
+ *     O.orElse(() => O.some('b'))
+ *   ),
+ *   O.some('a')
+ * )
+ *
+ * @category error handling
+ * @since 2.0.0
+ */
+const orElse = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, that) => isNone(self) ? that() : self);
+
+/**
+ * Similar to `orElse`, but instead of returning a simple union, it returns an `Either` object,
+ * which contains information about which of the two `Option`s has been chosen.
+ *
+ * This is useful when it's important to know whether the value was retrieved from the first `Option` or the second option.
+ *
+ * @param self - The first `Option` to be checked.
+ * @param that - The second `Option` to be considered if the first `Option` is `None`.
+ *
+ * @category error handling
+ * @since 2.0.0
+ */
+const orElseEither = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, that) => isNone(self) ? map(that(), Either.right) : map(self, Either.left));
+
+/**
+ * Given an `Iterable` collection of `Option`s, returns the first `Some` found in the collection.
+ *
+ * @param collection - An iterable collection of `Option` to be searched.
+ *
+ * @example
+ * import * as O from "effect/Option"
+ *
+ * assert.deepStrictEqual(O.firstSomeOf([O.none(), O.some(1), O.some(2)]), O.some(1))
+ *
+ * @category error handling
+ * @since 2.0.0
+ */
+const firstSomeOf = collection => {
+  let out = none();
+  for (out of collection) {
+    if (isSome(out)) {
+      return out;
+    }
+  }
+  return out;
+};
+
+/**
+ * Constructs a new `Option` from a nullable type. If the value is `null` or `undefined`, returns `None`, otherwise
+ * returns the value wrapped in a `Some`.
+ *
+ * @param nullableValue - The nullable value to be converted to an `Option`.
+ *
+ * @example
+ * import * as O from "effect/Option"
+ *
+ * assert.deepStrictEqual(O.fromNullable(undefined), O.none())
+ * assert.deepStrictEqual(O.fromNullable(null), O.none())
+ * assert.deepStrictEqual(O.fromNullable(1), O.some(1))
+ *
+ * @category conversions
+ * @since 2.0.0
+ */
+const fromNullable = nullableValue => nullableValue == null ? none() : some(nullableValue);
+
+/**
+ * This API is useful for lifting a function that returns `null` or `undefined` into the `Option` context.
+ *
+ * @example
+ * import * as O from "effect/Option"
+ *
+ * const parse = (s: string): number | undefined => {
+ *   const n = parseFloat(s)
+ *   return isNaN(n) ? undefined : n
+ * }
+ *
+ * const parseOption = O.liftNullable(parse)
+ *
+ * assert.deepStrictEqual(parseOption('1'), O.some(1))
+ * assert.deepStrictEqual(parseOption('not a number'), O.none())
+ *
+ * @category conversions
+ * @since 2.0.0
+ */
+const liftNullable = f => (...a) => fromNullable(f(...a));
+
+/**
+ * Returns the value of the `Option` if it is a `Some`, otherwise returns `null`.
+ *
+ * @param self - The `Option` to extract the value from.
+ *
+ * @example
+ * import * as O from "effect/Option"
+ *
+ * assert.deepStrictEqual(O.getOrNull(O.some(1)), 1)
+ * assert.deepStrictEqual(O.getOrNull(O.none()), null)
+ *
+ * @category getters
+ * @since 2.0.0
+ */
+const getOrNull = /*#__PURE__*/getOrElse(Function_dist_effectFunction.constNull);
+
+/**
+ * Returns the value of the `Option` if it is a `Some`, otherwise returns `undefined`.
+ *
+ * @param self - The `Option` to extract the value from.
+ *
+ * @example
+ * import * as O from "effect/Option"
+ *
+ * assert.deepStrictEqual(O.getOrUndefined(O.some(1)), 1)
+ * assert.deepStrictEqual(O.getOrUndefined(O.none()), undefined)
+ *
+ * @category getters
+ * @since 2.0.0
+ */
+const getOrUndefined = /*#__PURE__*/getOrElse(Function_dist_effectFunction.constUndefined);
+
+/**
+ * A utility function that lifts a function that throws exceptions into a function that returns an `Option`.
+ *
+ * This function is useful for any function that might throw an exception, allowing the developer to handle
+ * the exception in a more functional way.
+ *
+ * @param f - the function that can throw exceptions.
+ *
+ * @example
+ * import * as O from "effect/Option"
+ *
+ * const parse = O.liftThrowable(JSON.parse)
+ *
+ * assert.deepStrictEqual(parse("1"), O.some(1))
+ * assert.deepStrictEqual(parse(""), O.none())
+ *
+ * @category conversions
+ * @since 2.0.0
+ */
+const liftThrowable = f => (...a) => {
+  try {
+    return some(f(...a));
+  } catch (e) {
+    return none();
+  }
+};
+
+/**
+ * Extracts the value of an `Option` or throws if the `Option` is `None`.
+ *
+ * If a default error is sufficient for your use case and you don't need to configure the thrown error, see {@link getOrThrow}.
+ *
+ * @param self - The `Option` to extract the value from.
+ * @param onNone - A function that will be called if the `Option` is `None`. It returns the error to be thrown.
+ *
+ * @example
+ * import * as O from "effect/Option"
+ *
+ * assert.deepStrictEqual(
+ *   O.getOrThrowWith(O.some(1), () => new Error('Unexpected None')),
+ *   1
+ * )
+ * assert.throws(() => O.getOrThrowWith(O.none(), () => new Error('Unexpected None')))
+ *
+ * @category conversions
+ * @since 2.0.0
+ */
+const getOrThrowWith = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, onNone) => {
+  if (isSome(self)) {
+    return self.value;
+  }
+  throw onNone();
+});
+
+/**
+ * Extracts the value of an `Option` or throws if the `Option` is `None`.
+ *
+ * The thrown error is a default error. To configure the error thrown, see  {@link getOrThrowWith}.
+ *
+ * @param self - The `Option` to extract the value from.
+ * @throws `Error("getOrThrow called on a None")`
+ *
+ * @example
+ * import * as O from "effect/Option"
+ *
+ * assert.deepStrictEqual(O.getOrThrow(O.some(1)), 1)
+ * assert.throws(() => O.getOrThrow(O.none()))
+ *
+ * @category conversions
+ * @since 2.0.0
+ */
+const getOrThrow = /*#__PURE__*/getOrThrowWith(() => new Error("getOrThrow called on a None"));
+
+/**
+ * Maps the `Some` side of an `Option` value to a new `Option` value.
+ *
+ * @param self - An `Option` to map
+ * @param f - The function to map over the value of the `Option`
+ *
+ * @category transforming
+ * @since 2.0.0
+ */
+const map = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, f) => isNone(self) ? none() : some(f(self.value)));
+
+/**
+ * Maps the `Some` value of this `Option` to the specified constant value.
+ *
+ * @category transforming
+ * @since 2.0.0
+ */
+const as = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, b) => map(self, () => b));
+
+/**
+ * Maps the `Some` value of this `Option` to the `void` constant value.
+ *
+ * This is useful when the value of the `Option` is not needed, but the presence or absence of the value is important.
+ *
+ * @category transforming
+ * @since 2.0.0
+ */
+const asUnit = /*#__PURE__*/as(undefined);
+
+/**
+ * @since 2.0.0
+ */
+const unit = /*#__PURE__*/some(undefined);
+
+/**
+ * Applies a function to the value of an `Option` and flattens the result, if the input is `Some`.
+ *
+ * @category transforming
+ * @since 2.0.0
+ */
+const flatMap = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, f) => isNone(self) ? none() : f(self.value));
+
+/**
+ * This is `flatMap` + `fromNullable`, useful when working with optional values.
+ *
+ * @example
+ * import { some, none, flatMapNullable } from 'effect/Option'
+ * import { pipe } from "effect/Function"
+ *
+ * interface Employee {
+ *   company?: {
+ *     address?: {
+ *       street?: {
+ *         name?: string
+ *       }
+ *     }
+ *   }
+ * }
+ *
+ * const employee1: Employee = { company: { address: { street: { name: 'high street' } } } }
+ *
+ * assert.deepStrictEqual(
+ *   pipe(
+ *     some(employee1),
+ *     flatMapNullable(employee => employee.company?.address?.street?.name),
+ *   ),
+ *   some('high street')
+ * )
+ *
+ * const employee2: Employee = { company: { address: { street: {} } } }
+ *
+ * assert.deepStrictEqual(
+ *   pipe(
+ *     some(employee2),
+ *     flatMapNullable(employee => employee.company?.address?.street?.name),
+ *   ),
+ *   none()
+ * )
+ *
+ * @category transforming
+ * @since 2.0.0
+ */
+const flatMapNullable = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, f) => isNone(self) ? none() : fromNullable(f(self.value)));
+
+/**
+ * @category transforming
+ * @since 2.0.0
+ */
+const flatten = /*#__PURE__*/flatMap(Function_dist_effectFunction.identity);
+
+/**
+ * @category transforming
+ * @since 2.0.0
+ */
+const zipRight = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, that) => flatMap(self, () => that));
+
+/**
+ * @category transforming
+ * @since 2.0.0
+ */
+const composeK = /*#__PURE__*/Function_dist_effectFunction.dual(2, (afb, bfc) => a => flatMap(afb(a), bfc));
+
+/**
+ * Sequences the specified `that` `Option` but ignores its value.
+ *
+ * It is useful when we want to chain multiple operations, but only care about the result of `self`.
+ *
+ * @param that - The `Option` that will be ignored in the chain and discarded
+ * @param self - The `Option` we care about
+ *
+ * @category transforming
+ * @since 2.0.0
+ */
+const zipLeft = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, that) => tap(self, () => that));
+
+/**
+ * Applies the provided function `f` to the value of the `Option` if it is `Some` and returns the original `Option`
+ * unless `f` returns `None`, in which case it returns `None`.
+ *
+ * This function is useful for performing additional computations on the value of the input `Option` without affecting its value.
+ *
+ * @param f - Function to apply to the value of the `Option` if it is `Some`
+ * @param self - The `Option` to apply the function to
+ *
+ * @example
+ * import * as O from "effect/Option"
+ *
+ * const getInteger = (n: number) => Number.isInteger(n) ? O.some(n) : O.none()
+ *
+ * assert.deepStrictEqual(O.tap(O.none(), getInteger), O.none())
+ * assert.deepStrictEqual(O.tap(O.some(1), getInteger), O.some(1))
+ * assert.deepStrictEqual(O.tap(O.some(1.14), getInteger), O.none())
+ *
+ * @category transforming
+ * @since 2.0.0
+ */
+const tap = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, f) => flatMap(self, a => map(f(a), () => a)));
+
+/**
+ * @category combining
+ * @since 2.0.0
+ */
+const product = (self, that) => isSome(self) && isSome(that) ? some([self.value, that.value]) : none();
+
+/**
+ * @category combining
+ * @since 2.0.0
+ */
+const productMany = (self, collection) => {
+  if (isNone(self)) {
+    return none();
+  }
+  const out = [self.value];
+  for (const o of collection) {
+    if (isNone(o)) {
+      return none();
+    }
+    out.push(o.value);
+  }
+  return some(out);
+};
+
+/**
+ * Takes a structure of `Option`s and returns an `Option` of values with the same structure.
+ *
+ * - If a tuple is supplied, then the returned `Option` will contain a tuple with the same length.
+ * - If a struct is supplied, then the returned `Option` will contain a struct with the same keys.
+ * - If an iterable is supplied, then the returned `Option` will contain an array.
+ *
+ * @param fields - the struct of `Option`s to be sequenced.
+ *
+ * @example
+ * import * as O from "effect/Option"
+ *
+ * assert.deepStrictEqual(O.all([O.some(1), O.some(2)]), O.some([1, 2]))
+ * assert.deepStrictEqual(O.all({ a: O.some(1), b: O.some("hello") }), O.some({ a: 1, b: "hello" }))
+ * assert.deepStrictEqual(O.all({ a: O.some(1), b: O.none() }), O.none())
+ *
+ * @category combining
+ * @since 2.0.0
+ */
+// @ts-expect-error
+const all = input => {
+  if (Symbol.iterator in input) {
+    const out = [];
+    for (const o of input) {
+      if (isNone(o)) {
+        return none();
+      }
+      out.push(o.value);
+    }
+    return some(out);
+  }
+  const out = {};
+  for (const key of Object.keys(input)) {
+    const o = input[key];
+    if (isNone(o)) {
+      return none();
+    }
+    out[key] = o.value;
+  }
+  return some(out);
+};
+
+/**
+ * Zips two `Option` values together using a provided function, returning a new `Option` of the result.
+ *
+ * @param self - The left-hand side of the zip operation
+ * @param that - The right-hand side of the zip operation
+ * @param f - The function used to combine the values of the two `Option`s
+ *
+ * @example
+ * import * as O from "effect/Option"
+ *
+ * type Complex = [number, number]
+ *
+ * const complex = (real: number, imaginary: number): Complex => [real, imaginary]
+ *
+ * assert.deepStrictEqual(O.zipWith(O.none(), O.none(), complex), O.none())
+ * assert.deepStrictEqual(O.zipWith(O.some(1), O.none(), complex), O.none())
+ * assert.deepStrictEqual(O.zipWith(O.none(), O.some(1), complex), O.none())
+ * assert.deepStrictEqual(O.zipWith(O.some(1), O.some(2), complex), O.some([1, 2]))
+ *
+ * assert.deepStrictEqual(O.zipWith(O.some(1), complex)(O.some(2)), O.some([2, 1]))
+ *
+ * @category combining
+ * @since 2.0.0
+ */
+const zipWith = /*#__PURE__*/Function_dist_effectFunction.dual(3, (self, that, f) => map(product(self, that), ([a, b]) => f(a, b)));
+
+/**
+ * @category combining
+ * @since 2.0.0
+ */
+const ap = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, that) => zipWith(self, that, (f, a) => f(a)));
+
+/**
+ * Reduces an `Iterable` of `Option<A>` to a single value of type `B`, elements that are `None` are ignored.
+ *
+ * @param self - The Iterable of `Option<A>` to be reduced.
+ * @param b - The initial value of the accumulator.
+ * @param f - The reducing function that takes the current accumulator value and the unwrapped value of an `Option<A>`.
+ *
+ * @example
+ * import { some, none, reduceCompact } from 'effect/Option'
+ * import { pipe } from "effect/Function"
+ *
+ * const iterable = [some(1), none(), some(2), none()]
+ * assert.deepStrictEqual(pipe(iterable, reduceCompact(0, (b, a) => b + a)), 3)
+ *
+ * @category folding
+ * @since 2.0.0
+ */
+const reduceCompact = /*#__PURE__*/Function_dist_effectFunction.dual(3, (self, b, f) => {
+  let out = b;
+  for (const oa of self) {
+    if (isSome(oa)) {
+      out = f(out, oa.value);
+    }
+  }
+  return out;
+});
+
+/**
+ * Transforms an `Option` into an `Array`.
+ * If the input is `None`, an empty array is returned.
+ * If the input is `Some`, the value is wrapped in an array.
+ *
+ * @param self - The `Option` to convert to an array.
+ *
+ * @example
+ * import * as O from "effect/Option"
+ *
+ * assert.deepStrictEqual(O.toArray(O.some(1)), [1])
+ * assert.deepStrictEqual(O.toArray(O.none()), [])
+ *
+ * @category conversions
+ * @since 2.0.0
+ */
+const toArray = self => isNone(self) ? [] : [self.value];
+
+/**
+ * @category filtering
+ * @since 2.0.0
+ */
+const partitionMap = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, f) => {
+  if (isNone(self)) {
+    return [none(), none()];
+  }
+  const e = f(self.value);
+  return Either.isLeft(e) ? [some(e.left), none()] : [none(), some(e.right)];
+});
+
+/**
+ * Maps over the value of an `Option` and filters out `None`s.
+ *
+ * Useful when in addition to filtering you also want to change the type of the `Option`.
+ *
+ * @param self - The `Option` to map over.
+ * @param f - A function to apply to the value of the `Option`.
+ *
+ * @example
+ * import * as O from "effect/Option"
+ *
+ * const evenNumber = (n: number) => n % 2 === 0 ? O.some(n) : O.none()
+ *
+ * assert.deepStrictEqual(O.filterMap(O.none(), evenNumber), O.none())
+ * assert.deepStrictEqual(O.filterMap(O.some(3), evenNumber), O.none())
+ * assert.deepStrictEqual(O.filterMap(O.some(2), evenNumber), O.some(2))
+ *
+ * @category filtering
+ * @since 2.0.0
+ */
+const filterMap = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, f) => isNone(self) ? none() : f(self.value));
+
+/**
+ * Filters an `Option` using a predicate. If the predicate is not satisfied or the `Option` is `None` returns `None`.
+ *
+ * If you need to change the type of the `Option` in addition to filtering, see `filterMap`.
+ *
+ * @param predicate - A predicate function to apply to the `Option` value.
+ * @param fb - The `Option` to filter.
+ *
+ * @example
+ * import * as O from "effect/Option"
+ *
+ * // predicate
+ * const isEven = (n: number) => n % 2 === 0
+ *
+ * assert.deepStrictEqual(O.filter(O.none(), isEven), O.none())
+ * assert.deepStrictEqual(O.filter(O.some(3), isEven), O.none())
+ * assert.deepStrictEqual(O.filter(O.some(2), isEven), O.some(2))
+ *
+ * // refinement
+ * const isNumber = (v: unknown): v is number => typeof v === "number"
+ *
+ * assert.deepStrictEqual(O.filter(O.none(), isNumber), O.none())
+ * assert.deepStrictEqual(O.filter(O.some('hello'), isNumber), O.none())
+ * assert.deepStrictEqual(O.filter(O.some(2), isNumber), O.some(2))
+ *
+ * @category filtering
+ * @since 2.0.0
+ */
+const filter = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, predicate) => filterMap(self, b => predicate(b) ? Either.some(b) : Either.none));
+
+/**
+ * @example
+ * import { none, some, getEquivalence } from 'effect/Option'
+ * import * as N from 'effect/Number'
+ *
+ * const isEquivalent = getEquivalence(N.Equivalence)
+ * assert.deepStrictEqual(isEquivalent(none(), none()), true)
+ * assert.deepStrictEqual(isEquivalent(none(), some(1)), false)
+ * assert.deepStrictEqual(isEquivalent(some(1), none()), false)
+ * assert.deepStrictEqual(isEquivalent(some(1), some(2)), false)
+ * assert.deepStrictEqual(isEquivalent(some(1), some(1)), true)
+ *
+ * @category equivalence
+ * @since 2.0.0
+ */
+const getEquivalence = isEquivalent => Equivalence_dist_effectEquivalence.make((x, y) => x === y || (isNone(x) ? isNone(y) : isNone(y) ? false : isEquivalent(x.value, y.value)));
+
+/**
+ * The `Order` instance allows `Option` values to be compared with
+ * `compare`, whenever there is an `Order` instance for
+ * the type the `Option` contains.
+ *
+ * `None` is considered to be less than any `Some` value.
+ *
+ * @example
+ * import { none, some, getOrder } from 'effect/Option'
+ * import * as N from 'effect/Number'
+ * import { pipe } from "effect/Function"
+ *
+ * const O = getOrder(N.Order)
+ * assert.deepStrictEqual(O(none(), none()), 0)
+ * assert.deepStrictEqual(O(none(), some(1)), -1)
+ * assert.deepStrictEqual(O(some(1), none()), 1)
+ * assert.deepStrictEqual(O(some(1), some(2)), -1)
+ * assert.deepStrictEqual(O(some(1), some(1)), 0)
+ *
+ * @category sorting
+ * @since 2.0.0
+ */
+const getOrder = O => Order_dist_effectOrder.make((self, that) => isSome(self) ? isSome(that) ? O(self.value, that.value) : 1 : -1);
+
+/**
+ * Lifts a binary function into `Option`.
+ *
+ * @param f - The function to lift.
+ *
+ * @category lifting
+ * @since 2.0.0
+ */
+const lift2 = f => Function_dist_effectFunction.dual(2, (self, that) => zipWith(self, that, f));
+
+/**
+ * Transforms a `Predicate` function into a `Some` of the input value if the predicate returns `true` or `None`
+ * if the predicate returns `false`.
+ *
+ * @param predicate - A `Predicate` function that takes in a value of type `A` and returns a boolean.
+ *
+ * @example
+ * import * as O from "effect/Option"
+ *
+ * const getOption = O.liftPredicate((n: number) => n >= 0)
+ *
+ * assert.deepStrictEqual(getOption(-1), O.none())
+ * assert.deepStrictEqual(getOption(1), O.some(1))
+ *
+ * @category lifting
+ * @since 2.0.0
+ */
+const liftPredicate = predicate => b => predicate(b) ? some(b) : none();
+
+/**
+ * Returns a function that checks if a `Option` contains a given value using a provided `isEquivalent` function.
+ *
+ * @param equivalent - An `Equivalence` instance to compare values of the `Option`.
+ * @param self - The `Option` to apply the comparison to.
+ * @param a - The value to compare against the `Option`.
+ *
+ * @example
+ * import { some, none, containsWith } from 'effect/Option'
+ * import { Equivalence } from 'effect/Number'
+ * import { pipe } from "effect/Function"
+ *
+ * assert.deepStrictEqual(pipe(some(2), containsWith(Equivalence)(2)), true)
+ * assert.deepStrictEqual(pipe(some(1), containsWith(Equivalence)(2)), false)
+ * assert.deepStrictEqual(pipe(none(), containsWith(Equivalence)(2)), false)
+ *
+ * @category elements
+ * @since 2.0.0
+ */
+const containsWith = isEquivalent => Function_dist_effectFunction.dual(2, (self, a) => isNone(self) ? false : isEquivalent(self.value, a));
+const _equivalence = /*#__PURE__*/Equal_dist_effectEqual.equivalence();
+
+/**
+ * Returns a function that checks if an `Option` contains a given value using the default `Equivalence`.
+ *
+ * @category elements
+ * @since 2.0.0
+ */
+const contains = /*#__PURE__*/containsWith(_equivalence);
+
+/**
+ * Check if a value in an `Option` type meets a certain predicate.
+ *
+ * @param self - The `Option` to check.
+ * @param predicate - The condition to check.
+ *
+ * @example
+ * import { some, none, exists } from 'effect/Option'
+ * import { pipe } from "effect/Function"
+ *
+ * const isEven = (n: number) => n % 2 === 0
+ *
+ * assert.deepStrictEqual(pipe(some(2), exists(isEven)), true)
+ * assert.deepStrictEqual(pipe(some(1), exists(isEven)), false)
+ * assert.deepStrictEqual(pipe(none(), exists(isEven)), false)
+ *
+ * @since 2.0.0
+ */
+const exists = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, predicate) => isNone(self) ? false : predicate(self.value));
+
+// -------------------------------------------------------------------------------------
+// math
+// -------------------------------------------------------------------------------------
+
+/**
+ * @category math
+ * @since 2.0.0
+ */
+const sum = /*#__PURE__*/lift2(Number_dist_effectNumber.sum);
+
+/**
+ * @category math
+ * @since 2.0.0
+ */
+const multiply = /*#__PURE__*/lift2(Number_dist_effectNumber.multiply);
+
+/**
+ * @category math
+ * @since 2.0.0
+ */
+const subtract = /*#__PURE__*/lift2(Number_dist_effectNumber.subtract);
+
+/**
+ * @category math
+ * @since 2.0.0
+ */
+const divide = /*#__PURE__*/lift2(Number_dist_effectNumber.divide);
+
+/**
+ * Sum all numbers in an iterable of `Option<number>` ignoring the `None` values.
+ *
+ * @param self - The iterable of `Option<number>` to be summed.
+ *
+ * @example
+ * import { sumCompact, some, none } from 'effect/Option'
+ *
+ * const iterable = [some(2), none(), some(3), none()]
+ * assert.deepStrictEqual(sumCompact(iterable), 5)
+ *
+ * @category math
+ * @since 2.0.0
+ */
+const sumCompact = self => {
+  let out = 0;
+  for (const oa of self) {
+    if (isSome(oa)) {
+      out += oa.value;
+    }
+  }
+  return out;
+};
+
+/**
+ * Multiply all numbers in an iterable of `Option<number>` ignoring the `None` values.
+ *
+ * @param self - The iterable of `Option<number>` to be multiplied.
+ *
+ * @example
+ * import { multiplyCompact, some, none } from 'effect/Option'
+ *
+ * const iterable = [some(2), none(), some(3), none()]
+ * assert.deepStrictEqual(multiplyCompact(iterable), 6)
+ *
+ * @category math
+ * @since 2.0.0
+ */
+const multiplyCompact = self => {
+  let out = 1;
+  for (const oa of self) {
+    if (isSome(oa)) {
+      const a = oa.value;
+      if (a === 0) {
+        return 0;
+      }
+      out *= a;
+    }
+  }
+  return out;
+};
+
+// -------------------------------------------------------------------------------------
+// do notation
+// -------------------------------------------------------------------------------------
+
+/**
+ * @category do notation
+ * @since 2.0.0
+ */
+const bindTo = /*#__PURE__*/Function_dist_effectFunction.dual(2, (self, name) => map(self, a => ({
+  [name]: a
+})));
+const let_ = /*#__PURE__*/Function_dist_effectFunction.dual(3, (self, name, f) => map(self, a => Object.assign({}, a, {
+  [name]: f(a)
+})));
+
+/**
+ * @category do notation
+ * @since 2.0.0
+ */
+const bind = /*#__PURE__*/Function_dist_effectFunction.dual(3, (self, name, f) => flatMap(self, a => map(f(a), b => Object.assign({}, a, {
+  [name]: b
+}))));
+
+/**
+ * @category do notation
+ * @since 2.0.0
+ */
+const Do = /*#__PURE__*/some({});
+const adapter = /*#__PURE__*/Utils_dist_effectUtils.adapter();
+
+/**
+ * @category generators
+ * @since 2.0.0
+ */
+const gen = f => {
+  const iterator = f(adapter);
+  let state = iterator.next();
+  if (state.done) {
+    return some(void 0);
+  } else {
+    let current = state.value.value;
+    if (isNone(current)) {
+      return current;
+    }
+    while (!state.done) {
+      state = iterator.next(current.value);
+      if (!state.done) {
+        current = state.value.value;
+        if (isNone(current)) {
+          return current;
+        }
+      }
+    }
+    return some(state.value);
+  }
+};
+
+exports.Do = Do;
+exports.TypeId = TypeId;
+exports.all = all;
+exports.ap = ap;
+exports.as = as;
+exports.asUnit = asUnit;
+exports.bind = bind;
+exports.bindTo = bindTo;
+exports.composeK = composeK;
+exports.contains = contains;
+exports.containsWith = containsWith;
+exports.divide = divide;
+exports.exists = exists;
+exports.filter = filter;
+exports.filterMap = filterMap;
+exports.firstSomeOf = firstSomeOf;
+exports.flatMap = flatMap;
+exports.flatMapNullable = flatMapNullable;
+exports.flatten = flatten;
+exports.fromIterable = fromIterable;
+exports.fromNullable = fromNullable;
+exports.gen = gen;
+exports.getEquivalence = getEquivalence;
+exports.getLeft = getLeft;
+exports.getOrElse = getOrElse;
+exports.getOrNull = getOrNull;
+exports.getOrThrow = getOrThrow;
+exports.getOrThrowWith = getOrThrowWith;
+exports.getOrUndefined = getOrUndefined;
+exports.getOrder = getOrder;
+exports.getRight = getRight;
+exports.isNone = isNone;
+exports.isOption = isOption;
+exports.isSome = isSome;
+exports["let"] = let_;
+exports.lift2 = lift2;
+exports.liftNullable = liftNullable;
+exports.liftPredicate = liftPredicate;
+exports.liftThrowable = liftThrowable;
+exports.map = map;
+exports.match = match;
+exports.multiply = multiply;
+exports.multiplyCompact = multiplyCompact;
+exports.none = none;
+exports.orElse = orElse;
+exports.orElseEither = orElseEither;
+exports.partitionMap = partitionMap;
+exports.product = product;
+exports.productMany = productMany;
+exports.reduceCompact = reduceCompact;
+exports.some = some;
+exports.subtract = subtract;
+exports.sum = sum;
+exports.sumCompact = sumCompact;
+exports.tap = tap;
+exports.toArray = toArray;
+exports.toRefinement = toRefinement;
+exports.unit = unit;
+exports.zipLeft = zipLeft;
+exports.zipRight = zipRight;
+exports.zipWith = zipWith;