import * as Deferred from "./Deferred.ts";
import * as Effect from "./Effect.ts";
import * as Fiber from "./Fiber.ts";
import type * as Inspectable from "./Inspectable.ts";
import * as Option from "./Option.ts";
import type { Pipeable } from "./Pipeable.ts";
import type { Scheduler } from "./Scheduler.ts";
import type * as Scope from "./Scope.ts";
declare const TypeId = "~effect/FiberHandle";
/**
 * Scoped handle that manages at most one fiber, interrupts the current fiber
 * when the handle's scope closes, and removes managed fibers from the handle
 * when they complete.
 *
 * **Example** (Managing a single fiber)
 *
 * ```ts
 * import { Effect, Fiber, FiberHandle } from "effect"
 *
 * Effect.gen(function*() {
 *   // Create a FiberHandle that can hold fibers producing strings
 *   const handle = yield* FiberHandle.make<string, never>()
 *
 *   // The handle can store and manage a single fiber
 *   const fiber = yield* FiberHandle.run(handle, Effect.succeed("hello"))
 *   const result = yield* Fiber.await(fiber)
 *   console.log(result) // "hello"
 * })
 * ```
 *
 * @category models
 * @since 2.0.0
 */
export interface FiberHandle<out A = unknown, out E = unknown> extends Pipeable, Inspectable.Inspectable {
    readonly [TypeId]: typeof TypeId;
    readonly deferred: Deferred.Deferred<void, unknown>;
    state: {
        readonly _tag: "Open";
        fiber: Fiber.Fiber<A, E> | undefined;
    } | {
        readonly _tag: "Closed";
    };
}
/**
 * Returns `true` if a value is a `FiberHandle` by checking for the
 * `FiberHandle` runtime marker.
 *
 * **Example** (Checking fiber handles)
 *
 * ```ts
 * import { Effect, FiberHandle } from "effect"
 *
 * Effect.gen(function*() {
 *   const handle = yield* FiberHandle.make()
 *
 *   console.log(FiberHandle.isFiberHandle(handle)) // true
 *   console.log(FiberHandle.isFiberHandle("not a handle")) // false
 * })
 * ```
 *
 * @category refinements
 * @since 2.0.0
 */
export declare const isFiberHandle: (u: unknown) => u is FiberHandle;
/**
 * Creates a scoped `FiberHandle` that can store a single fiber.
 *
 * **Details**
 *
 * When the associated `Scope` is closed, the contained fiber will be
 * interrupted. You can add a fiber to the handle using `FiberHandle.run`, and
 * the fiber will be automatically removed from the `FiberHandle` when it
 * completes.
 *
 * **Example** (Creating a scoped fiber handle)
 *
 * ```ts
 * import { Effect, FiberHandle } from "effect"
 *
 * Effect.gen(function*() {
 *   const handle = yield* FiberHandle.make()
 *
 *   // run some effects
 *   yield* FiberHandle.run(handle, Effect.never)
 *   // this will interrupt the previous fiber
 *   yield* FiberHandle.run(handle, Effect.never)
 *
 *   yield* Effect.sleep(1000)
 * }).pipe(
 *   Effect.scoped // The fiber will be interrupted when the scope is closed
 * )
 * ```
 *
 * @category constructors
 * @since 2.0.0
 */
export declare const make: <A = unknown, E = unknown>() => Effect.Effect<FiberHandle<A, E>, never, Scope.Scope>;
/**
 * Creates a scoped run function that forks effects into a new `FiberHandle`.
 *
 * **Details**
 *
 * Each call returns the forked fiber, stores it in the handle, and interrupts
 * the previous fiber unless `onlyIfMissing` is set. The managed fiber is
 * interrupted when the handle's scope closes.
 *
 * **Example** (Running effects with a fiber handle)
 *
 * ```ts
 * import { Effect, Fiber, FiberHandle } from "effect"
 *
 * Effect.gen(function*() {
 *   const run = yield* FiberHandle.makeRuntime<never>()
 *
 *   // Run effects and get fibers back
 *   const fiberA = run(Effect.succeed("first"))
 *   const fiberB = run(Effect.succeed("second"))
 *
 *   // The second fiber will interrupt the first
 *   const resultA = yield* Fiber.await(fiberA)
 *   const resultB = yield* Fiber.await(fiberB)
 * }).pipe(Effect.scoped)
 * ```
 *
 * @category constructors
 * @since 2.0.0
 */
export declare const makeRuntime: <R, E = unknown, A = unknown>() => Effect.Effect<(<XE extends E, XA extends A>(effect: Effect.Effect<XA, XE, R>, options?: {
    readonly signal?: AbortSignal | undefined;
    readonly scheduler?: Scheduler | undefined;
    readonly onlyIfMissing?: boolean | undefined;
    readonly propagateInterruption?: boolean | undefined;
} | undefined) => Fiber.Fiber<XA, XE>), never, Scope.Scope | R>;
/**
 * Creates a scoped run function that forks effects into a new `FiberHandle`
 * and returns a `Promise` for each effect result.
 *
 * **Details**
 *
 * Each call stores the fiber in the handle and interrupts the previous fiber
 * unless `onlyIfMissing` is set. The returned Promise resolves with the
 * effect's success value or rejects with the squashed failure cause.
 *
 * **Example** (Running effects as promises)
 *
 * ```ts
 * import { Effect, FiberHandle } from "effect"
 *
 * Effect.gen(function*() {
 *   const run = yield* FiberHandle.makeRuntimePromise()
 *
 *   // Run effects and get promises back
 *   const promise = run(Effect.succeed("hello"))
 *   const result = yield* Effect.promise(() => promise)
 *   console.log(result) // "hello"
 * }).pipe(Effect.scoped)
 * ```
 *
 * @category constructors
 * @since 3.13.0
 */
export declare const makeRuntimePromise: <R = never, A = unknown, E = unknown>() => Effect.Effect<(<XE extends E, XA extends A>(effect: Effect.Effect<XA, XE, R>, options?: {
    readonly signal?: AbortSignal | undefined;
    readonly scheduler?: Scheduler | undefined;
    readonly onlyIfMissing?: boolean | undefined;
    readonly propagateInterruption?: boolean | undefined;
} | undefined) => Promise<XA>), never, Scope.Scope | R>;
/**
 * Sets the fiber in a FiberHandle. When the fiber completes, it will be removed from the FiberHandle.
 * If a fiber is already running, it will be interrupted unless `options.onlyIfMissing` is set.
 *
 * **Example** (Setting a fiber unsafely)
 *
 * ```ts
 * import { Effect, Fiber, FiberHandle } from "effect"
 *
 * Effect.gen(function*() {
 *   const handle = yield* FiberHandle.make()
 *   const fiber = Effect.runFork(Effect.succeed("hello"))
 *
 *   // Set the fiber directly (unsafe)
 *   FiberHandle.setUnsafe(handle, fiber)
 *
 *   // The fiber is now managed by the handle
 *   const result = yield* Fiber.await(fiber)
 *   console.log(result) // "hello"
 * })
 * ```
 *
 * @category combinators
 * @since 4.0.0
 */
export declare const setUnsafe: {
    /**
     * Sets the fiber in a FiberHandle. When the fiber completes, it will be removed from the FiberHandle.
     * If a fiber is already running, it will be interrupted unless `options.onlyIfMissing` is set.
     *
     * **Example** (Setting a fiber unsafely)
     *
     * ```ts
     * import { Effect, Fiber, FiberHandle } from "effect"
     *
     * Effect.gen(function*() {
     *   const handle = yield* FiberHandle.make()
     *   const fiber = Effect.runFork(Effect.succeed("hello"))
     *
     *   // Set the fiber directly (unsafe)
     *   FiberHandle.setUnsafe(handle, fiber)
     *
     *   // The fiber is now managed by the handle
     *   const result = yield* Fiber.await(fiber)
     *   console.log(result) // "hello"
     * })
     * ```
     *
     * @category combinators
     * @since 4.0.0
     */
    <A, E, XE extends E, XA extends A>(fiber: Fiber.Fiber<XA, XE>, options?: {
        readonly onlyIfMissing?: boolean | undefined;
        readonly propagateInterruption?: boolean | undefined;
    }): (self: FiberHandle<A, E>) => void;
    /**
     * Sets the fiber in a FiberHandle. When the fiber completes, it will be removed from the FiberHandle.
     * If a fiber is already running, it will be interrupted unless `options.onlyIfMissing` is set.
     *
     * **Example** (Setting a fiber unsafely)
     *
     * ```ts
     * import { Effect, Fiber, FiberHandle } from "effect"
     *
     * Effect.gen(function*() {
     *   const handle = yield* FiberHandle.make()
     *   const fiber = Effect.runFork(Effect.succeed("hello"))
     *
     *   // Set the fiber directly (unsafe)
     *   FiberHandle.setUnsafe(handle, fiber)
     *
     *   // The fiber is now managed by the handle
     *   const result = yield* Fiber.await(fiber)
     *   console.log(result) // "hello"
     * })
     * ```
     *
     * @category combinators
     * @since 4.0.0
     */
    <A, E, XE extends E, XA extends A>(self: FiberHandle<A, E>, fiber: Fiber.Fiber<XA, XE>, options?: {
        readonly onlyIfMissing?: boolean | undefined;
        readonly propagateInterruption?: boolean | undefined;
    }): void;
};
/**
 * Sets the fiber in the `FiberHandle`.
 *
 * **Details**
 *
 * When the fiber completes, it will be removed from the `FiberHandle`. If a
 * fiber already exists in the `FiberHandle`, it will be interrupted unless
 * `options.onlyIfMissing` is set.
 *
 * **Example** (Setting a fiber safely)
 *
 * ```ts
 * import { Effect, Fiber, FiberHandle } from "effect"
 *
 * Effect.gen(function*() {
 *   const handle = yield* FiberHandle.make()
 *   const fiber = Effect.runFork(Effect.succeed("hello"))
 *
 *   // Set the fiber safely
 *   yield* FiberHandle.set(handle, fiber)
 *
 *   // The fiber is now managed by the handle
 *   const result = yield* Fiber.await(fiber)
 *   console.log(result) // "hello"
 * })
 * ```
 *
 * @category combinators
 * @since 2.0.0
 */
export declare const set: {
    /**
     * Sets the fiber in the `FiberHandle`.
     *
     * **Details**
     *
     * When the fiber completes, it will be removed from the `FiberHandle`. If a
     * fiber already exists in the `FiberHandle`, it will be interrupted unless
     * `options.onlyIfMissing` is set.
     *
     * **Example** (Setting a fiber safely)
     *
     * ```ts
     * import { Effect, Fiber, FiberHandle } from "effect"
     *
     * Effect.gen(function*() {
     *   const handle = yield* FiberHandle.make()
     *   const fiber = Effect.runFork(Effect.succeed("hello"))
     *
     *   // Set the fiber safely
     *   yield* FiberHandle.set(handle, fiber)
     *
     *   // The fiber is now managed by the handle
     *   const result = yield* Fiber.await(fiber)
     *   console.log(result) // "hello"
     * })
     * ```
     *
     * @category combinators
     * @since 2.0.0
     */
    <A, E, XE extends E, XA extends A>(fiber: Fiber.Fiber<XA, XE>, options?: {
        readonly onlyIfMissing?: boolean;
        readonly propagateInterruption?: boolean | undefined;
    }): (self: FiberHandle<A, E>) => Effect.Effect<void>;
    /**
     * Sets the fiber in the `FiberHandle`.
     *
     * **Details**
     *
     * When the fiber completes, it will be removed from the `FiberHandle`. If a
     * fiber already exists in the `FiberHandle`, it will be interrupted unless
     * `options.onlyIfMissing` is set.
     *
     * **Example** (Setting a fiber safely)
     *
     * ```ts
     * import { Effect, Fiber, FiberHandle } from "effect"
     *
     * Effect.gen(function*() {
     *   const handle = yield* FiberHandle.make()
     *   const fiber = Effect.runFork(Effect.succeed("hello"))
     *
     *   // Set the fiber safely
     *   yield* FiberHandle.set(handle, fiber)
     *
     *   // The fiber is now managed by the handle
     *   const result = yield* Fiber.await(fiber)
     *   console.log(result) // "hello"
     * })
     * ```
     *
     * @category combinators
     * @since 2.0.0
     */
    <A, E, XE extends E, XA extends A>(self: FiberHandle<A, E>, fiber: Fiber.Fiber<XA, XE>, options?: {
        readonly onlyIfMissing?: boolean;
        readonly propagateInterruption?: boolean | undefined;
    }): Effect.Effect<void>;
};
/**
 * Retrieves the fiber from the FiberHandle synchronously.
 *
 * **Example** (Reading the current fiber unsafely)
 *
 * ```ts
 * import { Effect, FiberHandle } from "effect"
 *
 * Effect.gen(function*() {
 *   const handle = yield* FiberHandle.make()
 *
 *   // No fiber initially
 *   const emptyFiber = FiberHandle.getUnsafe(handle)
 *   console.log(emptyFiber._tag === "None") // true
 *
 *   // Add a fiber
 *   yield* FiberHandle.run(handle, Effect.succeed("hello"))
 *   const fiber = FiberHandle.getUnsafe(handle)
 *   console.log(fiber._tag === "Some") // true
 * })
 * ```
 *
 * @category combinators
 * @since 4.0.0
 */
export declare function getUnsafe<A, E>(self: FiberHandle<A, E>): Option.Option<Fiber.Fiber<A, E>>;
/**
 * Retrieves the fiber from the FiberHandle effectfully.
 *
 * **Example** (Reading the current fiber)
 *
 * ```ts
 * import { Effect, Fiber, FiberHandle } from "effect"
 *
 * Effect.gen(function*() {
 *   const handle = yield* FiberHandle.make()
 *
 *   // Add a fiber
 *   yield* FiberHandle.run(handle, Effect.succeed("hello"))
 *
 *   // Get the current fiber if present
 *   const fiber = yield* FiberHandle.get(handle)
 *   if (fiber._tag === "Some") {
 *     const result = yield* Fiber.await(fiber.value)
 *     console.log(result) // "hello"
 *   }
 * })
 * ```
 *
 * @category combinators
 * @since 2.0.0
 */
export declare function get<A, E>(self: FiberHandle<A, E>): Effect.Effect<Option.Option<Fiber.Fiber<A, E>>>;
/**
 * Interrupts the fiber currently stored in the `FiberHandle`, if any, and
 * leaves the handle empty.
 *
 * **Example** (Clearing a fiber handle)
 *
 * ```ts
 * import { Effect, FiberHandle } from "effect"
 *
 * Effect.gen(function*() {
 *   const handle = yield* FiberHandle.make()
 *
 *   // Add a fiber
 *   yield* FiberHandle.run(handle, Effect.never)
 *
 *   // Clear the handle, interrupting the fiber
 *   yield* FiberHandle.clear(handle)
 *
 *   // The handle is now empty
 *   const fiber = FiberHandle.getUnsafe(handle)
 *   console.log(fiber) // Option.none()
 * })
 * ```
 *
 * @category combinators
 * @since 2.0.0
 */
export declare const clear: <A, E>(self: FiberHandle<A, E>) => Effect.Effect<void>;
/**
 * Forks an Effect and stores the resulting fiber in the `FiberHandle`.
 *
 * **Details**
 *
 * The handle manages only one fiber: running a new effect interrupts the
 * previous fiber unless `onlyIfMissing` is set. When the managed fiber
 * completes, it is removed from the handle.
 *
 * **Example** (Running an effect in a fiber handle)
 *
 * ```ts
 * import { Effect, Fiber, FiberHandle } from "effect"
 *
 * Effect.gen(function*() {
 *   const handle = yield* FiberHandle.make()
 *
 *   // Run an effect and get the fiber
 *   const fiber = yield* FiberHandle.run(handle, Effect.succeed("hello"))
 *   const result = yield* Fiber.await(fiber)
 *   console.log(result) // "hello"
 *
 *   // Running another effect will interrupt the previous one
 *   const fiber2 = yield* FiberHandle.run(handle, Effect.succeed("world"))
 *   const result2 = yield* Fiber.await(fiber2)
 *   console.log(result2) // "world"
 * })
 * ```
 *
 * @category combinators
 * @since 2.0.0
 */
export declare const run: {
    /**
     * Forks an Effect and stores the resulting fiber in the `FiberHandle`.
     *
     * **Details**
     *
     * The handle manages only one fiber: running a new effect interrupts the
     * previous fiber unless `onlyIfMissing` is set. When the managed fiber
     * completes, it is removed from the handle.
     *
     * **Example** (Running an effect in a fiber handle)
     *
     * ```ts
     * import { Effect, Fiber, FiberHandle } from "effect"
     *
     * Effect.gen(function*() {
     *   const handle = yield* FiberHandle.make()
     *
     *   // Run an effect and get the fiber
     *   const fiber = yield* FiberHandle.run(handle, Effect.succeed("hello"))
     *   const result = yield* Fiber.await(fiber)
     *   console.log(result) // "hello"
     *
     *   // Running another effect will interrupt the previous one
     *   const fiber2 = yield* FiberHandle.run(handle, Effect.succeed("world"))
     *   const result2 = yield* Fiber.await(fiber2)
     *   console.log(result2) // "world"
     * })
     * ```
     *
     * @category combinators
     * @since 2.0.0
     */
    <A, E>(self: FiberHandle<A, E>, options?: {
        readonly onlyIfMissing?: boolean;
        readonly propagateInterruption?: boolean | undefined;
        readonly startImmediately?: boolean | undefined;
    }): <R, XE extends E, XA extends A>(effect: Effect.Effect<XA, XE, R>) => Effect.Effect<Fiber.Fiber<XA, XE>, never, R>;
    /**
     * Forks an Effect and stores the resulting fiber in the `FiberHandle`.
     *
     * **Details**
     *
     * The handle manages only one fiber: running a new effect interrupts the
     * previous fiber unless `onlyIfMissing` is set. When the managed fiber
     * completes, it is removed from the handle.
     *
     * **Example** (Running an effect in a fiber handle)
     *
     * ```ts
     * import { Effect, Fiber, FiberHandle } from "effect"
     *
     * Effect.gen(function*() {
     *   const handle = yield* FiberHandle.make()
     *
     *   // Run an effect and get the fiber
     *   const fiber = yield* FiberHandle.run(handle, Effect.succeed("hello"))
     *   const result = yield* Fiber.await(fiber)
     *   console.log(result) // "hello"
     *
     *   // Running another effect will interrupt the previous one
     *   const fiber2 = yield* FiberHandle.run(handle, Effect.succeed("world"))
     *   const result2 = yield* Fiber.await(fiber2)
     *   console.log(result2) // "world"
     * })
     * ```
     *
     * @category combinators
     * @since 2.0.0
     */
    <A, E, R, XE extends E, XA extends A>(self: FiberHandle<A, E>, effect: Effect.Effect<XA, XE, R>, options?: {
        readonly onlyIfMissing?: boolean;
        readonly propagateInterruption?: boolean | undefined;
        readonly startImmediately?: boolean | undefined;
    }): Effect.Effect<Fiber.Fiber<XA, XE>, never, R>;
};
/**
 * Captures the current runtime and returns a function for forking effects into
 * an existing `FiberHandle`.
 *
 * **Details**
 *
 * Each call returns the forked fiber, stores it in the handle, and interrupts
 * the previous fiber unless `onlyIfMissing` is set.
 *
 * **Example** (Capturing a runtime for fiber handles)
 *
 * ```ts
 * import { Context, Effect, FiberHandle } from "effect"
 *
 * interface Users {
 *   readonly _: unique symbol
 * }
 * const Users = Context.Service<Users, {
 *   getAll: Effect.Effect<Array<unknown>>
 * }>("Users")
 *
 * Effect.gen(function*() {
 *   const handle = yield* FiberHandle.make()
 *   const run = yield* FiberHandle.runtime(handle)<Users>()
 *
 *   // run an effect and set the fiber in the handle
 *   run(Effect.andThen(Users, (_) => _.getAll))
 *
 *   // this will interrupt the previous fiber
 *   run(Effect.andThen(Users, (_) => _.getAll))
 * }).pipe(
 *   Effect.scoped // The fiber will be interrupted when the scope is closed
 * )
 * ```
 *
 * @category combinators
 * @since 2.0.0
 */
export declare const runtime: <A, E>(self: FiberHandle<A, E>) => <R = never>() => Effect.Effect<(<XE extends E, XA extends A>(effect: Effect.Effect<XA, XE, R>, options?: {
    readonly signal?: AbortSignal | undefined;
    readonly scheduler?: Scheduler | undefined;
    readonly onlyIfMissing?: boolean | undefined;
    readonly propagateInterruption?: boolean | undefined;
} | undefined) => Fiber.Fiber<XA, XE>), never, R>;
/**
 * Captures the current runtime and returns a function for running effects in
 * an existing `FiberHandle` as Promises.
 *
 * **Details**
 *
 * Each call stores the forked fiber in the handle and interrupts the previous
 * fiber unless `onlyIfMissing` is set. The Promise resolves with the effect's
 * success value or rejects with the squashed failure cause.
 *
 * **Example** (Capturing a runtime for promises)
 *
 * ```ts
 * import { Effect, FiberHandle } from "effect"
 *
 * Effect.gen(function*() {
 *   const handle = yield* FiberHandle.make()
 *   const runPromise = yield* FiberHandle.runtimePromise(handle)<never>()
 *
 *   // Run an effect and get a promise
 *   const promise = runPromise(Effect.succeed("hello"))
 *   const result = yield* Effect.promise(() => promise)
 *   console.log(result) // "hello"
 * })
 * ```
 *
 * @category combinators
 * @since 3.13.0
 */
export declare const runtimePromise: <A, E>(self: FiberHandle<A, E>) => <R = never>() => Effect.Effect<(<XE extends E, XA extends A>(effect: Effect.Effect<XA, XE, R>, options?: {
    readonly signal?: AbortSignal | undefined;
    readonly scheduler?: Scheduler | undefined;
    readonly onlyIfMissing?: boolean | undefined;
    readonly propagateInterruption?: boolean | undefined;
} | undefined) => Promise<XA>), never, R>;
/**
 * Waits for the `FiberHandle` to fail or close.
 *
 * **Details**
 *
 * The returned Effect fails with the first managed fiber failure that is not
 * ignored by the handle's interruption rules. Normal successful completion of
 * a managed fiber only removes it from the handle; use `awaitEmpty` to wait
 * for the current fiber to finish.
 *
 * **Example** (Propagating fiber failures)
 *
 * ```ts
 * import { Effect, FiberHandle } from "effect"
 *
 * Effect.gen(function*() {
 *   const handle = yield* FiberHandle.make()
 *   yield* FiberHandle.set(handle, Effect.runFork(Effect.fail("error")))
 *
 *   // parent fiber will fail with "error"
 *   yield* FiberHandle.join(handle)
 * })
 * ```
 *
 * @category combinators
 * @since 2.0.0
 */
export declare const join: <A, E>(self: FiberHandle<A, E>) => Effect.Effect<void, E>;
/**
 * Waits for the fiber in the FiberHandle to complete.
 *
 * **Example** (Waiting for a fiber to complete)
 *
 * ```ts
 * import { Effect, FiberHandle } from "effect"
 *
 * Effect.gen(function*() {
 *   const handle = yield* FiberHandle.make()
 *
 *   // Start a long-running effect
 *   yield* FiberHandle.run(handle, Effect.sleep(1000))
 *
 *   // Wait for the fiber to complete
 *   yield* FiberHandle.awaitEmpty(handle)
 *
 *   console.log("Fiber completed")
 * })
 * ```
 *
 * @category combinators
 * @since 3.13.0
 */
export declare const awaitEmpty: <A, E>(self: FiberHandle<A, E>) => Effect.Effect<void, E>;
export {};
//# sourceMappingURL=FiberHandle.d.ts.map