better-effect 0.7.0 → 0.9.1

package/dist/index-yOfq7LKL.d.mts

@@ -0,0 +1,406 @@
+import { A as ProgramFromGenerator, C as EffectError, D as EffectYield, E as EffectSuccess, M as AnyService, S as Effect$1, T as EffectRequirements, f as DisposableResource, h as ScopeOutcome, k as Program$1, p as MaybePromise$1, w as EffectFromGenerator, x as AnyEffect } from "./index-BFgG9zZC.mjs";
+import { C as ProvidedEnvironment, _ as Layer, a as RuntimeShutdownDiagnostic, b as CompleteInput, i as RuntimeRunOptions, n as RuntimeDisposeOptions, r as RuntimeOptions, v as CompleteExecution, x as LayerInput, y as CompleteExecutionLayer } from "./index-BSRPIYII.mjs";
+import { n as LayerBackend } from "./map-layer-backend-CGibcwkc.mjs";
+import { Err, Result, UnhandledException } from "better-result";
+//#region src/effect/combinators.d.ts
+type EffectInput<A, E> = Result<A, E> | PromiseLike<Result<A, E>>;
+type AnyEffectInput = EffectInput<any, any>;
+type AnyEffectValue = Result<any, any>;
+type AnyAsyncEffectInput = PromiseLike<Result<any, any>>;
+type PreserveAsync<Input, Output> = Input extends PromiseLike<unknown> ? Promise<Output> : Output;
+type MappedResult<Input, B> = Effect$1<B, EffectError<Input>, EffectRequirements<Input>>;
+type ErrorMappedResult<Input, E2> = Effect$1<EffectSuccess<Input>, E2, EffectRequirements<Input>>;
+type ChainedResult<First, Next> = Effect$1<EffectSuccess<Next>, EffectError<First> | EffectError<Next>, EffectRequirements<First> | EffectRequirements<Next>>;
+type ChainedOutput<First, Next> = ChainedResult<First, Next>;
+type AsyncChainedOutput<First, Next> = Promise<ChainedResult<First, Next>>;
+type MapOperation<A, B> = {
+  <Input>(effect: Input & EffectInput<A, any>): PreserveAsync<Input, MappedResult<Input, B>>;
+};
+type MapErrorOperation<E1, E2> = {
+  <Input>(effect: Input & EffectInput<any, E1>): PreserveAsync<Input, ErrorMappedResult<Input, E2>>;
+};
+type AndThenOperation<Next> = {
+  <Input>(effect: Input & AnyEffectValue): ChainedOutput<Input, Next>;
+};
+type AndThenAsyncOperation<A, Next> = {
+  <Input>(effect: Input & EffectInput<A, any>): AsyncChainedOutput<Input, Next>;
+};
+type TappedResult<Input> = Effect$1<EffectSuccess<Input>, EffectError<Input>, EffectRequirements<Input>>;
+type RecoveredResult<Input, Next> = Effect$1<EffectSuccess<Input> | EffectSuccess<Next>, EffectError<Next>, EffectRequirements<Input> | EffectRequirements<Next>>;
+type FlattenedResult<Input> = Effect$1<EffectSuccess<EffectSuccess<Input>>, EffectError<Input> | EffectError<EffectSuccess<Input>>, EffectRequirements<Input> | EffectRequirements<EffectSuccess<Input>>>;
+type AsResult<Input, Value> = Effect$1<Value, EffectError<Input>, EffectRequirements<Input>>;
+type MatchedResult<Input, OkResult, ErrResult> = Effect$1<EffectSuccess<OkResult> | EffectSuccess<ErrResult>, EffectError<OkResult> | EffectError<ErrResult>, EffectRequirements<Input> | EffectRequirements<OkResult> | EffectRequirements<ErrResult>>;
+type AllResult<Results extends readonly AnyEffectValue[]> = Effect$1<{ -readonly [Index in keyof Results]: EffectSuccess<Results[Index]>; }, EffectError<Results[number]>, EffectRequirements<Results[number]>>;
+type ZipResult<Left, Right> = Effect$1<[EffectSuccess<Left>, EffectSuccess<Right>], EffectError<Left> | EffectError<Right>, EffectRequirements<Left> | EffectRequirements<Right>>;
+type TapOperation = {
+  <Input>(effect: Input & AnyEffectInput, fn: (value: EffectSuccess<Input>) => void): PreserveAsync<Input, TappedResult<Input>>;
+};
+type TapErrorOperation = {
+  <Input>(effect: Input & AnyEffectInput, fn: (error: EffectError<Input>) => void): PreserveAsync<Input, TappedResult<Input>>;
+};
+type TapBothOperation = {
+  <Input>(effect: Input & AnyEffectInput, handlers: {
+    ok: (value: EffectSuccess<Input>) => void;
+    err: (error: EffectError<Input>) => void;
+  }): PreserveAsync<Input, TappedResult<Input>>;
+};
+type RecoverOperation<Next> = {
+  <Input>(effect: Input & AnyEffectInput, fn: (error: EffectError<Input>) => Next): PreserveAsync<Input, RecoveredResult<Input, Next>>;
+};
+type RecoverAsyncOperation<Next> = {
+  <Input>(effect: Input & AnyEffectInput, fn: (error: EffectError<Input>) => Next): Promise<RecoveredResult<Input, Next>>;
+};
+/**
+ * Map the successful value of a Result or Effect result.
+ *
+ * Supports both data-first and data-last forms and preserves asynchronous
+ * results and declaration-only Service requirements.
+ *
+ * @example
+ * ```ts
+ * const doubled = Effect.map(Result.ok(2), (value) => value * 2)
+ * const toLabel = Effect.map((value: number) => `#${value}`)
+ * ```
+ */
+declare function map<A, B>(fn: (value: A) => B): MapOperation<A, B>;
+declare function map<Input, B>(effect: Input & AnyEffectInput, fn: (value: EffectSuccess<Input>) => B): PreserveAsync<Input, MappedResult<Input, B>>;
+/**
+ * Map the error value of a Result or Effect result while preserving its
+ * successful value, asynchronous shape, and declaration-only Service requirements.
+ *
+ * @example
+ * ```ts
+ * const labelled = Effect.mapError(Result.err('missing'), (error) => ({ error }))
+ * ```
+ */
+declare function mapError<E1, E2>(fn: (error: E1) => E2): MapErrorOperation<E1, E2>;
+declare function mapError<Input, E2>(effect: Input & AnyEffectInput, fn: (error: EffectError<Input>) => E2): PreserveAsync<Input, ErrorMappedResult<Input, E2>>;
+/**
+ * Chain a synchronous Result-producing operation after a successful result.
+ *
+ * The next operation is skipped when the input is an error. Both error types
+ * and both sets of Service requirements are preserved in the output.
+ *
+ * @example
+ * ```ts
+ * const user = Effect.andThen(Result.ok('u1'), (id) => repository.find(id))
+ * ```
+ */
+declare function andThen<A, Next extends AnyEffectValue>(next: (value: A) => Next): AndThenOperation<Next>;
+declare function andThen<Input, Next extends AnyEffectValue>(effect: Input & AnyEffectValue, next: (value: EffectSuccess<Input>) => Next): ChainedOutput<Input, Next>;
+/**
+ * Chain an asynchronous Result-producing operation after a successful result.
+ *
+ * The returned value is always a Promise and retains both operations' error
+ * and Service-requirement metadata.
+ *
+ * @example
+ * ```ts
+ * const user = Effect.andThenAsync(loadUser(), (user) => fetchProfile(user.id))
+ * ```
+ */
+declare function andThenAsync<A, Next extends AnyAsyncEffectInput>(next: (value: A) => Next): AndThenAsyncOperation<A, Next>;
+declare function andThenAsync<Input, Next extends AnyAsyncEffectInput>(effect: Input & AnyEffectInput, next: (value: EffectSuccess<Input>) => Next): AsyncChainedOutput<Input, Next>;
+/** Observe a successful value without changing the Result. */
+declare function tap(fn: (value: any) => void): TapOperation;
+declare function tap<Input>(effect: Input & AnyEffectInput, fn: (value: EffectSuccess<Input>) => void): PreserveAsync<Input, TappedResult<Input>>;
+/** Observe an error value without changing the Result. */
+declare function tapError(fn: (error: any) => void): TapErrorOperation;
+declare function tapError<Input>(effect: Input & AnyEffectInput, fn: (error: EffectError<Input>) => void): PreserveAsync<Input, TappedResult<Input>>;
+/** Observe whichever Result branch is active without changing the Result. */
+declare function tapBoth(handlers: {
+  ok: (value: any) => void;
+  err: (error: any) => void;
+}): TapBothOperation;
+declare function tapBoth<Input>(effect: Input & AnyEffectInput, handlers: {
+  ok: (value: EffectSuccess<Input>) => void;
+  err: (error: EffectError<Input>) => void;
+}): PreserveAsync<Input, TappedResult<Input>>;
+/** Recover an Err with a synchronous Result-producing callback. */
+declare function recover<Next extends AnyEffectValue>(fn: (error: any) => Next): RecoverOperation<Next>;
+declare function recover<Input, Next extends AnyEffectValue>(effect: Input & AnyEffectInput, fn: (error: EffectError<Input>) => Next): PreserveAsync<Input, RecoveredResult<Input, Next>>;
+/** Recover an Err with an asynchronous Result-producing callback. */
+declare function recoverAsync<Next extends AnyAsyncEffectInput>(fn: (error: any) => Next): RecoverAsyncOperation<Next>;
+declare function recoverAsync<Input, Next extends AnyAsyncEffectInput>(effect: Input & AnyEffectInput, fn: (error: EffectError<Input>) => Next): Promise<RecoveredResult<Input, Next>>;
+/** Remove one nested Result/Effect layer. */
+declare function flatten<Input>(effect: Input & AnyEffectValue): FlattenedResult<Input>;
+/** Replace a successful value while preserving errors and requirements. */
+declare function as<Value>(value: Value): <Input>(effect: Input & AnyEffectValue) => AsResult<Input, Value>;
+declare function as<Input, Value>(effect: Input & AnyEffectValue, value: Value): AsResult<Input, Value>;
+/** Replace a successful value with void. */
+declare function asVoid<Input>(effect: Input & AnyEffectValue): AsResult<Input, void>;
+/** Match an Effect and return branch Effects with their channels unioned. */
+declare function match<Input, OkResult extends AnyEffectValue, ErrResult extends AnyEffectValue>(effect: Input & AnyEffectValue, handlers: {
+  ok: (value: EffectSuccess<Input>) => OkResult;
+  err: (error: EffectError<Input>) => ErrResult;
+}): PreserveAsync<Input, MatchedResult<Input, OkResult, ErrResult>>;
+declare function match<Input, OkValue, ErrValue>(effect: Input & AnyEffectValue, handlers: {
+  ok: (value: EffectSuccess<Input>) => OkValue;
+  err: (error: EffectError<Input>) => ErrValue;
+}): PreserveAsync<Input, OkValue | ErrValue>;
+/** Collect already-created Effects in input order. */
+declare function all<const Results extends readonly AnyEffectValue[]>(results: Results): AllResult<Results>;
+/** Combine two already-created Effects in input order. */
+declare function zip<Left, Right>(left: Left & AnyEffectValue, right: Right & AnyEffectValue): ZipResult<Left, Right>;
+//#endregion
+//#region src/effect/effect.d.ts
+type Effect<A, E, R extends AnyService = never> = Effect$1<A, E, R>;
+type LazyProgram<A, E, R extends AnyService = never> = Program$1<A, E, R>;
+/** A nominal lazy computation that produces an Effect when invoked. */
+type Program<A, E, R extends AnyService = never> = LazyProgram<A, E, R>;
+type AnyResult = Result<any, any>;
+type AnyProgram = Program$1<any, any, AnyService>;
+type ProgramAllSuccess<Programs extends readonly AnyProgram[]> = { -readonly [Index in keyof Programs]: EffectSuccess<Programs[Index]>; };
+type ProgramAllError<Programs extends readonly AnyProgram[]> = EffectError<Programs[number]>;
+type ProgramAllRequirements<Programs extends readonly AnyProgram[]> = EffectRequirements<Programs[number]>;
+type ProgramAllResult<Programs extends readonly AnyProgram[]> = Program$1<ProgramAllSuccess<Programs>, ProgramAllError<Programs>, ProgramAllRequirements<Programs>>;
+type ProgramAllOptions = {
+  readonly concurrency?: number;
+};
+/**
+ * Compose `better-result` operations while preserving Service requirements in
+ * a declaration-only type channel.
+ *
+ * A generator may yield Service tokens and Result operations. It must return a
+ * `Result` as its final value; Service yields are resolved by the active
+ * Runtime and do not add runtime values to the Result stream.
+ * Use `fn` when generator execution should wait for a Runtime boundary.
+ *
+ * @example
+ * ```ts
+ * const loadUser = Effect.gen(async function* () {
+ *   const database = yield* Database
+ *   const user = yield* Result.await(database.findUser('u1'))
+ *
+ *   return Result.ok(user)
+ * })
+ * ```
+ */
+declare function gen<Yield extends EffectYield, Returned extends AnyResult>(body: () => Generator<Yield, Returned, unknown>): EffectFromGenerator<Yield, Returned>;
+declare function gen<Yield extends EffectYield, Returned extends AnyResult>(body: () => AsyncGenerator<Yield, Returned, unknown>): Promise<EffectFromGenerator<Yield, Returned>>;
+/** Build a lazy Program without running its generator. */
+declare function fn<Yield extends EffectYield, Returned extends AnyResult>(body: () => Generator<Yield, Returned, unknown>): ProgramFromGenerator<Yield, Returned>;
+declare function fn<Yield extends EffectYield, Returned extends AnyResult>(body: () => AsyncGenerator<Yield, Returned, unknown>): ProgramFromGenerator<Yield, Returned>;
+/** Build a lazy Program collection with optional bounded concurrency. */
+declare function programAll<const Programs extends readonly AnyProgram[]>(programs: Programs, options?: ProgramAllOptions): ProgramAllResult<Programs>;
+/** Value-level namespace for lazy Program combinators. */
+declare const Program: {
+  readonly all: typeof programAll;
+};
+/**
+ * Acquire a resource in the current Scope and register its release callback.
+ *
+ * Acquisition failures are represented in the Effect Result error channel;
+ * release failures remain owned by Scope cleanup. The release callback
+ * receives the final outcome chosen by the enclosing execution boundary.
+ *
+ * @example
+ * ```ts
+ * const connection = yield* Effect.acquireRelease(
+ *   () => pool.connect(),
+ *   (connection, outcome) => connection.close(outcome)
+ * )
+ * ```
+ */
+declare function acquireRelease<R>(acquire: () => MaybePromise$1<R>, release: (resource: R, outcome: ScopeOutcome) => MaybePromise$1<void>): AsyncGenerator<Err<never, UnhandledException>, R, unknown>;
+/**
+ * Register an already-acquired disposable resource in the current Scope.
+ *
+ * The resource is not acquired by this helper. Registration failures are
+ * represented in the Effect Result error channel; disposal failures remain
+ * owned by Scope cleanup.
+ *
+ * @example
+ * ```ts
+ * const file = yield* Effect.add(await openFile('notes.txt'))
+ * ```
+ */
+declare function add<R extends DisposableResource>(resource: R): AsyncGenerator<Err<never, UnhandledException>, R, unknown>;
+/**
+ * Effect namespace containing generator, resource, and Result combinators.
+ *
+ * Prefer these helpers when a program needs typed Service requirements or
+ * Scope-aware acquisition and cleanup.
+ */
+type EffectNamespace = {
+  readonly gen: typeof gen;
+  readonly fn: typeof fn;
+  readonly acquireRelease: typeof acquireRelease;
+  readonly add: typeof add;
+  readonly map: typeof map;
+  readonly mapError: typeof mapError;
+  readonly andThen: typeof andThen;
+  readonly andThenAsync: typeof andThenAsync;
+  readonly tap: typeof tap;
+  readonly tapError: typeof tapError;
+  readonly tapBoth: typeof tapBoth;
+  readonly recover: typeof recover;
+  readonly recoverAsync: typeof recoverAsync;
+  readonly flatten: typeof flatten;
+  readonly as: typeof as;
+  readonly asVoid: typeof asVoid;
+  readonly match: typeof match;
+  readonly all: typeof all;
+  readonly zip: typeof zip;
+};
+declare const Effect: EffectNamespace;
+/** Type-level aliases for inspecting Effect result channels and requirements. */
+declare namespace Effect {
+  /** A nominal lazy computation that produces an Effect when invoked. */
+  type Program<A, E, R extends AnyService = never> = LazyProgram<A, E, R>;
+  /** Extract the success channel from an Effect result or Promise. */
+  type Success<T> = EffectSuccess<T>;
+  /** Extract the error channel from an Effect result or Promise. */
+  type Error<T> = EffectError<T>;
+  /** Extract the Service requirements from an Effect result or Promise. */
+  type Requirements<T> = EffectRequirements<T>;
+  /** An Effect with erased success, error, and requirements. */
+  type Any = AnyEffect;
+}
+//#endregion
+//#region src/function/pipe.d.ts
+type Unary<A, B> = (value: A) => B;
+declare function pipe<A>(value: A): A;
+declare function pipe<A, B>(value: A, ab: Unary<A, B>): B;
+declare function pipe<A, B, C>(value: A, ab: Unary<A, B>, bc: Unary<B, C>): C;
+declare function pipe<A, B, C, D>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>): D;
+declare function pipe<A, B, C, D, E>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>): E;
+declare function pipe<A, B, C, D, E, F>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>, ef: Unary<E, F>): F;
+declare function pipe<A, B, C, D, E, F, G>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>, ef: Unary<E, F>, fg: Unary<F, G>): G;
+declare function pipe<A, B, C, D, E, F, G, H>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>, ef: Unary<E, F>, fg: Unary<F, G>, gh: Unary<G, H>): H;
+declare function pipe<A, B, C, D, E, F, G, H, I>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>, ef: Unary<E, F>, fg: Unary<F, G>, gh: Unary<G, H>, hi: Unary<H, I>): I;
+declare function pipe<A, B, C, D, E, F, G, H, I, J>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>, ef: Unary<E, F>, fg: Unary<F, G>, gh: Unary<G, H>, hi: Unary<H, I>, ij: Unary<I, J>): J;
+declare function pipe<A, B, C, D, E, F, G, H, I, J, K>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>, ef: Unary<E, F>, fg: Unary<F, G>, gh: Unary<G, H>, hi: Unary<H, I>, ij: Unary<I, J>, jk: Unary<J, K>): K;
+//#endregion
+//#region src/resource/errors.d.ts
+declare const ResourceReleaseFailure_base: import("better-result").TaggedErrorClass<"ResourceReleaseFailure">;
+/** Describes a failure encountered while releasing a Resource. */
+declare class ResourceReleaseFailure extends ResourceReleaseFailure_base<{
+  readonly resource: string;
+  readonly cause: unknown;
+  readonly message: string;
+}> {}
+//#endregion
+//#region src/resource/types.d.ts
+/** A value that may be delivered synchronously or through a thenable. */
+type MaybePromise<T> = T | PromiseLike<T>;
+/** A synchronous or asynchronous better-result Result operation. */
+type AsyncResult<T, E> = MaybePromise<Result<T, E>>;
+/** The allowed return value of a custom Resource release callback. */
+type ReleaseOutcome = void | Result<void, unknown>;
+/** Receives release failures for diagnostics without changing error precedence. */
+type ReleaseFailureObserver = (failure: ResourceReleaseFailure) => MaybePromise<void>;
+/** Options controlling `Resource.acquireUseRelease`. */
+type AcquireUseReleaseOptions<R, A, AcquireError, UseError> = {
+  /** Human-readable name included in release failures. */
+  readonly name: string;
+  /** Acquire the resource. A failure skips use and release. */
+  readonly acquire: () => AsyncResult<R, AcquireError>;
+  /** Use the acquired resource. Release is attempted afterward. */
+  readonly use: (resource: R) => AsyncResult<A, UseError>;
+  /** Release the resource, or omit it to use its disposal protocol. */
+  readonly release?: (resource: R) => MaybePromise<ReleaseOutcome>;
+  /**
+   * Observe cleanup failures without changing error precedence. This is most
+   * useful when both `use` and `release` can fail.
+   */
+  readonly onReleaseFailure?: ReleaseFailureObserver;
+};
+//#endregion
+//#region src/resource/resource.d.ts
+declare const Resource: {
+  /** Acquire, use, and release a resource with deterministic error precedence. */
+  readonly acquireUseRelease: <R, A, AcquireError, UseError>({ name, acquire, use, release, onReleaseFailure }: AcquireUseReleaseOptions<R, A, AcquireError, UseError>) => Promise<Result<A, AcquireError | UseError | UnhandledException | ResourceReleaseFailure>>;
+};
+//#endregion
+//#region src/runtime/types.d.ts
+/**
+ * Name a Runtime type from a concrete Layer without repeating its provided
+ * branded Service instance union.
+ *
+ * @example
+ * ```ts
+ * type AppRuntime = RuntimeFor<typeof AppLive>
+ * ```
+ */
+type RuntimeFor<L extends LayerInput> = Runtime<Layer.Provided<L>>;
+//#endregion
+//#region src/runtime/runtime.d.ts
+/**
+ * Long-lived execution environment backed by a complete Layer.
+ *
+ * A Runtime owns Layer resources until `dispose()` is called. Each `run()` is
+ * isolated in a child Scope, while Layer-scoped resources remain shared.
+ *
+ * @example
+ * ```ts
+ * const runtime = await Runtime.make(AppLive)
+ * const result = await runtime.run(loadUser('u1'))
+ * await runtime.dispose()
+ * ```
+ *
+ * @typeParam Provided The branded Service instances supplied by the Layer.
+ */
+declare class Runtime<Provided extends AnyService = any> {
+  private readonly handle;
+  private constructor();
+  /**
+   * Create a long-lived Runtime that owns its Layer resources.
+   *
+   * @example
+   * ```ts
+   * const runtime = await Runtime.make(AppLive)
+   * const result = await runtime.run(program)
+   * await runtime.dispose()
+   * ```
+   */
+  static make<L extends LayerInput>(layer: L & CompleteInput<L>, backend: LayerBackend, options?: RuntimeOptions): Promise<Runtime<ProvidedEnvironment<L>>>;
+  static make<L extends LayerInput>(layer: L & CompleteInput<L>, options?: RuntimeOptions): Promise<Runtime<ProvidedEnvironment<L>>>;
+  /**
+   * Run one program and dispose its Layer resources before resolving.
+   *
+   * This is convenient for request-style or command-style execution where a
+   * Runtime should not outlive the operation.
+   */
+  static run<A, L extends LayerInput>(layer: L & CompleteInput<L>, backend: LayerBackend, program: CompleteExecution<ProvidedEnvironment<L>, A>, options?: RuntimeOptions): Promise<Awaited<A>>;
+  static run<A, L extends LayerInput>(layer: L & CompleteInput<L>, program: CompleteExecution<ProvidedEnvironment<L>, A>, options?: RuntimeOptions): Promise<Awaited<A>>;
+  static run<A, L extends LayerInput>(layer: L & CompleteInput<L>, options: RuntimeOptions, program: CompleteExecution<ProvidedEnvironment<L>, A>): Promise<Awaited<A>>;
+  /** Run a callback with a managed Runtime and always dispose it afterward. */
+  static use<A, L extends LayerInput>(layer: L & CompleteInput<L>, use: (runtime: Runtime<ProvidedEnvironment<L>>) => A | PromiseLike<A>, options?: RuntimeOptions): Promise<Awaited<A>>;
+  /** Resolve every Layer provider and dispose the Runtime if warmup fails. */
+  warmup(): Promise<void>;
+  /** Run one execution in this Runtime's child Scope. */
+  run<A>(program: CompleteExecution<Provided, A>, options?: RuntimeRunOptions): Promise<Awaited<A>>;
+  /** Run one execution with a Layer owned by that execution's child Scope. */
+  runWith<Request extends LayerInput, A>(layer: Request & CompleteExecutionLayer<Provided, Request>, program: CompleteExecution<Provided | ProvidedEnvironment<Request>, A>, options?: RuntimeRunOptions): Promise<Awaited<A>>;
+  private runUnchecked;
+  /** Stop new executions and release the Runtime's Layer resources. */
+  dispose(options?: RuntimeDisposeOptions): Promise<void>;
+  /** @deprecated Scope outcomes are kept for internal compatibility. */
+  dispose(outcome: ScopeOutcome): Promise<void>;
+  /** Release Runtime-owned resources through JavaScript's async disposal protocol. */
+  [Symbol.asyncDispose](): Promise<void>;
+  private disposeWithOutcome;
+}
+/** Type-level aliases for naming Runtime handles and shutdown options. */
+declare namespace Runtime {
+  /** Name a Runtime type from a concrete Layer. */
+  type For<L extends LayerInput> = RuntimeFor<L>;
+  /** Optional Runtime shutdown configuration. */
+  type Options = RuntimeOptions;
+  /** Optional signal supplied to one managed Runtime execution. */
+  type RunOptions = RuntimeRunOptions;
+  /** Cooperative shutdown policy for a managed Runtime. */
+  type DisposeOptions = RuntimeDisposeOptions;
+  /** Diagnostic reported for aggregated Runtime shutdown cleanup failures. */
+  type ShutdownDiagnostic = RuntimeShutdownDiagnostic;
+}
+//#endregion
+//#region src/runtime/signal.d.ts
+/** Yieldable access to the signal of the current Runtime execution. */
+declare const CurrentAbortSignal: {
+  readonly [Symbol.iterator]: () => Generator<never, AbortSignal, unknown>;
+};
+//#endregion
+export { AcquireUseReleaseOptions as a, ReleaseOutcome as c, Effect as d, Program as f, Resource as i, ResourceReleaseFailure as l, Runtime as n, AsyncResult as o, ProgramAllOptions as p, RuntimeFor as r, ReleaseFailureObserver as s, CurrentAbortSignal as t, pipe as u };
+//# sourceMappingURL=index-yOfq7LKL.d.mts.map

package/dist/index-yOfq7LKL.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-yOfq7LKL.d.mts","names":[],"sources":["../src/effect/combinators.ts","../src/effect/effect.ts","../src/function/pipe.ts","../src/resource/errors.ts","../src/resource/types.ts","../src/resource/resource.ts","../src/runtime/types.ts","../src/runtime/runtime.ts","../src/runtime/signal.ts"],"mappings":"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"}