@fncts/io 0.0.1

package/IO/api.d.ts

@@ -0,0 +1,1130 @@
+import { FiberId } from "@fncts/base/data/FiberId";
+import { Maybe } from "@fncts/base/data/Maybe";
+import { Either } from "@fncts/base/data/Either";
+import { Lazy } from "@fncts/base/data/function";
+import { Cause } from "@fncts/base/data/Cause";
+import { InterruptStatus } from "@fncts/io/InterruptStatus";
+import { URIO, FIO, UIO } from "@fncts/io/IO/definition";
+import { RuntimeConfig } from "@fncts/io/RuntimeConfig";
+import { FiberDescriptor } from "@fncts/io/FiberDescriptor";
+import { Conc, ConcBuilder } from "@fncts/base/collection/immutable/Conc";
+import { Refinement } from "@fncts/base/data/Refinement";
+import { Predicate } from "@fncts/base/data/Predicate";
+import { NonEmptyArray } from "@fncts/base/collection/immutable/ImmutableNonEmptyArray";
+import { Eval } from "@fncts/base/control/Eval";
+import { Exit } from "@fncts/base/data/Exit";
+import { Trace } from "@fncts/base/data/Trace/definition";
+import { List } from "@fncts/base/collection/immutable/List";
+import { ImmutableArray } from "@fncts/base/collection/immutable/ImmutableArray";
+import { Supervisor } from "@fncts/io/Supervisor/definition";
+import { FiberRefs } from "@fncts/io/FiberRefs";
+import type * as P from "@fncts/base/typeclass";
+import type { _E, _R } from "@fncts/base/types";
+import type { FiberContext } from "@fncts/io/Fiber/FiberContext";
+import type { Canceler } from "@fncts/io/IO/definition";
+import { pipe } from "@fncts/base/data/function";
+import { IO } from "@fncts/io/IO/definition";
+/**
+ * Imports an asynchronous side-effect into a `IO`
+ * @tsplus static fncts.io.IOOps async
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function async<R, E, A>(register: (resolve: (_: IO<R, E, A>) => void) => void, blockingOn?: FiberId, __tsplusTrace?: string): IO<R, E, A>;
+/**
+ * Imports an asynchronous effect into a pure `IO`, possibly returning the value synchronously.
+ *
+ * If the register function returns a value synchronously, then the callback
+ * function must not be called. Otherwise the callback function must be called at most once.
+ * @tsplus static fncts.io.IOOps asyncMaybe
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function asyncMaybe<R, E, A>(register: (resolve: (_: IO<R, E, A>) => void) => Maybe<IO<R, E, A>>, blockingOn?: FiberId, __tsplusTrace?: string): IO<R, E, A>;
+/**
+ * Imports an asynchronous side-effect into an IO. The side-effect
+ * has the option of returning the value synchronously, which is useful in
+ * cases where it cannot be determined if the effect is synchronous or
+ * asynchronous until the side-effect is actually executed. The effect also
+ * has the option of returning a canceler, which will be used by the runtime
+ * to cancel the asynchronous effect if the fiber executing the effect is
+ * interrupted.
+ *
+ * If the register function returns a value synchronously, then the callback
+ * function must not be called. Otherwise the callback function must be called
+ * at most once.
+ *
+ * The list of fibers, that may complete the async callback, is used to
+ * provide better diagnostics.
+ * @tsplus static fncts.io.IOOps asyncInterrupt
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function asyncInterrupt<R, E, A>(register: (cb: (resolve: IO<R, E, A>) => void) => Either<Canceler<R>, IO<R, E, A>>, blockingOn?: FiberId, __tsplusTrace?: string): IO<R, E, A>;
+/**
+ * @tsplus fluent fncts.io.IO apFirst
+ * @tsplus operator fncts.io.IO <
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function apFirst_<R, E, A, R1, E1, B>(self: IO<R, E, A>, fb: IO<R1, E1, B>, __tsplusTrace?: string): IO<R1 & R, E1 | E, A>;
+/**
+ * Combine two effectful actions, keeping only the result of the second
+ * @tsplus fluent fncts.io.IO apSecond
+ * @tsplus operator fncts.io.IO >
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function apSecond_<R, E, A, R1, E1, B>(self: IO<R, E, A>, fb: IO<R1, E1, B>, __tsplusTrace?: string): IO<R1 & R, E1 | E, B>;
+/**
+ * @tsplus fluent fncts.io.IO as
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function as_<R, E, A, B>(self: IO<R, E, A>, b: Lazy<B>): IO<R, E, B>;
+/**
+ * Maps the success value of this effect to an optional value.
+ * @tsplus getter fncts.io.IO asJust
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function asJust<R, E, A>(ma: IO<R, E, A>, __tsplusTrace?: string): IO<R, E, Maybe<A>>;
+/**
+ * Maps the error value of this IO to an optional value.
+ * @tsplus getter fncts.io.IO asJustError
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function asJustError<R, E, A>(ma: IO<R, E, A>, __tsplusTrace?: string): IO<R, Maybe<E>, A>;
+/**
+ * @tsplus getter fncts.io.IO asUnit
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function asUnit<R, E, A>(self: IO<R, E, A>): IO<R, E, void>;
+/**
+ * Returns an IO whose failure and success channels have been mapped by
+ * the specified pair of functions, `f` and `g`.
+ * @tsplus fluent fncts.io.IO bimap
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function bimap_<R, E, A, E1, B>(self: IO<R, E, A>, f: (e: E) => E1, g: (a: A) => B, __tsplusTrace?: string): IO<R, E1, B>;
+/**
+ * Returns an IO that effectfully "peeks" at the failure or success of
+ * this effect.
+ * @tsplus fluent fncts.io.IO bitap
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function bitap_<R, E, A, R1, E1, R2, E2>(self: IO<R, E, A>, onFailure: (e: E) => IO<R1, E1, any>, onSuccess: (a: A) => IO<R2, E2, any>, __tsplusTrace?: string): IO<R & R1 & R2, E | E1 | E2, A>;
+/**
+ * Recovers from the specified error
+ * @tsplus fluent fncts.io.IO catch
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function catch_<N extends keyof E, K extends E[N] & string, R, E, A, R1, E1, A1>(ma: IO<R, E, A>, tag: N, k: K, f: (e: Extract<E, {
+    [n in N]: K;
+}>) => IO<R1, E1, A1>, __tsplusTrace?: string): IO<R & R1, Exclude<E, {
+    [n in N]: K;
+}> | E1, A | A1>;
+/**
+ * Recovers from all errors
+ * @tsplus fluent fncts.io.IO catchAll
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function catchAll_<R, E, A, R1, E1, A1>(ma: IO<R, E, A>, f: (e: E) => IO<R1, E1, A1>, __tsplusTrace?: string): IO<R & R1, E1, A | A1>;
+/**
+ *
+ * Recovers from all errors with provided cause.
+ * @tsplus fluent fncts.io.IO catchAllCause
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function catchAllCause_<R, E, A, R1, E1, A1>(ma: IO<R, E, A>, f: (_: Cause<E>) => IO<R1, E1, A1>, __tsplusTrace?: string): IO<R & R1, E1, A | A1>;
+/**
+ * Recovers from some or all of the error cases.
+ * @tsplus fluent fncts.io.IO catchJust
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function catchJust_<R, E, A, R1, E1, A1>(ma: IO<R, E, A>, f: (e: E) => Maybe<IO<R1, E1, A1>>, __tsplusTrace?: string): IO<R & R1, E | E1, A | A1>;
+/**
+ * Recovers from some or all of the error cases with provided cause.
+ * @tsplus fluent fncts.io.IO catchJustCause
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function catchJustCause_<R, E, A, R1, E1, A1>(ma: IO<R, E, A>, f: (_: Cause<E>) => Maybe<IO<R1, E1, A1>>): IO<R & R1, E | E1, A | A1>;
+/**
+ * Recovers from some or all of the defects with provided partial function.
+ *
+ * *WARNING*: There is no sensible way to recover from defects. This
+ * method should be used only at the boundary between IO and an external
+ * system, to transmit information on a defect for diagnostic or explanatory
+ * purposes.
+ * @tsplus fluent fncts.io.IO catchJustDefect
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function catchJustDefect_<R, E, A, R1, E1, A1>(ma: IO<R, E, A>, f: (_: unknown) => Maybe<IO<R1, E1, A1>>, __tsplusTrace?: string): IO<R & R1, E | E1, A | A1>;
+/**
+ * Recovers from the specified error
+ * @tsplus fluent IO catchTag
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function catchTag_<K extends E["_tag"] & string, R, E extends {
+    _tag: string;
+}, A, R1, E1, A1>(ma: IO<R, E, A>, k: K, f: (e: Extract<E, {
+    _tag: K;
+}>) => IO<R1, E1, A1>, __tsplusTrace?: string): IO<R & R1, Exclude<E, {
+    _tag: K;
+}> | E1, A | A1>;
+/**
+ * @tsplus getter fncts.io.IO cause
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function cause<R, E, A>(ma: IO<R, E, A>, __tsplusTrace?: string): IO<R, never, Cause<E>>;
+/**
+ * @tsplus fluent fncts.io.IO causeAsError
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function causeAsError<R, E, A>(ma: IO<R, E, A>, __tsplusTrace?: string): IO<R, Cause<E>, A>;
+/**
+ * Returns an IO that models the execution of this effect, followed by
+ * the passing of its value to the specified continuation function `f`,
+ * followed by the effect that it returns.
+ * @tsplus fluent fncts.io.IO flatMap
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function flatMap_<R, E, A, R1, E1, B>(ma: IO<R, E, A>, f: (a: A) => IO<R1, E1, B>, __tsplusTrace?: string): IO<R & R1, E | E1, B>;
+/**
+ * @tsplus fluent fncts.io.IO flatMapError
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function flatMapError_<R, R1, E, E1, A>(ma: IO<R, E, A>, f: (e: E) => IO<R1, never, E1>): IO<R & R1, E1, A>;
+/**
+ * Checks the interrupt status, and produces the IO returned by the
+ * specified callback.
+ * @tsplus static fncts.io.IOOps checkInterruptible
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function checkInterruptible<R, E, A>(f: (i: InterruptStatus) => IO<R, E, A>, __tsplusTrace?: string): IO<R, E, A>;
+/**
+ * @tsplus fluent fncts.io.IO collect
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function collect_<R, E, A, E1, A1>(ma: IO<R, E, A>, f: Lazy<E1>, pf: (a: A) => Maybe<A1>, __tsplusTrace?: string): IO<R, E | E1, A1>;
+/**
+ * @tsplus fluent fncts.io.IO collectIO
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function collectIO_<R, E, A, R1, E1, A1, E2>(ma: IO<R, E, A>, f: Lazy<E2>, pf: (a: A) => Maybe<IO<R1, E1, A1>>, __tsplusTrace?: string): IO<R & R1, E | E1 | E2, A1>;
+/**
+ * @tsplus static fncts.io.IOOps condIO
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function condIO_<R, R1, E, A>(b: boolean, onTrue: URIO<R, A>, onFalse: URIO<R1, E>): IO<R & R1, E, A>;
+/**
+ * Returns a lazily constructed effect, whose construction may itself require
+ * effects. The effect must not throw any exceptions. When no environment is required (i.e., when R == unknown)
+ * it is conceptually equivalent to `flatten(succeedWith(io))`. If you wonder if the effect throws exceptions,
+ * do not use this method, use `IO.deferTryCatch`.
+ * @tsplus static fncts.io.IOOps defer
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function defer<R, E, A>(io: Lazy<IO<R, E, A>>, __tsplusTrace?: string): IO<R, E, A>;
+/**
+ * Returns a lazily constructed effect, whose construction may itself require
+ * effects. The effect must not throw any exceptions. When no environment is required (i.e., when R == unknown)
+ * it is conceptually equivalent to `flatten(effectTotal(io))`. If you wonder if the effect throws exceptions,
+ * do not use this method, use `IO.deferTryCatchWith`.
+ * @tsplus static fncts.io.IOOps deferWith
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function deferWith<R, E, A>(io: (runtimeConfig: RuntimeConfig, id: FiberId) => IO<R, E, A>, __tsplusTrace?: string): IO<R, E, A>;
+/**
+ * Returns a lazily constructed effect, whose construction may itself require effects.
+ * When no environment is required (i.e., when R == unknown) it is conceptually equivalent to `flatten(try(io))`.
+ * @tsplus static fncts.io.IOOps deferTry
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function deferTry<R, E, A>(io: () => IO<R, E, A>, __tsplusTrace?: string): IO<R, unknown, A>;
+/**
+ * Returns a lazily constructed effect, whose construction may itself require effects.
+ * When no environment is required (i.e., when R == unknown) it is conceptually equivalent to `flatten(effect(io))`.
+ * @tsplus static IOOps deferTryWith
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function deferTryWith<R, E, A>(io: (runtimeConfig: RuntimeConfig, id: FiberId) => IO<R, E, A>): IO<R, unknown, A>;
+/**
+ * Returns a lazily constructed effect, whose construction may itself require effects,
+ * translating any thrown exceptions into typed failed effects and mapping the error.
+ *
+ * When no environment is required (i.e., when R == unknown) it is conceptually equivalent to `flatten(effect(io))`.
+ * @tsplus static IOOps deferTryCatch
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function deferTryCatch<R, E, A, E1>(io: () => IO<R, E, A>, onThrow: (error: unknown) => E1): IO<R, E | E1, A>;
+/**
+ * Returns a lazily constructed effect, whose construction may itself require effects,
+ * translating any thrown exceptions into typed failed effects and mapping the error.
+ *
+ * When no environment is required (i.e., when R == unknown) it is conceptually equivalent to `flatten(effect(io))`.
+ * @tsplus static IOOps deferTryCatchWith
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function deferTryCatchWith<R, E, A, E1>(io: (runtimeConfig: RuntimeConfig, id: FiberId) => IO<R, E, A>, onThrow: (error: unknown) => E1): IO<R, E | E1, A>;
+/**
+ * @tsplus static fncts.io.IOOps descriptor
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare const descriptor: IO<unknown, never, import("../FiberDescriptor").FiberDescriptor>;
+/**
+ * Constructs an IO based on information about the current fiber, such as
+ * its identity.
+ * @tsplus static fncts.io.IOOps descriptorWith
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function descriptorWith<R, E, A>(f: (d: FiberDescriptor) => IO<R, E, A>, __tsplusTrace?: string): IO<R, E, A>;
+/**
+ * Folds an `IO` that may fail with `E` or succeed with `A` into one that never fails but succeeds with `Either<E, A>`
+ * @tsplus getter fncts.io.IO either
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function either<R, E, A>(ma: IO<R, E, A>, __tsplusTrace?: string): URIO<R, Either<E, A>>;
+/**
+ * @tsplus fluent fncts.io.IO ensuring
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function ensuring_<R, E, A, R1>(self: IO<R, E, A>, finalizer: IO<R1, never, any>, __tsplusTrace?: string): IO<R & R1, E, A>;
+/**
+ * @tsplus fluent fncts.io.IO errorAsCause
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function errorAsCause<R, E, A>(ma: IO<R, Cause<E>, A>, __tsplusTrace?: string): IO<R, E, A>;
+/**
+ * @tsplus getter fncts.io.IO eventually
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function eventually<R, E, A>(ma: IO<R, E, A>, __tsplusTrace?: string): IO<R, never, A>;
+/**
+ * @tsplus fluent fncts.io.IO extend
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function extend_<R, E, A, B>(wa: IO<R, E, A>, f: (wa: IO<R, E, A>) => B, __tsplusTrace?: string): IO<R, E, B>;
+/**
+ * @tsplus static fncts.io.IOOps fail
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function fail<E>(e: Lazy<E>, __tsplusTrace?: string): FIO<E, never>;
+/**
+ * @tsplus static fncts.io.IOOps failNow
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function failNow<E>(e: E, __tsplusTrace?: string): FIO<E, never>;
+/**
+ * Creates a `IO` that has failed with the specified `Cause`
+ * @tsplus static fncts.io.IOOps failCauseNow
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function failCauseNow<E>(cause: Cause<E>, __tsplusTrace?: string): FIO<E, never>;
+/**
+ * Returns an effect that models failure with the specified lazily-evaluated `Cause`.
+ * @tsplus static fncts.io.IOOps failCause
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function failCause<E = never, A = never>(cause: Lazy<Cause<E>>, __tsplusTrace?: string): FIO<E, A>;
+/**
+ * Returns the `FiberId` of the `Fiber` on which this `IO` is running
+ * @tsplus static fncts.io.IOOps fiberId
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare const fiberId: IO<unknown, never, FiberId>;
+/**
+ * Filters the collection using the specified effectual predicate.
+ * @tsplus static fncts.io.IOOps filter
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function filter_<A, R, E>(as: Iterable<A>, f: (a: A) => IO<R, E, boolean>, __tsplusTrace?: string): IO<R, E, Conc<A>>;
+/**
+ * @tsplus static fncts.io.IOOps filterMap
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function filterMap_<A, R, E, B>(as: Iterable<A>, f: (a: A) => IO<R, E, Maybe<B>>, __tsplusTrace?: string): IO<R, E, Conc<B>>;
+/**
+ * @tsplus static fncts.io.IOOps filterMapWithIndex
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function filterMapWithIndex_<A, R, E, B>(as: Iterable<A>, f: (i: number, a: A) => IO<R, E, Maybe<B>>, __tsplusTrace?: string): IO<R, E, Conc<B>>;
+/**
+ * Filters the collection using the specified effectual predicate, removing
+ * all elements that satisfy the predicate.
+ * @tsplus static fncts.io.IOOps filterNot
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function filterNot_<A, R, E>(as: Iterable<A>, f: (a: A) => IO<R, E, boolean>, __tsplusTrace?: string): IO<R, E, Conc<A>>;
+/**
+ * Applies `or` if the predicate fails.
+ * @tsplus fluent fncts.io.IO filterOrElse
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function filterOrElse_<R, E, A, B extends A, R1, E1, A1>(fa: IO<R, E, A>, refinement: Refinement<A, B>, or: (a: Exclude<A, B>) => IO<R1, E1, A1>, __tsplusTrace?: string): IO<R & R1, E | E1, B | A1>;
+export declare function filterOrElse_<R, E, A, R1, E1, A1>(fa: IO<R, E, A>, predicate: Predicate<A>, or: (a: A) => IO<R1, E1, A1>, __tsplusTrace?: string): IO<R & R1, E | E1, A | A1>;
+/**
+ * Fails with `failWith` if the predicate fails.
+ * @tsplus fluent fncts.io.IO filterOrFail
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function filterOrFail_<R, E, A, B extends A, E1>(fa: IO<R, E, A>, refinement: Refinement<A, B>, failWith: (a: Exclude<A, B>) => E1): IO<R, E | E1, B>;
+export declare function filterOrFail_<R, E, A, E1>(fa: IO<R, E, A>, predicate: Predicate<A>, failWith: (a: A) => E1): IO<R, E | E1, A>;
+/**
+ * Returns an `IO` that yields the value of the first
+ * `IO` to succeed.
+ * @tsplus static fncts.io.IOOps firstSuccess
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function firstSuccess<R, E, A>(mas: NonEmptyArray<IO<R, E, A>>): IO<R, E, A>;
+/**
+ * Halts with specified `unknown` if the predicate fails.
+ * @tsplus fluent fncts.io.IO filterOrHalt
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function filterOrHalt_<R, E, A, B extends A>(fa: IO<R, E, A>, refinement: Refinement<A, B>, haltWith: (a: Exclude<A, B>) => unknown, __tsplusTrace?: string): IO<R, E, A>;
+export declare function filterOrHalt_<R, E, A>(fa: IO<R, E, A>, predicate: Predicate<A>, haltWith: (a: A) => unknown, __tsplusTrace?: string): IO<R, E, A>;
+/**
+ * @tsplus getter fncts.io.IO flatten
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function flatten<R, E, R1, E1, A>(self: IO<R, E, IO<R1, E1, A>>): IO<R & R1, E | E1, A>;
+/**
+ * Folds an `Iterable<A>` using an effectful function f, working sequentially from left to right.
+ * @tsplus static fncts.io.IOOps foldLeft
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function foldLeft_<A, B, R, E>(as: Iterable<A>, b: B, f: (b: B, a: A) => IO<R, E, B>, __tsplusTrace?: string): IO<R, E, B>;
+/**
+ * Combines an array of `IO`s using a `Monoid`
+ * @constrained
+ * @tsplus static fncts.io.IOOps foldMap
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function foldMap_<M>(M: P.Monoid<M>): <R, E, A>(as: Iterable<IO<R, E, A>>, f: (a: A) => M) => IO<R, E, M>;
+/**
+ * Performs a right-associative fold of an `Iterable<A>`
+ * @tsplus static fncts.io.IOOps foldRight
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function foldRight_<A, B, R, E>(as: Iterable<A>, b: UIO<B>, f: (a: A, b: IO<R, E, B>) => IO<R, E, B>): IO<R, E, B>;
+/**
+ * Applies the function `f` to each element of the `Iterable<A>` and
+ * returns the results in a new `Conc<B>`.
+ *
+ * For a parallel version of this method, see `foreachC`.
+ * If you do not need the results, see `foreachUnit` for a more efficient implementation.
+ * @tsplus static fncts.io.IOOps foreach
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function foreach_<A, R, E, B>(as: Iterable<A>, f: (a: A) => IO<R, E, B>, __tsplusTrace?: string): IO<R, E, Conc<B>>;
+/**
+ * Applies the function `f` to each element of the `Iterable<A>` and
+ * returns the results in a new `Conc<B>`.
+ *
+ * For a parallel version of this method, see `foreachC`.
+ * If you do not need the results, see `foreachUnit` for a more efficient implementation.
+ * @tsplus static fncts.io.IOOps foreachWithIndex
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function foreachWithIndex_<A, R, E, B>(as: Iterable<A>, f: (i: number, a: A) => IO<R, E, B>): IO<R, E, Conc<B>>;
+/**
+ * @tsplus static fncts.io.IOOps foreachWithIndexDiscard
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function foreachWithIndexDiscard_<A, R, E, B>(as: Iterable<A>, f: (i: number, a: A) => IO<R, E, B>): IO<R, E, void>;
+/**
+ * Applies the function `f` to each element of the `Iterable<A>` and runs
+ * produced IOs sequentially.
+ * @tsplus static fncts.io.IOOps foreachDiscard
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function foreachDiscard_<A, R, E, B>(as: Iterable<A>, f: (a: A) => IO<R, E, B>): IO<R, E, void>;
+/**
+ * Repeats this effect forever (until the first failure).
+ * @tsplus getter fncts.io.IO forever
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function forever<R, E, A>(ma: IO<R, E, A>): IO<R, E, never>;
+/**
+ * Returns an IO that forks this IO into its own separate fiber,
+ * returning the fiber immediately, without waiting for it to begin executing
+ * the IO.
+ *
+ * You can use the `fork` method whenever you want to execute an IO in a
+ * new fiber, concurrently and without "blocking" the fiber executing other
+ * IOs. Using fibers can be tricky, so instead of using this method
+ * directly, consider other higher-level methods, such as `raceWith`,
+ * `zipPar`, and so forth.
+ *
+ * The fiber returned by this method has methods interrupt the fiber and to
+ * wait for it to finish executing the IO. See `Fiber` for more
+ * information.
+ *
+ * Whenever you use this method to launch a new fiber, the new fiber is
+ * attached to the parent fiber's scope. This means when the parent fiber
+ * terminates, the child fiber will be terminated as well, ensuring that no
+ * fibers leak. This behavior is called "None supervision", and if this
+ * behavior is not desired, you may use the `forkDaemon` or `forkIn`
+ * methods.
+ * @tsplus getter fncts.io.IO fork
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function fork<R, E, A>(ma: IO<R, E, A>, __tsplusTrace?: string): URIO<R, FiberContext<E, A>>;
+/**
+ * Lifts an `Either` into an `IO`
+ * @tsplus static fncts.io.IOOps fromEither
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function fromEither<E, A>(either: Lazy<Either<E, A>>, __tsplusTrace?: string): IO<unknown, E, A>;
+/**
+ * Lifts an `Either` into an `IO`
+ * @tsplus static fncts.io.IOOps fromEitherNow
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function fromEitherNow<E, A>(either: Either<E, A>, __tsplusTrace?: string): IO<unknown, E, A>;
+/**
+ * Lifts an `Eval` into an `IO`
+ * @tsplus static fncts.io.IOOps fromEval
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function fromEval<A>(computation: Eval<A>, __tsplusTrace?: string): IO<unknown, never, A>;
+/**
+ * Creates a `IO` from an exit value
+ * @tsplus static fncts.io.IOOps fromExit
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function fromExit<E, A>(exit: Lazy<Exit<E, A>>, __tsplusTrace?: string): FIO<E, A>;
+/**
+ * Creates a `IO` from an exit value
+ * @tsplus static fncts.io.IOOps fromExitNow
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function fromExitNow<E, A>(exit: Exit<E, A>, __tsplusTrace?: string): FIO<E, A>;
+/**
+ * Lifts a `Maybe` into an `IO` but preserves the error as a `Maybe` in the error channel, making it easier to compose
+ * in some scenarios.
+ * @tsplus static fncts.io.IOOps fromMaybe
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function fromMaybe<A>(maybe: Lazy<Maybe<A>>, __tsplusTrace?: string): FIO<Maybe<never>, A>;
+/**
+ * @tsplus static fncts.io.IOOps fromMaybeNow
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function fromMaybeNow<A = never>(maybe: Maybe<A>, __tsplusTrace?: string): IO<unknown, Maybe<never>, A>;
+/**
+ * Create an IO that when executed will construct `promise` and wait for its result,
+ * errors will be handled using `onReject`
+ * @tsplus static fncts.io.IOOps fromPromiseCatch
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function fromPromiseCatch<E, A>(promise: Lazy<Promise<A>>, onReject: (reason: unknown) => E, __tsplusTrace?: string): FIO<E, A>;
+/**
+ * Create an IO that when executed will construct `promise` and wait for its result,
+ * errors will produce failure as `unknown`
+ * @tsplus static fncts.io.IOOps fromPromise
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function fromPromise<A>(promise: Lazy<Promise<A>>, __tsplusTrace?: string): FIO<unknown, A>;
+/**
+ * Like fromPromise but produces a defect in case of errors
+ * @tsplus static fncts.io.IOOps fromPromiseHalt
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function fromPromiseHalt<A>(promise: Lazy<Promise<A>>, __tsplusTrace?: string): FIO<never, A>;
+/**
+ * Unwraps the optional success of an `IO`, but can fail with a `Nothing` value.
+ * @tsplus getter fncts.io.IO get
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function get<R, E, A>(ma: IO<R, E, Maybe<A>>): IO<R, Maybe<E>, A>;
+/**
+ * Extracts the optional value, or returns the given 'orElse'.
+ * @tsplus fluent fncts.io.IO getOrElse
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function getOrElse_<R, E, A, B>(ma: IO<R, E, Maybe<A>>, orElse: Lazy<B>): IO<R, E, A | B>;
+/**
+ * Extracts the optional value, or executes the effect 'orElse'.
+ * @tsplus fluent fncts.io.IO getOrElseIO
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function getOrElseIO_<R, E, A, R1, E1, B>(ma: IO<R, E, Maybe<A>>, orElse: Lazy<IO<R1, E1, B>>): IO<R & R1, E | E1, A | B>;
+/**
+ * Lifts a Maybe into an IO. If the option is `Nothing`, fail with `onNothing`.
+ * @tsplus static fncts.io.IOOps getOrFailWith
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function getOrFailWith_<E, A>(maybe: Maybe<A>, onNothing: Lazy<E>): FIO<E, A>;
+/**
+ * Lifts a Maybe into a IO, if the Maybe is `Nothing` it fails with Unit.
+ * @tsplus static fncts.io.IOOps getOrFailUnit
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function getOrFailUnit<A>(option: Maybe<A>): FIO<void, A>;
+/**
+ * Creates an `IO` that halts with the specified lazily-evaluated defect.
+ * This method can be used for terminating a fiber because a defect has been
+ * detected in the code.
+ * @tsplus static fncts.io.IOOps halt
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function halt(e: Lazy<unknown>, __tsplusTrace?: string): UIO<never>;
+/**
+ * Creates an `IO` that halts with the specified defect
+ * This method can be used for terminating a fiber because a defect has been
+ * detected in the code.
+ * @tsplus static fncts.io.IOOps haltNow
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function haltNow(e: unknown, __tsplusTrace?: string): UIO<never>;
+/**
+ * @tsplus fluent fncts.io.IO ifIO
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function ifIO_<R, E, R1, E1, B, R2, E2, C>(self: IO<R, E, boolean>, onFalse: Lazy<IO<R1, E1, B>>, onTrue: Lazy<IO<R2, E2, C>>): IO<R & R1 & R2, E | E1 | E2, B | C>;
+/**
+ * @tsplus static fncts.io.IOOps if
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function if_<R, E, A, R1, E1, A1>(b: boolean, onTrue: Lazy<IO<R, E, A>>, onFalse: Lazy<IO<R1, E1, A1>>, __tsplusTrace?: string): IO<R & R1, E | E1, A | A1>;
+/**
+ * @tsplus getter fncts.io.IO ignore
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function ignore<R, E, A>(fa: IO<R, E, A>): URIO<R, void>;
+/**
+ * Folds a `IO` to a boolean describing whether or not it is a failure
+ * @tsplus getter fncts.io.IO isFailure
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function isFailure<R, E, A>(ma: IO<R, E, A>): IO<R, never, boolean>;
+/**
+ * Folds a `IO` to a boolean describing whether or not it is a success
+ * @tsplus getter fncts.io.IO isSuccess
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function isSuccess<R, E, A>(ma: IO<R, E, A>): IO<R, never, boolean>;
+/**
+ * Iterates with the specified effectual function. The moral equivalent of:
+ *
+ * ```typescript
+ * let s = initial;
+ *
+ * while (cont(s)) {
+ *   s = body(s);
+ * }
+ *
+ * return s;
+ * ```
+ * @tsplus static fncts.io.IOOps iterate
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function iterate_<R, E, A>(initial: A, cont: (a: A) => boolean, body: (a: A) => IO<R, E, A>, __tsplusTrace?: string): IO<R, E, A>;
+/**
+ * Returns an IO with the value on the left part.
+ * @tsplus static fncts.io.IOOps left
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function left<A>(a: Lazy<A>): UIO<Either<A, never>>;
+/**
+ * @tsplus static fncts.io.IOOps log
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function log(message: Lazy<string>, __tsplusTrace?: string): UIO<void>;
+/**
+ * Loops with the specified effectual function, collecting the results into a
+ * list. The moral equivalent of:
+ *
+ * ```typescript
+ * let s  = initial
+ * let as = [] as readonly A[]
+ *
+ * while (cont(s)) {
+ *   as = [body(s), ...as]
+ *   s  = inc(s)
+ * }
+ *
+ * A.reverse(as)
+ * ```
+ * @tsplus static fncts.io.IOOps loop
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function loop_<A, R, E, B>(initial: A, cont: (a: A) => boolean, inc: (b: A) => A, body: (b: A) => IO<R, E, B>, __tsplusTrace?: string): IO<R, E, Conc<B>>;
+/**
+ * Loops with the specified effectual function purely for its effects. The
+ * moral equivalent of:
+ *
+ * ```
+ * var s = initial
+ *
+ * while (cont(s)) {
+ *   body(s)
+ *   s = inc(s)
+ * }
+ * ```
+ * @tsplus static fncts.io.IOOps loopUnit
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function loopUnit_<A, R, E>(initial: A, cont: (a: A) => boolean, inc: (a: A) => A, body: (a: A) => IO<R, E, any>, __tsplusTrace?: string): IO<R, E, void>;
+/**
+ * Returns an `IO` whose success is mapped by the specified function `f`.
+ * @tsplus fluent fncts.io.IO map
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function map_<R, E, A, B>(fa: IO<R, E, A>, f: (a: A) => B, __tsplusTrace?: string): IO<R, E, B>;
+/**
+ * Map covariantly over the first argument.
+ *
+ * Returns an IO with its error channel mapped using the specified
+ * function. This can be used to lift a "smaller" error into a "larger"
+ * error.
+ * @tsplus fluent fncts.io.IO mapError
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function mapError_<R, E, A, E1>(fea: IO<R, E, A>, f: (e: E) => E1, __tsplusTrace?: string): IO<R, E1, A>;
+/**
+ * @tsplus static fncts.io.IOOps mapTryCatch
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function mapTryCatch_<R, E, A, E1, B>(io: IO<R, E, A>, f: (a: A) => B, onThrow: (u: unknown) => E1, __tsplusTrace?: string): IO<R, E | E1, B>;
+/**
+ * Returns an IO with its full cause of failure mapped using
+ * the specified function. This can be used to transform errors
+ * while preserving the original structure of Cause.
+ * @tsplus fluent fncts.io.IO mapErrorCause
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function mapErrorCause_<R, E, A, E1>(ma: IO<R, E, A>, f: (cause: Cause<E>) => Cause<E1>, __tsplusTrace?: string): IO<R, E1, A>;
+/**
+ * A more powerful version of `match_` that allows recovering from any kind of failure except interruptions.
+ * @tsplus fluent fncts.io.IO matchCause
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function matchCause_<R, E, A, A1, A2>(self: IO<R, E, A>, onFailure: (cause: Cause<E>) => A1, onSuccess: (a: A) => A2, __tsplusTrace?: string): IO<R, never, A1 | A2>;
+/**
+ * A more powerful version of `matchIO` that allows recovering from any kind of failure except interruptions.
+ * @tsplus fluent fncts.io.IO matchCauseIO
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function matchCauseIO_<R, E, A, R1, E1, A1, R2, E2, A2>(self: IO<R, E, A>, onFailure: (cause: Cause<E>) => IO<R1, E1, A1>, onSuccess: (a: A) => IO<R2, E2, A2>, __tsplusTrace?: string): IO<R & R1 & R2, E1 | E2, A1 | A2>;
+/**
+ * @tsplus fluent fncts.io.IO matchIO
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function matchIO_<R, R1, R2, E, E1, E2, A, A1, A2>(self: IO<R, E, A>, onFailure: (e: E) => IO<R1, E1, A1>, onSuccess: (a: A) => IO<R2, E2, A2>, __tsplusTrace?: string): IO<R & R1 & R2, E1 | E2, A1 | A2>;
+/**
+ * Folds over the failure value or the success value to yield an IO that
+ * does not fail, but succeeds with the value returned by the left or right
+ * function passed to `match_`.
+ * @tsplus fluent fncts.io.IO match
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function match_<R, E, A, B, C>(self: IO<R, E, A>, onFailure: (e: E) => B, onSuccess: (a: A) => C, __tsplusTrace?: string): IO<R, never, B | C>;
+/**
+ * A version of `matchIO` that gives you the (optional) trace of the error.
+ * @tsplus fluent fncts.io.IO matchTraceIO
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function matchTraceIO_<R, E, A, R1, E1, A1, R2, E2, A2>(ma: IO<R, E, A>, onFailure: (e: E, trace: Trace) => IO<R1, E1, A1>, onSuccess: (a: A) => IO<R2, E2, A2>, __tsplusTrace?: string): IO<R & R1 & R2, E1 | E2, A1 | A2>;
+/**
+ * @tsplus getter fncts.io.IO maybe
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function maybe<R, E, A>(io: IO<R, E, A>, __tsplusTrace?: string): URIO<R, Maybe<A>>;
+/**
+ * @tsplus getter fncts.io.IO merge
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function merge<R, E, A>(io: IO<R, E, A>, __tsplusTrace?: string): IO<R, never, A | E>;
+/**
+ * Merges an `Iterable<IO>` to a single IO, working sequentially.
+ * @tsplus static fncts.io.IOOps mergeAll
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function mergeAll_<R, E, A, B>(fas: Iterable<IO<R, E, A>>, b: B, f: (b: B, a: A) => B, __tsplusTrace?: string): IO<R, E, B>;
+/**
+ * Returns a `IO` that will never produce anything. The moral equivalent of
+ * `while(true) {}`, only without the wasted CPU cycles.
+ * @tsplus static fncts.io.IOOps never
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare const never: UIO<never>;
+/**
+ * Converts an option on errors into an option on values.
+ * @tsplus getter fncts.io.IO optional
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function optional<R, E, A>(ma: IO<R, Maybe<E>, A>): IO<R, E, Maybe<A>>;
+/**
+ * Returns the logical disjunction of the `Boolean` value returned by this
+ * effect and the `Boolean` value returned by the specified effect. This
+ * operator has "short circuiting" behavior so if the value returned by this
+ * effect is true the specified effect will not be evaluated.
+ * @tsplus fluent fncts.io.IO or
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function or_<R, E, R1, E1>(ma: IO<R, E, boolean>, mb: IO<R1, E1, boolean>, __tsplusTrace?: string): IO<R & R1, E | E1, boolean>;
+/**
+ * @tsplus fluent fncts.io.IO orElse
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function orElse_<R, E, A, R1, E1, A1>(ma: IO<R, E, A>, that: Lazy<IO<R1, E1, A1>>, __tsplusTrace?: string): IO<R & R1, E1, A | A1>;
+/**
+ * @tsplus fluent fncts.io.IO orElseEither
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function orElseEither_<R, E, A, R1, E1, A1>(self: IO<R, E, A>, that: Lazy<IO<R1, E1, A1>>, __tsplusTrace?: string): IO<R & R1, E1, Either<A, A1>>;
+/**
+ * @tsplus fluent fncts.io.IO orElseFail
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function orElseFail_<R, E, A, E1>(ma: IO<R, E, A>, e: Lazy<E1>): IO<R, E1, A>;
+/**
+ * @tsplus fluent fncts.io.IO orElseMaybe
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function orElseMaybe_<R, E, A, R1, E1, A1>(ma: IO<R, Maybe<E>, A>, that: Lazy<IO<R1, Maybe<E1>, A1>>, __tsplusTrace?: string): IO<R & R1, Maybe<E | E1>, A | A1>;
+/**
+ * @tsplus fluent fncts.io.IO orElseSucceed
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function orElseSucceed_<R, E, A, A1>(ma: IO<R, E, A>, a: Lazy<A1>, __tsplusTrace?: string): IO<R, E, A | A1>;
+/**
+ * @tsplus getter fncts.io.IO orHalt
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function orHalt<R, E, A>(ma: IO<R, E, A>, __tsplusTrace?: string): IO<R, never, A>;
+/**
+ * @tsplus getter fncts.io.IO orHaltKeep
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function orHaltKeep<R, E, A>(ma: IO<R, E, A>): IO<R, never, A>;
+/**
+ * @tsplus fluent fncts.io.IO orHaltWith
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function orHaltWith_<R, E, A>(ma: IO<R, E, A>, f: (e: E) => unknown, __tsplusTrace?: string): IO<R, never, A>;
+/**
+ * Exposes all parallel errors in a single call
+ * @tsplus fluent fncts.io.IO parallelErrors
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function parallelErrors<R, E, A>(io: IO<R, E, A>): IO<R, List<E>, A>;
+/**
+ * Feeds elements of type `A` to a function `f` that returns an IO.
+ * Collects all successes and failures in a separated fashion.
+ * @tsplus static fncts.io.IOOps partition
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function partition_<R, E, A, B>(as: Iterable<A>, f: (a: A) => IO<R, E, B>, __tsplusTrace?: string): IO<R, never, readonly [Conc<E>, Conc<B>]>;
+/**
+ * Keeps some of the errors, and terminates the fiber with the rest
+ * @tsplus fluent fncts.io.IO refineOrHalt
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function refineOrHalt_<R, E, A, E1>(fa: IO<R, E, A>, pf: (e: E) => Maybe<E1>, __tsplusTrace?: string): IO<R, E1, A>;
+/**
+ * Keeps some of the errors, and terminates the fiber with the rest, using
+ * the specified function to convert the `E` into a `Throwable`.
+ * @tsplus fluent fncts.io.IO refineOrHaltWith
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function refineOrHaltWith_<R, E, A, E1>(fa: IO<R, E, A>, pf: (e: E) => Maybe<E1>, f: (e: E) => unknown): IO<R, E1, A>;
+/**
+ * Fail with the returned value if the partial function `pf` matches, otherwise
+ * continue with the held value.
+ * @tsplus fluent fncts.io.IO reject
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function reject_<R, E, A, E1>(fa: IO<R, E, A>, pf: (a: A) => Maybe<E1>, __tsplusTrace?: string): IO<R, E | E1, A>;
+/**
+ * Continue with the returned computation if the partial function `pf` matches,
+ * translating the successful match into a failure, otherwise continue with
+ * the held value.
+ * @tsplus fluent fncts.io.IO rejectIO
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function rejectIO_<R, E, A, R1, E1>(fa: IO<R, E, A>, pf: (a: A) => Maybe<IO<R1, E1, E1>>, __tsplusTrace?: string): IO<R & R1, E | E1, A>;
+/**
+ * Repeats this effect the specified number of times.
+ * @tsplus fluent fncts.io.IO repeatN
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function repeatN_<R, E, A>(ma: IO<R, E, A>, n: number, __tsplusTrace?: string): IO<R, E, A>;
+/**
+ * Repeats this effect until its result satisfies the specified predicate.
+ * @tsplus fluent fncts.io.IO repeatUntil
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function repeatUntil_<R, E, A>(ma: IO<R, E, A>, f: (a: A) => boolean, __tsplusTrace?: string): IO<R, E, A>;
+/**
+ * Repeats this effect until its error satisfies the specified effectful predicate.
+ * @tsplus fluent fncts.io.IO repeatUntilIO
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function repeatUntilIO_<R, E, A, R1, E1>(ma: IO<R, E, A>, f: (a: A) => IO<R1, E1, boolean>, __tsplusTrace?: string): IO<R & R1, E | E1, A>;
+/**
+ * Repeats this effect while its error satisfies the specified predicate.
+ * @tsplus fluent fncts.io.IO repeatWhile
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function repeatWhile_<R, E, A>(ma: IO<R, E, A>, f: (a: A) => boolean): IO<R, E, A>;
+/**
+ * Repeats this effect while its error satisfies the specified effectful predicate.
+ * @tsplus fluent fncts.io.IO repeatWhileIO
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function repeatWhileIO_<R, E, A, R1, E1>(ma: IO<R, E, A>, f: (a: A) => IO<R1, E1, boolean>, __tsplusTrace?: string): IO<R & R1, E | E1, A>;
+/**
+ * @tsplus fluent fncts.io.IO replicate
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function replicate_<R, E, A>(self: IO<R, E, A>, n: number, __tsplusTrace?: string): ImmutableArray<IO<R, E, A>>;
+/**
+ * @tsplus fluent fncts.io.IO require
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function require_<R, E, A>(ma: IO<R, E, Maybe<A>>, error: Lazy<E>, __tsplusTrace?: string): IO<R, E, A>;
+/**
+ * Returns an IO that semantically runs the IO on a fiber,
+ * producing an `Exit` for the completion value of the fiber.
+ * @tsplus getter fncts.io.IO result
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function result<R, E, A>(ma: IO<R, E, A>, __tsplusTrace?: string): IO<R, never, Exit<E, A>>;
+/**
+ * Recover from the unchecked failure of the `IO`. (opposite of `orHalt`)
+ *
+ * @trace call
+ */
+export declare function resurrect<R, E, A>(io: IO<R, E, A>): IO<R, unknown, A>;
+/**
+ * Retries this effect until its error satisfies the specified predicate.
+ * @tsplus fluent fncts.io.IO retryUntil
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function retryUntil_<R, E, A>(fa: IO<R, E, A>, f: (e: E) => boolean, __tsplusTrace?: string): IO<R, E, A>;
+/**
+ * Retries this effect until its error satisfies the specified effectful predicate.
+ * @tsplus fluent fncts.io.IO retryUntilIO
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function retryUntilIO_<R, E, A, R1, E1>(fa: IO<R, E, A>, f: (e: E) => IO<R1, E1, boolean>, __tsplusTrace?: string): IO<R & R1, E | E1, A>;
+/**
+ * Retries this effect while its error satisfies the specified predicate.
+ * @tsplus fluent fncts.io.IO retryWhile
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function retryWhile_<R, E, A>(fa: IO<R, E, A>, f: (e: E) => boolean, __tsplusTrace?: string): IO<R, E, A>;
+/**
+ * Retries this effect while its error satisfies the specified effectful predicate.
+ * @tsplus fluent fncts.io.IO retryWhileIO
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function retryWhileIO_<R, E, A, R1, E1>(fa: IO<R, E, A>, f: (e: E) => IO<R1, E1, boolean>, __tsplusTrace?: string): IO<R & R1, E | E1, A>;
+/**
+ * Retrieves the runtimeConfig that this effect is running on.
+ * @tsplus static fncts.io.IOOps runtimeConfig
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare const runtimeConfig: UIO<RuntimeConfig>;
+/**
+ * Exposes the full cause of failure of this effect.
+ * @tsplus getter fncts.io.IO sandbox
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function sandbox<R, E, A>(fa: IO<R, E, A>, __tsplusTrace?: string): IO<R, Cause<E>, A>;
+/**
+ * @tsplus fluent fncts.io.IO sandboxWith
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function sandboxWith_<R, E, A, E1>(ma: IO<R, E, A>, f: (_: IO<R, Cause<E>, A>) => IO<R, Cause<E1>, A>, __tsplusTrace?: string): IO<R, E1, A>;
+/**
+ * Sets the runtime configuration to the specified value.
+ * @tsplus static fncts.io.IOOps setRuntimeConfig
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function setRuntimeConfig(runtimeConfig: Lazy<RuntimeConfig>, __tsplusTrace?: string): UIO<void>;
+/**
+ * @tsplus static fncts.io.IOOps sequenceIterable
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function sequenceIterable<R, E, A>(as: Iterable<IO<R, E, A>>): IO<R, E, Conc<A>>;
+/**
+ * @tsplus static fncts.io.IOOps sequenceIterableDiscard
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function sequenceIterableDiscard<R, E, A>(as: Iterable<IO<R, E, A>>, __tsplusTrace?: string): IO<R, E, void>;
+/**
+ * Creates a `IO` that has succeeded with a pure value
+ * @tsplus static fncts.io.IOOps succeedNow
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function succeedNow<A>(value: A, __tsplusTrace?: string): IO<unknown, never, A>;
+/**
+ * Imports a total synchronous effect into a pure `IO` value.
+ * The effect must not throw any exceptions. If you wonder if the effect
+ * throws exceptions, then do not use this method, use `IO.try`
+ * @tsplus static fncts.io.IOOps succeed
+ * @tsplus static fncts.io.IOOps __call
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function succeed<A>(effect: Lazy<A>, __tsplusTrace?: string): UIO<A>;
+/**
+ *
+ * Returns an IO with the behavior of this one, but where all child
+ * fibers forked in the effect are reported to the specified supervisor.
+ * @tsplus fluent fncts.io.IO supervised
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function supervised_<R, E, A>(fa: IO<R, E, A>, supervisor: Supervisor<any>, __tsplusTrace?: string): IO<R, E, A>;
+/**
+ * @tsplus fluent fncts.io.IO summarized
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function summarized_<R, E, A, R1, E1, B, C>(ma: IO<R, E, A>, summary: IO<R1, E1, B>, f: (start: B, end: B) => C, __tsplusTrace?: string): IO<R & R1, E | E1, readonly [C, A]>;
+/**
+ * Swaps the positions of a Bifunctor's arguments
+ * @tsplus getter fncts.io.IO swap
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function swap<R, E, A>(pab: IO<R, E, A>): IO<R, A, E>;
+/**
+ * Swaps the error/value parameters, applies the function `f` and flips the parameters back
+ * @tsplus fluent fncts.io.IO swapWith
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function swapWith_<R, E, A, R1, E1, A1>(fa: IO<R, E, A>, f: (ma: IO<R, A, E>) => IO<R1, A1, E1>): IO<R1, E1, A1>;
+/**
+ * A more powerful variation of `timed` that allows specifying the clock.
+ * @tsplus fluent fncts.io.IO timedWith
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function timedWith_<R, E, A, R1, E1>(ma: IO<R, E, A>, msTime: IO<R1, E1, number>, __tsplusTrace?: string): IO<R & R1, E | E1, readonly [number, A]>;
+/**
+ * Creates a `IO` that has succeeded with a pure value
+ * @tsplus static fncts.io.IOOps tryCatch
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function tryCatch<E, A>(effect: Lazy<A>, onThrow: (error: unknown) => E, __tsplusTrace?: string): FIO<E, A>;
+/**
+ * Returns an `IO` that submerges an `Either` into the `IO`.
+ * @tsplus getter fncts.io.IO absolve
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function absolve<R, E, E1, A>(ma: IO<R, E, Either<E1, A>>, __tsplusTrace?: string): IO<R, E | E1, A>;
+/**
+ * Composes computations in sequence, using the return value of one computation as input for the next
+ * and keeping only the result of the first
+ *
+ * Returns an IO that effectfully "peeks" at the success of this effect.
+ * @tsplus fluent fncts.io.IO tap
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function tap_<R, E, A, R1, E1, B>(self: IO<R, E, A>, f: (a: A) => IO<R1, E1, B>, __tsplusTrace?: string): IO<R1 & R, E1 | E, A>;
+/**
+ * Returns an IO that effectually "peeks" at the cause of the failure of
+ * this IO.
+ * @tsplus fluent fncts.io.IO tapCause
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function tapCause_<R2, A2, R, E, E2>(ma: IO<R2, E2, A2>, f: (e: Cause<E2>) => IO<R, E, any>, __tsplusTrace?: string): IO<R2 & R, E | E2, A2>;
+/**
+ * Returns an IO that effectfully "peeks" at the failure of this effect.
+ * @tsplus fluent fncts.io.IO tapError
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function tapError_<R, E, A, R1, E1>(self: IO<R, E, A>, f: (e: E) => IO<R1, E1, any>, __tsplusTrace?: string): IO<R & R1, E | E1, A>;
+/**
+ * Returns an effect that effectually "peeks" at the cause of the failure of
+ * this effect.
+ * @tsplus fluent fncts.io.IO tapErrorCause
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function tapErrorCause_<R, E, A, R1, E1>(self: IO<R, E, A>, f: (e: Cause<E>) => IO<R1, E1, any>, __tsplusTrace?: string): IO<R & R1, E | E1, A>;
+/**
+ * @tsplus fluent fncts.io.IO tryOrElse
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function tryOrElse_<R, E, A, R1, E1, A1, R2, E2, A2>(ma: IO<R, E, A>, that: Lazy<IO<R1, E1, A1>>, onSuccess: (a: A) => IO<R2, E2, A2>, __tsplusTrace?: string): IO<R & R1 & R2, E1 | E2, A1 | A2>;
+/**
+ * @tsplus static fncts.io.IOOps unit
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare const unit: UIO<void>;
+/**
+ * Converts an option on errors into an option on values.
+ * @tsplus getter fncts.io.IO unjust
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function unjust<R, E, A>(self: IO<R, Maybe<E>, A>): IO<R, E, Maybe<A>>;
+/**
+ * Takes some fiber failures and converts them into errors, using the
+ * specified function to convert the `E` into an `E1 | E2`.
+ * @tsplus fluent fncts.io.IO unrefineWith
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function unrefineWith_<R, E, A, E1, E2>(fa: IO<R, E, A>, pf: (u: unknown) => Maybe<E1>, f: (e: E) => E2, __tsplusTrace?: string): IO<R, E1 | E2, A>;
+/**
+ * The inverse operation `sandbox`
+ * @tsplus getter fncts.io.IO unsandbox
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function unsandbox<R, E, A>(ma: IO<R, Cause<E>, A>): IO<R, E, A>;
+/**
+ * Updates the `FiberRef` values for the fiber running this effect using the
+ * specified function
+ * @tsplus static fncts.io.IOOps updateFiberRefs
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function updateFiberRefs(f: (fiberId: FiberId.Runtime, fiberRefs: FiberRefs) => FiberRefs, __tsplusTrace?: string): UIO<void>;
+/**
+ * @tsplus fluent fncts.io.IO __call
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare const via: typeof pipe;
+/**
+ * @tsplus fluent fncts.io.IO when
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function when_<R, E, A>(ma: IO<R, E, A>, b: Lazy<boolean>, __tsplusTrace?: string): IO<R, E, void>;
+/**
+ * The moral equivalent of `if (p) exp` when `p` has side-effects
+ * @tsplus fluent fncts.io.IO whenIO
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function whenIO_<R, E, A, R1, E1>(ma: IO<R, E, A>, mb: IO<R1, E1, boolean>): IO<R1 & R, E | E1, void>;
+/**
+ * Returns an effect that yields to the runtime system, starting on a fresh
+ * stack. Manual use of this method can improve fairness, at the cost of
+ * overhead.
+ * @tsplus static fncts.io.IOOps yieldNow
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare const yieldNow: UIO<void>;
+/**
+ * @tsplus fluent fncts.io.IO zip
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function zip_<R, E, A, R1, E1, B>(self: IO<R, E, A>, that: IO<R1, E1, B>): IO<R & R1, E | E1, readonly [A, B]>;
+/**
+ * @tsplus fluent fncts.io.IO zipWith
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function zipWith_<R, E, A, R1, E1, B, C>(self: IO<R, E, A>, that: IO<R1, E1, B>, f: (a: A, b: B) => C): IO<R & R1, E | E1, C>;
+export declare class GenIO<R, E, A> {
+    readonly effect: IO<R, E, A>;
+    readonly _trace?: string | undefined;
+    readonly _R: (_R: R) => void;
+    readonly _E: () => E;
+    readonly _A: () => A;
+    constructor(effect: IO<R, E, A>, _trace?: string | undefined);
+    [Symbol.iterator](): Generator<GenIO<R, E, A>, A, any>;
+}
+/**
+ * @internal
+ */
+export declare const __adapter: (_: any) => any;
+/**
+ * @tsplus static fncts.io.IOOps gen
+ * @gen
+ * @tsplus location "@fncts/io/IO/api"
+ */
+export declare function gen<T extends GenIO<any, any, any>, A>(f: (i: {
+    <R, E, A>(_: IO<R, E, A>, __tsplusTrace?: string): GenIO<R, E, A>;
+}) => Generator<T, A, any>): IO<_R<T>, _E<T>, A>;