effect 4.0.0-beta.67 → 4.0.0-beta.68

package/dist/Effect.d.ts

@@ -103,14 +103,14 @@ import type * as Unify from "./Unify.ts";
  * Type-level identifier for `Effect` values.
  *
  * @category Type identifiers
- * @since 2.0.0
+ * @since 4.0.0
  */
 export type TypeId = "~effect/Effect";
 /**
  * Runtime identifier used to recognize `Effect` values.
  *
  * @category Type identifiers
- * @since 2.0.0
+ * @since 4.0.0
  */
 export declare const TypeId: TypeId;
 /**
@@ -127,7 +127,7 @@ export declare const TypeId: TypeId;
  * To run an `Effect` value, you need a `Runtime`, which is a type that is
  * capable of executing `Effect` values.
  *
- * @category Models
+ * @category models
  * @since 2.0.0
  */
 export interface Effect<out A, out E = never, out R = never> extends Pipeable, Inspectable {
@@ -140,7 +140,7 @@ export interface Effect<out A, out E = never, out R = never> extends Pipeable, I
 /**
  * Type-level unification support for `Effect` values.
  *
- * @category Models
+ * @category models
  * @since 2.0.0
  */
 export interface EffectUnify<A extends {
@@ -160,7 +160,7 @@ export interface EffectTypeLambda extends TypeLambda {
 /**
  * Variance interface for Effect, encoding the type parameters' variance.
  *
- * @category Models
+ * @category models
  * @since 2.0.0
  */
 export interface Variance<A, E, R> {
@@ -171,22 +171,22 @@ export interface Variance<A, E, R> {
 /**
  * Extracts the success type from an `Effect`.
  *
- * @category Models
+ * @category models
  * @since 2.0.0
  */
 export type Success<T> = T extends Effect<infer _A, infer _E, infer _R> ? _A : never;
 /**
  * Extracts the error type from an `Effect`.
  *
- * @category Models
+ * @category models
  * @since 2.0.0
  */
 export type Error<T> = T extends Effect<infer _A, infer _E, infer _R> ? _E : never;
 /**
  * Extracts the required services type from an `Effect`.
  *
- * @category Models
- * @since 2.0.0
+ * @category models
+ * @since 4.0.0
  */
 export type Services<T> = T extends Effect<infer _A, infer _E, infer _R> ? _R : never;
 /**
@@ -201,15 +201,15 @@ export type Services<T> = T extends Effect<infer _A, infer _E, infer _R> ? _R :
  * console.log(Effect.isEffect("hello")) // false
  * ```
  *
- * @category Guards
+ * @category guards
  * @since 2.0.0
  */
 export declare const isEffect: (u: unknown) => u is Effect<any, any, any>;
 /**
  * Iterator interface for Effect generators, enabling Effect values to work with generator functions.
  *
- * @category Models
- * @since 2.0.0
+ * @category models
+ * @since 4.0.0
  */
 export interface EffectIterator<T extends Effect<any, any, any>> {
     next(...args: ReadonlyArray<any>): IteratorResult<T, Success<T>>;
@@ -218,28 +218,27 @@ export interface EffectIterator<T extends Effect<any, any, any>> {
  * Namespace containing type utilities for the `Effect.all` function, which handles
  * collecting multiple effects into various output structures.
  *
- * @category Models
  * @since 2.0.0
  */
 export declare namespace All {
     /**
      * Alias for any `Effect` value accepted by `Effect.all`.
      *
-     * @category Models
+     * @category models
      * @since 2.0.0
      */
     type EffectAny = Effect<any, any, any>;
     /**
      * Computes the return type for `Effect.all` when collecting an iterable.
      *
-     * @category Models
+     * @category models
      * @since 2.0.0
      */
     type ReturnIterable<T extends Iterable<EffectAny>, Discard extends boolean, Mode extends boolean = false> = [T] extends [Iterable<Effect<infer A, infer E, infer R>>] ? Effect<Discard extends true ? void : Array<Mode extends true ? Result.Result<A, E> : A>, Mode extends true ? never : E, R> : never;
     /**
      * Computes the return type for `Effect.all` when collecting a tuple.
      *
-     * @category Models
+     * @category models
      * @since 2.0.0
      */
     type ReturnTuple<T extends ReadonlyArray<unknown>, Discard extends boolean, Mode extends boolean = false> = Effect<Discard extends true ? void : T[number] extends never ? [] : {
@@ -248,7 +247,7 @@ export declare namespace All {
     /**
      * Computes the return type for `Effect.all` when collecting a record.
      *
-     * @category Models
+     * @category models
      * @since 2.0.0
      */
     type ReturnObject<T, Discard extends boolean, Mode extends boolean = false> = [T] extends [
@@ -261,7 +260,7 @@ export declare namespace All {
     /**
      * Detects whether `Effect.all` should discard collected values.
      *
-     * @category Models
+     * @category models
      * @since 2.0.0
      */
     type IsDiscard<A> = [Extract<A, {
@@ -272,7 +271,7 @@ export declare namespace All {
     /**
      * Detects whether `Effect.all` should collect results in `Result` mode.
      *
-     * @category Models
+     * @category models
      * @since 4.0.0
      */
     type IsResult<A> = [Extract<A, {
@@ -281,7 +280,7 @@ export declare namespace All {
     /**
      * Computes the return type for `Effect.all` from its input and options.
      *
-     * @category Models
+     * @category models
      * @since 2.0.0
      */
     type Return<Arg extends Iterable<EffectAny> | Record<string, EffectAny>, O extends {
@@ -450,7 +449,7 @@ export declare const all: <const Arg extends Iterable<Effect<any, any, any>> | R
  * ```
  *
  * @category Collecting
- * @since 3.0.0
+ * @since 2.0.0
  */
 export declare const partition: {
     /**
@@ -479,7 +478,7 @@ export declare const partition: {
      * ```
      *
      * @category Collecting
-     * @since 3.0.0
+     * @since 2.0.0
      */
     <A, B, E, R>(f: (a: A, i: number) => Effect<B, E, R>, options?: {
         readonly concurrency?: Concurrency | undefined;
@@ -510,7 +509,7 @@ export declare const partition: {
      * ```
      *
      * @category Collecting
-     * @since 3.0.0
+     * @since 2.0.0
      */
     <A, B, E, R>(elements: Iterable<A>, f: (a: A, i: number) => Effect<B, E, R>, options?: {
         readonly concurrency?: Concurrency | undefined;
@@ -550,7 +549,7 @@ export declare const partition: {
  * ```
  *
  * @category Error Accumulation
- * @since 4.0.0
+ * @since 2.0.0
  */
 export declare const validate: {
     /**
@@ -587,7 +586,7 @@ export declare const validate: {
      * ```
      *
      * @category Error Accumulation
-     * @since 4.0.0
+     * @since 2.0.0
      */
     <A, B, E, R>(f: (a: A, i: number) => Effect<B, E, R>, options?: {
         readonly concurrency?: Concurrency | undefined;
@@ -627,7 +626,7 @@ export declare const validate: {
      * ```
      *
      * @category Error Accumulation
-     * @since 4.0.0
+     * @since 2.0.0
      */
     <A, B, E, R>(f: (a: A, i: number) => Effect<B, E, R>, options: {
         readonly concurrency?: Concurrency | undefined;
@@ -667,7 +666,7 @@ export declare const validate: {
      * ```
      *
      * @category Error Accumulation
-     * @since 4.0.0
+     * @since 2.0.0
      */
     <A, B, E, R>(elements: Iterable<A>, f: (a: A, i: number) => Effect<B, E, R>, options?: {
         readonly concurrency?: Concurrency | undefined;
@@ -707,7 +706,7 @@ export declare const validate: {
      * ```
      *
      * @category Error Accumulation
-     * @since 4.0.0
+     * @since 2.0.0
      */
     <A, B, E, R>(elements: Iterable<A>, f: (a: A, i: number) => Effect<B, E, R>, options: {
         readonly concurrency?: Concurrency | undefined;
@@ -835,8 +834,7 @@ export declare const findFirstFilter: {
  * **Example** (Applying Effects to Iterable Elements)
  *
  * ```ts
- * import { Effect } from "effect"
- * import { Console } from "effect"
+ * import { Console, Effect } from "effect"
  *
  * const result = Effect.forEach(
  *   [1, 2, 3, 4, 5],
@@ -857,8 +855,7 @@ export declare const findFirstFilter: {
  * **Example** (Using discard to Ignore Results)
  *
  * ```ts
- * import { Effect } from "effect"
- * import { Console } from "effect"
+ * import { Console, Effect } from "effect"
  *
  * // Apply effects but discard the results
  * const result = Effect.forEach(
@@ -908,8 +905,7 @@ export declare const forEach: {
      * **Example** (Applying Effects to Iterable Elements)
      *
      * ```ts
-     * import { Effect } from "effect"
-     * import { Console } from "effect"
+     * import { Console, Effect } from "effect"
      *
      * const result = Effect.forEach(
      *   [1, 2, 3, 4, 5],
@@ -930,8 +926,7 @@ export declare const forEach: {
      * **Example** (Using discard to Ignore Results)
      *
      * ```ts
-     * import { Effect } from "effect"
-     * import { Console } from "effect"
+     * import { Console, Effect } from "effect"
      *
      * // Apply effects but discard the results
      * const result = Effect.forEach(
@@ -984,8 +979,7 @@ export declare const forEach: {
      * **Example** (Applying Effects to Iterable Elements)
      *
      * ```ts
-     * import { Effect } from "effect"
-     * import { Console } from "effect"
+     * import { Console, Effect } from "effect"
      *
      * const result = Effect.forEach(
      *   [1, 2, 3, 4, 5],
@@ -1006,8 +1000,7 @@ export declare const forEach: {
      * **Example** (Using discard to Ignore Results)
      *
      * ```ts
-     * import { Effect } from "effect"
-     * import { Console } from "effect"
+     * import { Console, Effect } from "effect"
      *
      * // Apply effects but discard the results
      * const result = Effect.forEach(
@@ -1084,7 +1077,7 @@ export declare const whileLoop: <A, E, R>(options: {
  * This defect is not a standard error but indicates a flaw in the logic that
  * was expected to be error-free. You can think of it similar to an unexpected
  * crash in the program, which can be further managed or logged using tools like
- * {@link catchAllDefect}.
+ * {@link catchDefect}.
  *
  * **Interruptions**
  *
@@ -1351,7 +1344,7 @@ export declare const suspend: <A, E, R>(effect: LazyArg<Effect<A, E, R>>) => Eff
  * This defect is not a standard error but indicates a flaw in the logic that
  * was expected to be error-free. You can think of it similar to an unexpected
  * crash in the program, which can be further managed or logged using tools like
- * {@link catchAllDefect}.
+ * {@link catchDefect}.
  *
  * @see {@link try_ | try} for a version that can handle failures.
  *
@@ -1403,12 +1396,6 @@ undefined_ as undefined };
  * Use `Effect.callback` when integrating APIs that complete through callbacks
  * instead of returning a `Promise`.
  *
- * **Previously Known As**
- *
- * This API replaces the following from Effect 3.x:
- *
- * - `Effect.async`
- *
  * **Example** (Usage)
  *
  * ```ts
@@ -1427,7 +1414,7 @@ undefined_ as undefined };
  * ```
  *
  * @category Creating Effects
- * @since 2.0.0
+ * @since 4.0.0
  */
 export declare const callback: <A, E = never, R = never>(register: (this: Scheduler, resume: (effect: Effect<A, E, R>) => void, signal: AbortSignal) => void | Effect<void, never, R>) => Effect<A, E, R>;
 /**
@@ -1460,8 +1447,7 @@ export declare const never: Effect<never>;
  * **Example** (Usage)
  *
  * ```ts
- * import { Effect } from "effect"
- * import { pipe } from "effect/Function"
+ * import { Effect, pipe } from "effect"
  *
  * const program = pipe(
  *   Effect.Do,
@@ -1472,7 +1458,7 @@ export declare const never: Effect<never>;
  * ```
  *
  * @category Do notation
- * @since 4.0.0
+ * @since 2.0.0
  */
 export declare const Do: Effect<{}>;
 /**
@@ -1480,7 +1466,7 @@ export declare const Do: Effect<{}>;
  * record used in do notation pipelines.
  *
  * @category Do notation
- * @since 4.0.0
+ * @since 2.0.0
  */
 export declare const bindTo: {
     /**
@@ -1488,7 +1474,7 @@ export declare const bindTo: {
      * record used in do notation pipelines.
      *
      * @category Do notation
-     * @since 4.0.0
+     * @since 2.0.0
      */
     <N extends string>(name: N): <A, E, R>(self: Effect<A, E, R>) => Effect<{
         [K in N]: A;
@@ -1498,7 +1484,7 @@ export declare const bindTo: {
      * record used in do notation pipelines.
      *
      * @category Do notation
-     * @since 4.0.0
+     * @since 2.0.0
      */
     <A, E, R, N extends string>(self: Effect<A, E, R>, name: N): Effect<{
         [K in N]: A;
@@ -1513,28 +1499,28 @@ export {
  * Adds a computed plain value to the do notation record.
  *
  * @category Do notation
- * @since 4.0.0
+ * @since 2.0.0
  */
 let_ as let };
 /**
  * Adds an `Effect` value to the do notation record under a given name.
  *
  * @category Do notation
- * @since 4.0.0
+ * @since 2.0.0
  */
 export declare const bind: {
     /**
      * Adds an `Effect` value to the do notation record under a given name.
      *
      * @category Do notation
-     * @since 4.0.0
+     * @since 2.0.0
      */
     <N extends string, A extends Record<string, any>, B, E2, R2>(name: N, f: (a: NoInfer<A>) => Effect<B, E2, R2>): <E, R>(self: Effect<A, E, R>) => Effect<Simplify<Omit<A, N> & Record<N, B>>, E | E2, R | R2>;
     /**
      * Adds an `Effect` value to the do notation record under a given name.
      *
      * @category Do notation
-     * @since 4.0.0
+     * @since 2.0.0
      */
     <A extends Record<string, any>, E, R, B, E2, R2, N extends string>(self: Effect<A, E, R>, name: N, f: (a: NoInfer<A>) => Effect<B, E2, R2>): Effect<Simplify<Omit<A, N> & Record<N, B>>, E | E2, R | R2>;
 };
@@ -1708,8 +1694,7 @@ export declare const gen: {
 /**
  * Type helpers for `Effect.gen` generator return signatures.
  *
- * @category Creating Effects
- * @since 4.0.0
+ * @since 2.0.0
  */
 export declare namespace gen {
     /**
@@ -1727,7 +1712,7 @@ export declare namespace gen {
  *
  * Use this function to explicitly signal an error in an `Effect`. The error
  * will keep propagating unless it is handled. You can handle the error with
- * functions like {@link catchAll} or {@link catchTag}.
+ * functions like {@link catchTag} or {@link catchTags}.
  *
  * @see {@link succeed} to create an effect that represents a successful value.
  *
@@ -1835,8 +1820,7 @@ export declare const failCauseSync: <E>(evaluate: LazyArg<Cause.Cause<E>>) => Ef
  * The error channel of the resulting effect is of type `never`, indicating that
  * it cannot recover from this failure.
  *
- * @see {@link dieSync} for a variant that throws a specified error, evaluated lazily.
- * @see {@link dieMessage} for a variant that throws a `RuntimeException` with a message.
+ * @see {@link die} for a variant that dies with an already computed defect.
  *
  * **Example** (Terminating on Division by Zero with a Specified Error)
  *
@@ -1970,7 +1954,7 @@ export declare const yieldNow: Effect<void>;
  * ```
  *
  * @category Creating Effects
- * @since 2.0.0
+ * @since 4.0.0
  */
 export declare const yieldNowWith: (priority?: number) => Effect<void>;
 /**
@@ -1990,7 +1974,7 @@ export declare const yieldNowWith: (priority?: number) => Effect<void>;
  * ```
  *
  * @category Creating Effects
- * @since 2.0.0
+ * @since 4.0.0
  */
 export declare const withFiber: <A, E = never, R = never>(evaluate: (fiber: Fiber<unknown, unknown>) => Effect<A, E, R>) => Effect<A, E, R>;
 /**
@@ -2012,7 +1996,7 @@ export declare const withFiber: <A, E = never, R = never>(evaluate: (fiber: Fibe
  * // { _id: 'Exit', _tag: 'Failure', cause: { _id: 'Cause', _tag: 'Fail', failure: 'Something went wrong' } }
  * ```
  *
- * @category Conversions
+ * @category converting
  * @since 4.0.0
  */
 export declare const fromResult: <A, E>(result: Result.Result<A, E>) => Effect<A, E>;
@@ -2038,7 +2022,7 @@ export declare const fromResult: <A, E>(result: Result.Result<A, E>) => Effect<A
  * // { _id: 'Exit', _tag: 'Failure', cause: { _id: 'Cause', _tag: 'Fail', failure: { _id: 'NoSuchElementError' } } }
  * ```
  *
- * @category Conversions
+ * @category converting
  * @since 4.0.0
  */
 export declare const fromOption: <A>(option: Option<A>) => Effect<A, Cause.NoSuchElementError>;
@@ -2064,7 +2048,7 @@ export declare const fromOption: <A>(option: Option<A>) => Effect<A, Cause.NoSuc
  * // Output: hello
  * ```
  *
- * @category Conversions
+ * @category converting
  * @since 4.0.0
  */
 export declare const fromNullishOr: <A>(value: A) => Effect<NonNullable<A>, Cause.NoSuchElementError>;
@@ -2129,7 +2113,7 @@ export declare const fromNullishOr: <A>(value: A) => Effect<NonNullable<A>, Caus
  *
  * @see {@link tap} for a version that ignores the result of the effect.
  *
- * @category Sequencing
+ * @category sequencing
  * @since 2.0.0
  */
 export declare const flatMap: {
@@ -2194,7 +2178,7 @@ export declare const flatMap: {
      *
      * @see {@link tap} for a version that ignores the result of the effect.
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 2.0.0
      */
     <A, B, E1, R1>(f: (a: A) => Effect<B, E1, R1>): <E, R>(self: Effect<A, E, R>) => Effect<B, E1 | E, R1 | R>;
@@ -2259,7 +2243,7 @@ export declare const flatMap: {
      *
      * @see {@link tap} for a version that ignores the result of the effect.
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 2.0.0
      */
     <A, E, R, B, E1, R1>(self: Effect<A, E, R>, f: (a: A) => Effect<B, E1, R1>): Effect<B, E | E1, R | R1>;
@@ -2281,7 +2265,7 @@ export declare const flatMap: {
  * })
  * ```
  *
- * @category Sequencing
+ * @category sequencing
  * @since 2.0.0
  */
 export declare const flatten: <A, E, R, E2, R2>(self: Effect<Effect<A, E, R>, E2, R2>) => Effect<A, E | E2, R | R2>;
@@ -2314,12 +2298,6 @@ export declare const flatten: <A, E, R, E2, R2>(self: Effect<Effect<A, E, R>, E2
  * Failures or requirements from either effect are preserved in the returned
  * effect.
  *
- * **Previously Known As**
- *
- * This API replaces the following from Effect 3.x:
- *
- * - `Effect.zipRight`
- *
  * **Example** (Applying a Discount Based on Fetched Amount)
  *
  * ```ts
@@ -2360,7 +2338,7 @@ export declare const flatten: <A, E, R, E2, R2>(self: Effect<Effect<A, E, R>, E2
  * // Output: 190
  * ```
  *
- * @category Sequencing
+ * @category sequencing
  * @since 2.0.0
  */
 export declare const andThen: {
@@ -2393,12 +2371,6 @@ export declare const andThen: {
      * Failures or requirements from either effect are preserved in the returned
      * effect.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following from Effect 3.x:
-     *
-     * - `Effect.zipRight`
-     *
      * **Example** (Applying a Discount Based on Fetched Amount)
      *
      * ```ts
@@ -2439,7 +2411,7 @@ export declare const andThen: {
      * // Output: 190
      * ```
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 2.0.0
      */
     <A, B, E2, R2>(f: (a: A) => Effect<B, E2, R2>): <E, R>(self: Effect<A, E, R>) => Effect<B, E | E2, R | R2>;
@@ -2472,12 +2444,6 @@ export declare const andThen: {
      * Failures or requirements from either effect are preserved in the returned
      * effect.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following from Effect 3.x:
-     *
-     * - `Effect.zipRight`
-     *
      * **Example** (Applying a Discount Based on Fetched Amount)
      *
      * ```ts
@@ -2518,7 +2484,7 @@ export declare const andThen: {
      * // Output: 190
      * ```
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 2.0.0
      */
     <B, E2, R2>(f: Effect<B, E2, R2>): <A, E, R>(self: Effect<A, E, R>) => Effect<B, E | E2, R | R2>;
@@ -2551,12 +2517,6 @@ export declare const andThen: {
      * Failures or requirements from either effect are preserved in the returned
      * effect.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following from Effect 3.x:
-     *
-     * - `Effect.zipRight`
-     *
      * **Example** (Applying a Discount Based on Fetched Amount)
      *
      * ```ts
@@ -2597,7 +2557,7 @@ export declare const andThen: {
      * // Output: 190
      * ```
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 2.0.0
      */
     <A, E, R, B, E2, R2>(self: Effect<A, E, R>, f: (a: A) => Effect<B, E2, R2>): Effect<B, E | E2, R | R2>;
@@ -2630,12 +2590,6 @@ export declare const andThen: {
      * Failures or requirements from either effect are preserved in the returned
      * effect.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following from Effect 3.x:
-     *
-     * - `Effect.zipRight`
-     *
      * **Example** (Applying a Discount Based on Fetched Amount)
      *
      * ```ts
@@ -2676,7 +2630,7 @@ export declare const andThen: {
      * // Output: 190
      * ```
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 2.0.0
      */
     <A, E, R, B, E2, R2>(self: Effect<A, E, R>, f: Effect<B, E2, R2>): Effect<B, E | E2, R | R2>;
@@ -2698,17 +2652,10 @@ export declare const andThen: {
  * next part of the chain. Note that if the side effect fails, the entire chain
  * will fail too.
  *
- * **Previously Known As**
- *
- * This API replaces the following from Effect 3.x:
- *
- * - `Effect.zipLeft`
- *
  * **Example** (Logging a step in a pipeline)
  *
  * ```ts
- * import { Data, Effect, pipe } from "effect"
- * import { Console } from "effect"
+ * import { Console, Data, Effect, pipe } from "effect"
  *
  * class DiscountRateError extends Data.TaggedError("DiscountRateError")<{}> {}
  *
@@ -2738,7 +2685,7 @@ export declare const andThen: {
  * // 95
  * ```
  *
- * @category Sequencing
+ * @category sequencing
  * @since 2.0.0
  */
 export declare const tap: {
@@ -2759,17 +2706,10 @@ export declare const tap: {
      * next part of the chain. Note that if the side effect fails, the entire chain
      * will fail too.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following from Effect 3.x:
-     *
-     * - `Effect.zipLeft`
-     *
      * **Example** (Logging a step in a pipeline)
      *
      * ```ts
-     * import { Data, Effect, pipe } from "effect"
-     * import { Console } from "effect"
+     * import { Console, Data, Effect, pipe } from "effect"
      *
      * class DiscountRateError extends Data.TaggedError("DiscountRateError")<{}> {}
      *
@@ -2799,7 +2739,7 @@ export declare const tap: {
      * // 95
      * ```
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 2.0.0
      */
     <A, B, E2, R2>(f: (a: NoInfer<A>) => Effect<B, E2, R2>): <E, R>(self: Effect<A, E, R>) => Effect<A, E | E2, R | R2>;
@@ -2820,17 +2760,10 @@ export declare const tap: {
      * next part of the chain. Note that if the side effect fails, the entire chain
      * will fail too.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following from Effect 3.x:
-     *
-     * - `Effect.zipLeft`
-     *
      * **Example** (Logging a step in a pipeline)
      *
      * ```ts
-     * import { Data, Effect, pipe } from "effect"
-     * import { Console } from "effect"
+     * import { Console, Data, Effect, pipe } from "effect"
      *
      * class DiscountRateError extends Data.TaggedError("DiscountRateError")<{}> {}
      *
@@ -2860,7 +2793,7 @@ export declare const tap: {
      * // 95
      * ```
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 2.0.0
      */
     <B, E2, R2>(f: Effect<B, E2, R2>): <A, E, R>(self: Effect<A, E, R>) => Effect<A, E | E2, R | R2>;
@@ -2881,17 +2814,10 @@ export declare const tap: {
      * next part of the chain. Note that if the side effect fails, the entire chain
      * will fail too.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following from Effect 3.x:
-     *
-     * - `Effect.zipLeft`
-     *
      * **Example** (Logging a step in a pipeline)
      *
      * ```ts
-     * import { Data, Effect, pipe } from "effect"
-     * import { Console } from "effect"
+     * import { Console, Data, Effect, pipe } from "effect"
      *
      * class DiscountRateError extends Data.TaggedError("DiscountRateError")<{}> {}
      *
@@ -2921,7 +2847,7 @@ export declare const tap: {
      * // 95
      * ```
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 2.0.0
      */
     <A, E, R, B, E2, R2>(self: Effect<A, E, R>, f: (a: NoInfer<A>) => Effect<B, E2, R2>): Effect<A, E | E2, R | R2>;
@@ -2942,17 +2868,10 @@ export declare const tap: {
      * next part of the chain. Note that if the side effect fails, the entire chain
      * will fail too.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following from Effect 3.x:
-     *
-     * - `Effect.zipLeft`
-     *
      * **Example** (Logging a step in a pipeline)
      *
      * ```ts
-     * import { Data, Effect, pipe } from "effect"
-     * import { Console } from "effect"
+     * import { Console, Data, Effect, pipe } from "effect"
      *
      * class DiscountRateError extends Data.TaggedError("DiscountRateError")<{}> {}
      *
@@ -2982,7 +2901,7 @@ export declare const tap: {
      * // 95
      * ```
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 2.0.0
      */
     <A, E, R, B, E2, R2>(self: Effect<A, E, R>, f: Effect<B, E2, R2>): Effect<A, E | E2, R | R2>;
@@ -3010,12 +2929,6 @@ export declare const tap: {
  * The resulting effect cannot fail directly because all recoverable failures
  * are represented inside the `Result` type.
  *
- * **Previously Known As**
- *
- * This API replaces the following from Effect 3.x:
- *
- * - `Effect.either`
- *
  * **Example** (Usage)
  *
  * ```ts
@@ -3156,7 +3069,7 @@ export declare const exit: <A, E, R>(self: Effect<A, E, R>) => Effect<Exit.Exit<
  * @see {@link mapBoth} for a version that operates on both channels.
  * @see {@link flatMap} or {@link andThen} for a version that can return a new effect.
  *
- * @category Mapping
+ * @category mapping
  * @since 2.0.0
  */
 export declare const map: {
@@ -3204,7 +3117,7 @@ export declare const map: {
      * @see {@link mapBoth} for a version that operates on both channels.
      * @see {@link flatMap} or {@link andThen} for a version that can return a new effect.
      *
-     * @category Mapping
+     * @category mapping
      * @since 2.0.0
      */
     <A, B>(f: (a: A) => B): <E, R>(self: Effect<A, E, R>) => Effect<B, E, R>;
@@ -3252,7 +3165,7 @@ export declare const map: {
      * @see {@link mapBoth} for a version that operates on both channels.
      * @see {@link flatMap} or {@link andThen} for a version that can return a new effect.
      *
-     * @category Mapping
+     * @category mapping
      * @since 2.0.0
      */
     <A, E, R, B>(self: Effect<A, E, R>, f: (a: A) => B): Effect<B, E, R>;
@@ -3275,7 +3188,7 @@ export declare const map: {
  * // Output: "new value"
  * ```
  *
- * @category Mapping
+ * @category mapping
  * @since 2.0.0
  */
 export declare const as: {
@@ -3297,7 +3210,7 @@ export declare const as: {
      * // Output: "new value"
      * ```
      *
-     * @category Mapping
+     * @category mapping
      * @since 2.0.0
      */
     <B>(value: B): <A, E, R>(self: Effect<A, E, R>) => Effect<B, E, R>;
@@ -3319,7 +3232,7 @@ export declare const as: {
      * // Output: "new value"
      * ```
      *
-     * @category Mapping
+     * @category mapping
      * @since 2.0.0
      */
     <A, E, R, B>(self: Effect<A, E, R>, value: B): Effect<B, E, R>;
@@ -3340,7 +3253,7 @@ export declare const as: {
  * // { _id: 'Option', _tag: 'Some', value: 42 }
  * ```
  *
- * @category Mapping
+ * @category mapping
  * @since 2.0.0
  */
 export declare const asSome: <A, E, R>(self: Effect<A, E, R>) => Effect<Option<A>, E, R>;
@@ -3361,7 +3274,7 @@ export declare const asSome: <A, E, R>(self: Effect<A, E, R>) => Effect<Option<A
  * // undefined (void)
  * ```
  *
- * @category Mapping
+ * @category mapping
  * @since 2.0.0
  */
 export declare const asVoid: <A, E, R>(self: Effect<A, E, R>) => Effect<void, E, R>;
@@ -3388,7 +3301,7 @@ export declare const asVoid: <A, E, R>(self: Effect<A, E, R>) => Effect<void, E,
  * const flipped = Effect.flip(program)
  * ```
  *
- * @category Mapping
+ * @category mapping
  * @since 2.0.0
  */
 export declare const flip: <A, E, R>(self: Effect<A, E, R>) => Effect<E, A, R>;
@@ -3457,7 +3370,7 @@ export declare const flip: <A, E, R>(self: Effect<A, E, R>) => Effect<E, A, R>;
  * // [ 1, 'hello' ]
  * ```
  *
- * @category Zipping
+ * @category zipping
  * @since 2.0.0
  */
 export declare const zip: {
@@ -3526,7 +3439,7 @@ export declare const zip: {
      * // [ 1, 'hello' ]
      * ```
      *
-     * @category Zipping
+     * @category zipping
      * @since 2.0.0
      */
     <A2, E2, R2>(that: Effect<A2, E2, R2>, options?: {
@@ -3597,7 +3510,7 @@ export declare const zip: {
      * // [ 1, 'hello' ]
      * ```
      *
-     * @category Zipping
+     * @category zipping
      * @since 2.0.0
      */
     <A, E, R, A2, E2, R2>(self: Effect<A, E, R>, that: Effect<A2, E2, R2>, options?: {
@@ -3647,7 +3560,7 @@ export declare const zip: {
  * // 6
  * ```
  *
- * @category Zipping
+ * @category zipping
  * @since 2.0.0
  */
 export declare const zipWith: {
@@ -3694,7 +3607,7 @@ export declare const zipWith: {
      * // 6
      * ```
      *
-     * @category Zipping
+     * @category zipping
      * @since 2.0.0
      */
     <A2, E2, R2, A, B>(that: Effect<A2, E2, R2>, f: (a: A, b: A2) => B, options?: {
@@ -3743,7 +3656,7 @@ export declare const zipWith: {
      * // 6
      * ```
      *
-     * @category Zipping
+     * @category zipping
      * @since 2.0.0
      */
     <A, E, R, A2, E2, R2, B>(self: Effect<A, E, R>, that: Effect<A2, E2, R2>, f: (a: A, b: A2) => B, options?: {
@@ -3770,13 +3683,7 @@ export {
  *
  * @see {@link catchCause} for a version that can recover from both recoverable and unrecoverable errors.
  *
- * **Previously Known As**
- *
- * This API replaces the following from Effect 3.x:
- *
- * - `Effect.catchAll`
- *
- * @category Error Handling
+ * @category error handling
  * @since 4.0.0
  */
 catch_ as catch };
@@ -3818,7 +3725,7 @@ catch_ as catch };
  * )
  * ```
  *
- * @category Error Handling
+ * @category error handling
  * @since 2.0.0
  */
 export declare const catchTag: {
@@ -3860,7 +3767,7 @@ export declare const catchTag: {
      * )
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     <const K extends Tags<E> | Arr.NonEmptyReadonlyArray<Tags<E>>, E, A1, E1, R1, A2 = never, E2 = ExcludeTag<E, K extends readonly [string, ...string[]] ? K[number] : K>, R2 = never>(k: K, f: (e: ExtractTag<NoInfer<E>, K extends Arr.NonEmptyReadonlyArray<string> ? K[number] : K>) => Effect<A1, E1, R1>, orElse?: ((e: ExcludeTag<E, K extends Arr.NonEmptyReadonlyArray<string> ? K[number] : K>) => Effect<A2, E2, R2>) | undefined): <A, R>(self: Effect<A, E, R>) => Effect<A | A1 | A2, E1 | E2, R | R1 | R2>;
@@ -3902,7 +3809,7 @@ export declare const catchTag: {
      * )
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     <A, E, R, const K extends Tags<E> | Arr.NonEmptyReadonlyArray<Tags<E>>, R1, E1, A1, A2 = never, E2 = ExcludeTag<E, K extends readonly [string, ...string[]] ? K[number] : K>, R2 = never>(self: Effect<A, E, R>, k: K, f: (e: ExtractTag<E, K extends Arr.NonEmptyReadonlyArray<string> ? K[number] : K>) => Effect<A1, E1, R1>, orElse?: ((e: ExcludeTag<E, K extends Arr.NonEmptyReadonlyArray<string> ? K[number] : K>) => Effect<A2, E2, R2>) | undefined): Effect<A | A1 | A2, E1 | E2, R | R1 | R2>;
@@ -3947,7 +3854,7 @@ export declare const catchTag: {
  * })
  * ```
  *
- * @category Error Handling
+ * @category error handling
  * @since 2.0.0
  */
 export declare const catchTags: {
@@ -3991,7 +3898,7 @@ export declare const catchTags: {
      * })
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     <E, Cases extends {
@@ -4055,7 +3962,7 @@ export declare const catchTags: {
      * })
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     <R, E, A, Cases extends {
@@ -4113,7 +4020,7 @@ export declare const catchTags: {
  * )
  * ```
  *
- * @category Error Handling
+ * @category error handling
  * @since 4.0.0
  */
 export declare const catchReason: {
@@ -4150,7 +4057,7 @@ export declare const catchReason: {
      * )
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 4.0.0
      */
     <K extends Tags<E>, E, RK extends ReasonTags<ExtractTag<NoInfer<E>, K>>, A2, E2, R2, A3 = unassigned, E3 = never, R3 = never>(errorTag: K, reasonTag: RK, f: (reason: ExtractReason<ExtractTag<NoInfer<E>, K>, RK>, error: NarrowReason<ExtractTag<NoInfer<E>, K>, RK>) => Effect<A2, E2, R2>, orElse?: ((reasons: ExcludeReason<ExtractTag<NoInfer<E>, K>, RK>, error: OmitReason<ExtractTag<NoInfer<E>, K>, RK>) => Effect<A3, E3, R3>) | undefined): <A, R>(self: Effect<A, E, R>) => Effect<A | A2 | Exclude<A3, unassigned>, (A3 extends unassigned ? E : ExcludeTag<E, K>) | E2 | E3, R | R2 | R3>;
@@ -4187,7 +4094,7 @@ export declare const catchReason: {
      * )
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 4.0.0
      */
     <A, E, R, K extends Tags<E>, RK extends ReasonTags<ExtractTag<E, K>>, A2, E2, R2, A3 = unassigned, E3 = never, R3 = never>(self: Effect<A, E, R>, errorTag: K, reasonTag: RK, f: (reason: ExtractReason<ExtractTag<E, K>, RK>, error: NarrowReason<ExtractTag<E, K>, RK>) => Effect<A2, E2, R2>, orElse?: ((reasons: ExcludeReason<ExtractTag<E, K>, RK>, error: OmitReason<ExtractTag<E, K>, RK>) => Effect<A3, E3, R3>) | undefined): Effect<A | A2 | Exclude<A3, unassigned>, (A3 extends unassigned ? E : ExcludeTag<E, K>) | E2 | E3, R | R2 | R3>;
@@ -4224,7 +4131,7 @@ export declare const catchReason: {
  * )
  * ```
  *
- * @category Error Handling
+ * @category error handling
  * @since 4.0.0
  */
 export declare const catchReasons: {
@@ -4260,7 +4167,7 @@ export declare const catchReasons: {
      * )
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 4.0.0
      */
     <K extends Tags<E>, E, Cases extends {
@@ -4304,7 +4211,7 @@ export declare const catchReasons: {
      * )
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 4.0.0
      */
     <A, E, R, K extends Tags<E>, Cases extends {
@@ -4322,7 +4229,7 @@ export declare const catchReasons: {
  *
  * Used by `catchReasons` and `unwrapReason` to constrain the parent error tag to reason-bearing errors.
  *
- * @category Error Handling
+ * @category error handling
  * @since 4.0.0
  */
 export type TagsWithReason<E> = {
@@ -4356,7 +4263,7 @@ export type TagsWithReason<E> = {
  * const unwrapped = program.pipe(Effect.unwrapReason("AiError"))
  * ```
  *
- * @category Error Handling
+ * @category error handling
  * @since 4.0.0
  */
 export declare const unwrapReason: {
@@ -4388,7 +4295,7 @@ export declare const unwrapReason: {
      * const unwrapped = program.pipe(Effect.unwrapReason("AiError"))
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 4.0.0
      */
     <K extends TagsWithReason<E>, E>(errorTag: K): <A, R>(self: Effect<A, E, R>) => Effect<A, ExcludeTag<E, K> | ReasonOf<ExtractTag<E, K>>, R>;
@@ -4420,7 +4327,7 @@ export declare const unwrapReason: {
      * const unwrapped = program.pipe(Effect.unwrapReason("AiError"))
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 4.0.0
      */
     <A, E, R, K extends TagsWithReason<E>>(self: Effect<A, E, R>, errorTag: K): Effect<A, ExcludeTag<E, K> | ReasonOf<ExtractTag<E, K>>, R>;
@@ -4442,12 +4349,6 @@ export declare const unwrapReason: {
  * they often indicate serious issues. However, in some cases, such as
  * dynamically loaded plugins, controlled recovery might be needed.
  *
- * **Previously Known As**
- *
- * This API replaces the following from Effect 3.x:
- *
- * - `Effect.catchAllCause`
- *
  * **Example** (Usage)
  *
  * ```ts
@@ -4467,7 +4368,7 @@ export declare const unwrapReason: {
  * })
  * ```
  *
- * @category Error Handling
+ * @category error handling
  * @since 4.0.0
  */
 export declare const catchCause: {
@@ -4488,12 +4389,6 @@ export declare const catchCause: {
      * they often indicate serious issues. However, in some cases, such as
      * dynamically loaded plugins, controlled recovery might be needed.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following from Effect 3.x:
-     *
-     * - `Effect.catchAllCause`
-     *
      * **Example** (Usage)
      *
      * ```ts
@@ -4513,7 +4408,7 @@ export declare const catchCause: {
      * })
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 4.0.0
      */
     <E, A2, E2, R2>(f: (cause: Cause.Cause<E>) => Effect<A2, E2, R2>): <A, R>(self: Effect<A, E, R>) => Effect<A2 | A, E2, R2 | R>;
@@ -4534,12 +4429,6 @@ export declare const catchCause: {
      * they often indicate serious issues. However, in some cases, such as
      * dynamically loaded plugins, controlled recovery might be needed.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following from Effect 3.x:
-     *
-     * - `Effect.catchAllCause`
-     *
      * **Example** (Usage)
      *
      * ```ts
@@ -4559,7 +4448,7 @@ export declare const catchCause: {
      * })
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 4.0.0
      */
     <A, E, R, A2, E2, R2>(self: Effect<A, E, R>, f: (cause: Cause.Cause<E>) => Effect<A2, E2, R2>): Effect<A | A2, E2, R | R2>;
@@ -4583,12 +4472,6 @@ export declare const catchCause: {
  * they often indicate serious issues. In some cases, such as dynamically loaded
  * plugins, controlled recovery may be needed.
  *
- * **Previously Known As**
- *
- * This API replaces the following from Effect 3.x:
- *
- * - `Effect.catchAllDefect`
- *
  * **Example** (Usage)
  *
  * ```ts
@@ -4607,7 +4490,7 @@ export declare const catchCause: {
  * })
  * ```
  *
- * @category Error Handling
+ * @category error handling
  * @since 4.0.0
  */
 export declare const catchDefect: {
@@ -4630,12 +4513,6 @@ export declare const catchDefect: {
      * they often indicate serious issues. In some cases, such as dynamically loaded
      * plugins, controlled recovery may be needed.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following from Effect 3.x:
-     *
-     * - `Effect.catchAllDefect`
-     *
      * **Example** (Usage)
      *
      * ```ts
@@ -4654,7 +4531,7 @@ export declare const catchDefect: {
      * })
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 4.0.0
      */
     <A2, E2, R2>(f: (defect: unknown) => Effect<A2, E2, R2>): <A, E, R>(self: Effect<A, E, R>) => Effect<A2 | A, E2 | E, R2 | R>;
@@ -4677,12 +4554,6 @@ export declare const catchDefect: {
      * they often indicate serious issues. In some cases, such as dynamically loaded
      * plugins, controlled recovery may be needed.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following from Effect 3.x:
-     *
-     * - `Effect.catchAllDefect`
-     *
      * **Example** (Usage)
      *
      * ```ts
@@ -4701,7 +4572,7 @@ export declare const catchDefect: {
      * })
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 4.0.0
      */
     <A, E, R, A2, E2, R2>(self: Effect<A, E, R>, f: (defect: unknown) => Effect<A2, E2, R2>): Effect<A | A2, E | E2, R | R2>;
@@ -4716,13 +4587,6 @@ export declare const catchDefect: {
  * matching. Non-matching errors re-fail with the original cause. Defects and
  * interrupts are not caught.
  *
- * **Previously Known As**
- *
- * This API replaces the following:
- *
- * - `Effect.catchSome` (Effect 3.x)
- * - `Effect.catchIf`
- *
  * **Example** (Usage)
  *
  * ```ts
@@ -4749,7 +4613,7 @@ export declare const catchDefect: {
  * )
  * ```
  *
- * @category Error Handling
+ * @category error handling
  * @since 2.0.0
  */
 export declare const catchIf: {
@@ -4763,13 +4627,6 @@ export declare const catchIf: {
      * matching. Non-matching errors re-fail with the original cause. Defects and
      * interrupts are not caught.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following:
-     *
-     * - `Effect.catchSome` (Effect 3.x)
-     * - `Effect.catchIf`
-     *
      * **Example** (Usage)
      *
      * ```ts
@@ -4796,7 +4653,7 @@ export declare const catchIf: {
      * )
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     <E, EB extends E, A2, E2, R2, A3 = never, E3 = Exclude<E, EB>, R3 = never>(refinement: Predicate.Refinement<NoInfer<E>, EB>, f: (e: EB) => Effect<A2, E2, R2>, orElse?: ((e: Exclude<E, EB>) => Effect<A3, E3, R3>) | undefined): <A, R>(self: Effect<A, E, R>) => Effect<A | A2 | A3, E2 | E3, R | R2 | R3>;
@@ -4810,13 +4667,6 @@ export declare const catchIf: {
      * matching. Non-matching errors re-fail with the original cause. Defects and
      * interrupts are not caught.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following:
-     *
-     * - `Effect.catchSome` (Effect 3.x)
-     * - `Effect.catchIf`
-     *
      * **Example** (Usage)
      *
      * ```ts
@@ -4843,7 +4693,7 @@ export declare const catchIf: {
      * )
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     <E, A2, E2, R2, A3 = never, E3 = E, R3 = never>(predicate: Predicate.Predicate<NoInfer<E>>, f: (e: NoInfer<E>) => Effect<A2, E2, R2>, orElse?: ((e: NoInfer<E>) => Effect<A3, E3, R3>) | undefined): <A, R>(self: Effect<A, E, R>) => Effect<A | A2 | A3, E2 | E3, R | R2 | R3>;
@@ -4857,13 +4707,6 @@ export declare const catchIf: {
      * matching. Non-matching errors re-fail with the original cause. Defects and
      * interrupts are not caught.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following:
-     *
-     * - `Effect.catchSome` (Effect 3.x)
-     * - `Effect.catchIf`
-     *
      * **Example** (Usage)
      *
      * ```ts
@@ -4890,7 +4733,7 @@ export declare const catchIf: {
      * )
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     <A, E, R, EB extends E, A2, E2, R2, A3 = never, E3 = Exclude<E, EB>, R3 = never>(self: Effect<A, E, R>, refinement: Predicate.Refinement<E, EB>, f: (e: EB) => Effect<A2, E2, R2>, orElse?: ((e: Exclude<E, EB>) => Effect<A3, E3, R3>) | undefined): Effect<A | A2 | A3, E2 | E3, R | R2 | R3>;
@@ -4904,13 +4747,6 @@ export declare const catchIf: {
      * matching. Non-matching errors re-fail with the original cause. Defects and
      * interrupts are not caught.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following:
-     *
-     * - `Effect.catchSome` (Effect 3.x)
-     * - `Effect.catchIf`
-     *
      * **Example** (Usage)
      *
      * ```ts
@@ -4937,7 +4773,7 @@ export declare const catchIf: {
      * )
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     <A, E, R, A2, E2, R2, A3 = never, E3 = E, R3 = never>(self: Effect<A, E, R>, predicate: Predicate.Predicate<E>, f: (e: E) => Effect<A2, E2, R2>, orElse?: ((e: E) => Effect<A3, E3, R3>) | undefined): Effect<A | A2 | A3, E2 | E3, R | R2 | R3>;
@@ -4945,21 +4781,21 @@ export declare const catchIf: {
 /**
  * Recovers from specific errors using a `Filter`.
  *
- * @category Error Handling
+ * @category error handling
  * @since 4.0.0
  */
 export declare const catchFilter: {
     /**
      * Recovers from specific errors using a `Filter`.
      *
-     * @category Error Handling
+     * @category error handling
      * @since 4.0.0
      */
     <E, EB, A2, E2, R2, X, A3 = never, E3 = X, R3 = never>(filter: Filter.Filter<NoInfer<E>, EB, X>, f: (e: EB) => Effect<A2, E2, R2>, orElse?: ((e: X) => Effect<A3, E3, R3>) | undefined): <A, R>(self: Effect<A, E, R>) => Effect<A | A2 | A3, E2 | E3, R | R2 | R3>;
     /**
      * Recovers from specific errors using a `Filter`.
      *
-     * @category Error Handling
+     * @category error handling
      * @since 4.0.0
      */
     <A, E, R, EB, A2, E2, R2, X, A3 = never, E3 = X, R3 = never>(self: Effect<A, E, R>, filter: Filter.Filter<NoInfer<E>, EB, X>, f: (e: EB) => Effect<A2, E2, R2>, orElse?: ((e: X) => Effect<A3, E3, R3>) | undefined): Effect<A | A2 | A3, E2 | E3, R | R2 | R3>;
@@ -4982,14 +4818,8 @@ export declare const catchFilter: {
  * Effect.runPromise(none).then(console.log) // { _id: 'Option', _tag: 'None' }
  * ```
  *
- * **Previously Known As**
- *
- * This API replaces the following from Effect 3.x:
- *
- * - `Effect.optionFromOptional`
- *
- * @category Error Handling
- * @since 2.0.0
+ * @category error handling
+ * @since 4.0.0
  */
 export declare const catchNoSuchElement: <A, E, R>(self: Effect<A, E, R>) => Effect<Option<A>, Exclude<E, Cause.NoSuchElementError>, R>;
 /**
@@ -4999,12 +4829,6 @@ export declare const catchNoSuchElement: <A, E, R>(self: Effect<A, E, R>) => Eff
  * that match a specific predicate. This is useful when you want to handle
  * only certain types of errors while letting others propagate.
  *
- * **Previously Known As**
- *
- * This API replaces the following from Effect 3.x:
- *
- * - `Effect.catchSomeCause`
- *
  * **Example** (Usage)
  *
  * ```ts
@@ -5028,7 +4852,7 @@ export declare const catchNoSuchElement: <A, E, R>(self: Effect<A, E, R>) => Eff
  * // Then: "Fallback response"
  * ```
  *
- * @category Error Handling
+ * @category error handling
  * @since 4.0.0
  */
 export declare const catchCauseIf: {
@@ -5039,12 +4863,6 @@ export declare const catchCauseIf: {
      * that match a specific predicate. This is useful when you want to handle
      * only certain types of errors while letting others propagate.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following from Effect 3.x:
-     *
-     * - `Effect.catchSomeCause`
-     *
      * **Example** (Usage)
      *
      * ```ts
@@ -5068,7 +4886,7 @@ export declare const catchCauseIf: {
      * // Then: "Fallback response"
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 4.0.0
      */
     <E, B, E2, R2>(predicate: Predicate.Predicate<Cause.Cause<E>>, f: (cause: Cause.Cause<E>) => Effect<B, E2, R2>): <A, R>(self: Effect<A, E, R>) => Effect<A | B, E | E2, R | R2>;
@@ -5079,12 +4897,6 @@ export declare const catchCauseIf: {
      * that match a specific predicate. This is useful when you want to handle
      * only certain types of errors while letting others propagate.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following from Effect 3.x:
-     *
-     * - `Effect.catchSomeCause`
-     *
      * **Example** (Usage)
      *
      * ```ts
@@ -5108,7 +4920,7 @@ export declare const catchCauseIf: {
      * // Then: "Fallback response"
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 4.0.0
      */
     <A, E, R, B, E2, R2>(self: Effect<A, E, R>, predicate: Predicate.Predicate<Cause.Cause<E>>, f: (cause: Cause.Cause<E>) => Effect<B, E2, R2>): Effect<A | B, E | E2, R | R2>;
@@ -5116,21 +4928,21 @@ export declare const catchCauseIf: {
 /**
  * Recovers from specific failures based on a `Filter`.
  *
- * @category Error Handling
+ * @category error handling
  * @since 4.0.0
  */
 export declare const catchCauseFilter: {
     /**
      * Recovers from specific failures based on a `Filter`.
      *
-     * @category Error Handling
+     * @category error handling
      * @since 4.0.0
      */
     <E, B, E2, R2, EB, X extends Cause.Cause<any>>(filter: Filter.Filter<Cause.Cause<E>, EB, X>, f: (failure: EB, cause: Cause.Cause<E>) => Effect<B, E2, R2>): <A, R>(self: Effect<A, E, R>) => Effect<A | B, Cause.Cause.Error<X> | E2, R | R2>;
     /**
      * Recovers from specific failures based on a `Filter`.
      *
-     * @category Error Handling
+     * @category error handling
      * @since 4.0.0
      */
     <A, E, R, B, E2, R2, EB, X extends Cause.Cause<any>>(self: Effect<A, E, R>, filter: Filter.Filter<Cause.Cause<E>, EB, X>, f: (failure: EB, cause: Cause.Cause<E>) => Effect<B, E2, R2>): Effect<A | B, Cause.Cause.Error<X> | E2, R | R2>;
@@ -5146,7 +4958,7 @@ export declare const catchCauseFilter: {
  *
  * @see {@link map} for a version that operates on the success channel.
  * @see {@link mapBoth} for a version that operates on both channels.
- * @see {@link orElseFail} if you want to replace the error with a new one.
+ * @see {@link mapError} if you want to replace the error with a new one.
  *
  * **Example** (Usage)
  *
@@ -5167,7 +4979,7 @@ export declare const catchCauseFilter: {
  * )
  * ```
  *
- * @category Error Handling
+ * @category error handling
  * @since 2.0.0
  */
 export declare const mapError: {
@@ -5182,7 +4994,7 @@ export declare const mapError: {
      *
      * @see {@link map} for a version that operates on the success channel.
      * @see {@link mapBoth} for a version that operates on both channels.
-     * @see {@link orElseFail} if you want to replace the error with a new one.
+     * @see {@link mapError} if you want to replace the error with a new one.
      *
      * **Example** (Usage)
      *
@@ -5203,7 +5015,7 @@ export declare const mapError: {
      * )
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     <E, E2>(f: (e: E) => E2): <A, R>(self: Effect<A, E, R>) => Effect<A, E2, R>;
@@ -5218,7 +5030,7 @@ export declare const mapError: {
      *
      * @see {@link map} for a version that operates on the success channel.
      * @see {@link mapBoth} for a version that operates on both channels.
-     * @see {@link orElseFail} if you want to replace the error with a new one.
+     * @see {@link mapError} if you want to replace the error with a new one.
      *
      * **Example** (Usage)
      *
@@ -5239,7 +5051,7 @@ export declare const mapError: {
      * )
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     <A, E, R, E2>(self: Effect<A, E, R>, f: (e: E) => E2): Effect<A, E2, R>;
@@ -5276,7 +5088,7 @@ export declare const mapError: {
  * @see {@link map} for a version that operates on the success channel.
  * @see {@link mapError} for a version that operates on the error channel.
  *
- * @category Mapping
+ * @category mapping
  * @since 2.0.0
  */
 export declare const mapBoth: {
@@ -5312,7 +5124,7 @@ export declare const mapBoth: {
      * @see {@link map} for a version that operates on the success channel.
      * @see {@link mapError} for a version that operates on the error channel.
      *
-     * @category Mapping
+     * @category mapping
      * @since 2.0.0
      */
     <E, E2, A, A2>(options: {
@@ -5351,7 +5163,7 @@ export declare const mapBoth: {
      * @see {@link map} for a version that operates on the success channel.
      * @see {@link mapError} for a version that operates on the error channel.
      *
-     * @category Mapping
+     * @category mapping
      * @since 2.0.0
      */
     <A, E, R, E2, A2>(self: Effect<A, E, R>, options: {
@@ -5368,7 +5180,7 @@ export declare const mapBoth: {
  * Use `orDie` when a typed failure represents an unrecoverable bug or invalid
  * state and should not be handled as a recoverable error.
  *
- * @see {@link orDieWith} if you need to customize the error.
+ * @see {@link mapError} to transform the error before converting it into a defect with {@link orDie}.
  *
  * **Example** (Propagating an Error as a Defect)
  *
@@ -5425,7 +5237,7 @@ export declare const orDie: <A, E, R>(self: Effect<A, E, R>) => Effect<A, never,
  * // expected error: NetworkError
  * ```
  *
- * @category Sequencing
+ * @category sequencing
  * @since 2.0.0
  */
 export declare const tapError: {
@@ -5458,7 +5270,7 @@ export declare const tapError: {
      * // expected error: NetworkError
      * ```
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 2.0.0
      */
     <E, X, E2, R2>(f: (e: NoInfer<E>) => Effect<X, E2, R2>): <A, R>(self: Effect<A, E, R>) => Effect<A, E | E2, R2 | R>;
@@ -5491,7 +5303,7 @@ export declare const tapError: {
      * // expected error: NetworkError
      * ```
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 2.0.0
      */
     <A, E, R, X, E2, R2>(self: Effect<A, E, R>, f: (e: E) => Effect<X, E2, R2>): Effect<A, E | E2, R | R2>;
@@ -5528,7 +5340,7 @@ export declare const tapError: {
  * // expected error: 504
  * ```
  *
- * @category Sequencing
+ * @category sequencing
  * @since 2.0.0
  */
 export declare const tapErrorTag: {
@@ -5564,7 +5376,7 @@ export declare const tapErrorTag: {
      * // expected error: 504
      * ```
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 2.0.0
      */
     <const K extends Tags<E> | Arr.NonEmptyReadonlyArray<Tags<E>>, E, A1, E1, R1>(k: K, f: (e: ExtractTag<NoInfer<E>, K extends Arr.NonEmptyReadonlyArray<string> ? K[number] : K>) => Effect<A1, E1, R1>): <A, R>(self: Effect<A, E, R>) => Effect<A, E | E1, R1 | R>;
@@ -5600,7 +5412,7 @@ export declare const tapErrorTag: {
      * // expected error: 504
      * ```
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 2.0.0
      */
     <A, E, R, const K extends Tags<E> | Arr.NonEmptyReadonlyArray<Tags<E>>, R1, E1, A1>(self: Effect<A, E, R>, k: K, f: (e: ExtractTag<E, K extends Arr.NonEmptyReadonlyArray<string> ? K[number] : K>) => Effect<A1, E1, R1>): Effect<A, E | E1, R | R1>;
@@ -5615,12 +5427,6 @@ export declare const tapErrorTag: {
  * the operation succeeds, the original cause is preserved. If the operation
  * fails, its error is also represented in the returned effect.
  *
- * **Previously Known As**
- *
- * This API replaces the following from Effect 3.x:
- *
- * - `Effect.tapErrorCause`
- *
  * **Example** (Usage)
  *
  * ```ts
@@ -5638,8 +5444,8 @@ export declare const tapErrorTag: {
  * // Then: { _id: 'Exit', _tag: 'Failure', cause: ... }
  * ```
  *
- * @category Sequencing
- * @since 2.0.0
+ * @category sequencing
+ * @since 4.0.0
  */
 export declare const tapCause: {
     /**
@@ -5652,12 +5458,6 @@ export declare const tapCause: {
      * the operation succeeds, the original cause is preserved. If the operation
      * fails, its error is also represented in the returned effect.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following from Effect 3.x:
-     *
-     * - `Effect.tapErrorCause`
-     *
      * **Example** (Usage)
      *
      * ```ts
@@ -5675,8 +5475,8 @@ export declare const tapCause: {
      * // Then: { _id: 'Exit', _tag: 'Failure', cause: ... }
      * ```
      *
-     * @category Sequencing
-     * @since 2.0.0
+     * @category sequencing
+     * @since 4.0.0
      */
     <E, X, E2, R2>(f: (cause: Cause.Cause<NoInfer<E>>) => Effect<X, E2, R2>): <A, R>(self: Effect<A, E, R>) => Effect<A, E | E2, R2 | R>;
     /**
@@ -5689,12 +5489,6 @@ export declare const tapCause: {
      * the operation succeeds, the original cause is preserved. If the operation
      * fails, its error is also represented in the returned effect.
      *
-     * **Previously Known As**
-     *
-     * This API replaces the following from Effect 3.x:
-     *
-     * - `Effect.tapErrorCause`
-     *
      * **Example** (Usage)
      *
      * ```ts
@@ -5712,8 +5506,8 @@ export declare const tapCause: {
      * // Then: { _id: 'Exit', _tag: 'Failure', cause: ... }
      * ```
      *
-     * @category Sequencing
-     * @since 2.0.0
+     * @category sequencing
+     * @since 4.0.0
      */
     <A, E, R, X, E2, R2>(self: Effect<A, E, R>, f: (cause: Cause.Cause<E>) => Effect<X, E2, R2>): Effect<A, E | E2, R | R2>;
 };
@@ -5743,7 +5537,7 @@ export declare const tapCause: {
  * // Then: { _id: 'Exit', _tag: 'Failure', cause: ... }
  * ```
  *
- * @category Sequencing
+ * @category sequencing
  * @since 4.0.0
  */
 export declare const tapCauseIf: {
@@ -5773,7 +5567,7 @@ export declare const tapCauseIf: {
      * // Then: { _id: 'Exit', _tag: 'Failure', cause: ... }
      * ```
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 4.0.0
      */
     <E, B, E2, R2>(predicate: Predicate.Predicate<Cause.Cause<E>>, f: (cause: Cause.Cause<E>) => Effect<B, E2, R2>): <A, R>(self: Effect<A, E, R>) => Effect<A, E | E2, R | R2>;
@@ -5803,7 +5597,7 @@ export declare const tapCauseIf: {
      * // Then: { _id: 'Exit', _tag: 'Failure', cause: ... }
      * ```
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 4.0.0
      */
     <A, E, R, B, E2, R2>(self: Effect<A, E, R>, predicate: Predicate.Predicate<Cause.Cause<E>>, f: (cause: Cause.Cause<E>) => Effect<B, E2, R2>): Effect<A, E | E2, R | R2>;
@@ -5811,21 +5605,21 @@ export declare const tapCauseIf: {
 /**
  * Conditionally executes a side effect based on the cause of a failed effect.
  *
- * @category Sequencing
+ * @category sequencing
  * @since 4.0.0
  */
 export declare const tapCauseFilter: {
     /**
      * Conditionally executes a side effect based on the cause of a failed effect.
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 4.0.0
      */
     <E, B, E2, R2, EB, X extends Cause.Cause<any>>(filter: Filter.Filter<Cause.Cause<E>, EB, X>, f: (a: EB, cause: Cause.Cause<E>) => Effect<B, E2, R2>): <A, R>(self: Effect<A, E, R>) => Effect<A, E | E2, R | R2>;
     /**
      * Conditionally executes a side effect based on the cause of a failed effect.
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 4.0.0
      */
     <A, E, R, B, E2, R2, EB, X extends Cause.Cause<any>>(self: Effect<A, E, R>, filter: Filter.Filter<Cause.Cause<E>, EB, X>, f: (a: EB, cause: Cause.Cause<E>) => Effect<B, E2, R2>): Effect<A, E | E2, R | R2>;
@@ -5874,7 +5668,7 @@ export declare const tapCauseFilter: {
  * //   ... stack trace ...
  * ```
  *
- * @category Sequencing
+ * @category sequencing
  * @since 2.0.0
  */
 export declare const tapDefect: {
@@ -5922,7 +5716,7 @@ export declare const tapDefect: {
      * //   ... stack trace ...
      * ```
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 2.0.0
      */
     <E, B, E2, R2>(f: (defect: unknown) => Effect<B, E2, R2>): <A, R>(self: Effect<A, E, R>) => Effect<A, E | E2, R | R2>;
@@ -5970,7 +5764,7 @@ export declare const tapDefect: {
      * //   ... stack trace ...
      * ```
      *
-     * @category Sequencing
+     * @category sequencing
      * @since 2.0.0
      */
     <A, E, R, B, E2, R2>(self: Effect<A, E, R>, f: (defect: unknown) => Effect<B, E2, R2>): Effect<A, E | E2, R | R2>;
@@ -6013,14 +5807,13 @@ export declare const eventually: <A, E, R>(self: Effect<A, E, R>) => Effect<A, n
 /**
  * Type helpers for retrying effects.
  *
- * @category Error Handling
  * @since 2.0.0
  */
 export declare namespace Retry {
     /**
      * Computes the result type of `Effect.retry` from the original effect and retry options.
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     type Return<R, E, A, O extends Options<E>> = Effect<A, (O extends {
@@ -6047,7 +5840,7 @@ export declare namespace Retry {
     /**
      * Options that control whether and how a failing effect is retried.
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     interface Options<E> {
@@ -6101,7 +5894,7 @@ export declare namespace Retry {
  * @see {@link retryOrElse} for a version that allows you to run a fallback.
  * @see {@link repeat} if your retry condition is based on successful outcomes rather than errors.
  *
- * @category Error Handling
+ * @category error handling
  * @since 2.0.0
  */
 export declare const retry: {
@@ -6149,7 +5942,7 @@ export declare const retry: {
      * @see {@link retryOrElse} for a version that allows you to run a fallback.
      * @see {@link repeat} if your retry condition is based on successful outcomes rather than errors.
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     <E, O extends Retry.Options<E>>(options: O): <A, R>(self: Effect<A, E, R>) => Retry.Return<R, E, A, O>;
@@ -6197,7 +5990,7 @@ export declare const retry: {
      * @see {@link retryOrElse} for a version that allows you to run a fallback.
      * @see {@link repeat} if your retry condition is based on successful outcomes rather than errors.
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     <B, E, Error, Env>(policy: Schedule<B, NoInfer<E>, Error, Env>): <A, R>(self: Effect<A, E, R>) => Effect<A, E | Error, R | Env>;
@@ -6245,7 +6038,7 @@ export declare const retry: {
      * @see {@link retryOrElse} for a version that allows you to run a fallback.
      * @see {@link repeat} if your retry condition is based on successful outcomes rather than errors.
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     <B, E, Error, Env>(builder: ($: <O, SE, R>(_: Schedule<O, NoInfer<E>, SE, R>) => Schedule<O, E, SE, R>) => Schedule<B, NoInfer<E>, Error, Env>): <A, R>(self: Effect<A, E, R>) => Effect<A, E | Error, R | Env>;
@@ -6293,7 +6086,7 @@ export declare const retry: {
      * @see {@link retryOrElse} for a version that allows you to run a fallback.
      * @see {@link repeat} if your retry condition is based on successful outcomes rather than errors.
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     <A, E, R, O extends Retry.Options<E>>(self: Effect<A, E, R>, options: O): Retry.Return<R, E, A, O>;
@@ -6341,7 +6134,7 @@ export declare const retry: {
      * @see {@link retryOrElse} for a version that allows you to run a fallback.
      * @see {@link repeat} if your retry condition is based on successful outcomes rather than errors.
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     <A, E, R, B, Error, Env>(self: Effect<A, E, R>, policy: Schedule<B, NoInfer<E>, Error, Env>): Effect<A, E | Error, R | Env>;
@@ -6389,7 +6182,7 @@ export declare const retry: {
      * @see {@link retryOrElse} for a version that allows you to run a fallback.
      * @see {@link repeat} if your retry condition is based on successful outcomes rather than errors.
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     <A, E, R, B, Error, Env>(self: Effect<A, E, R>, builder: ($: <O, SE, R>(_: Schedule<O, NoInfer<E>, SE, R>) => Schedule<O, E, SE, R>) => Schedule<B, NoInfer<E>, Error, Env>): Effect<A, E | Error, R | Env>;
@@ -6448,7 +6241,7 @@ export declare const retry: {
  * // Network data
  * ```
  *
- * @category Error Handling
+ * @category error handling
  * @since 2.0.0
  */
 export declare const retryOrElse: {
@@ -6506,7 +6299,7 @@ export declare const retryOrElse: {
      * // Network data
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     <A1, E, E1, R1, A2, E2, R2>(policy: Schedule<A1, NoInfer<E>, E1, R1>, orElse: (e: NoInfer<E>, out: A1) => Effect<A2, E2, R2>): <A, R>(self: Effect<A, E, R>) => Effect<A | A2, E1 | E2, R | R1 | R2>;
@@ -6564,7 +6357,7 @@ export declare const retryOrElse: {
      * // Network data
      * ```
      *
-     * @category Error Handling
+     * @category error handling
      * @since 2.0.0
      */
     <A, E, R, A1, E1, R1, A2, E2, R2>(self: Effect<A, E, R>, policy: Schedule<A1, NoInfer<E>, E1, R1>, orElse: (e: NoInfer<E>, out: A1) => Effect<A2, E2, R2>): Effect<A | A2, E1 | E2, R | R1 | R2>;
@@ -6595,9 +6388,9 @@ export declare const retryOrElse: {
  * // Output: "Caught cause: Something went wrong"
  * ```
  *
- * @see {@link unsandbox} to restore the original error handling.
+ * @see {@link sandbox} to expose failures as full causes.
  *
- * @category Error Handling
+ * @category error handling
  * @since 2.0.0
  */
 export declare const sandbox: <A, E, R>(self: Effect<A, E, R>) => Effect<A, Cause.Cause<E>, R>;
@@ -6638,13 +6431,7 @@ export declare const sandbox: <A, E, R>(self: Effect<A, E, R>) => Effect<A, Caus
  * const programWarn = task.pipe(Effect.ignore({ log: "Warn", message: "Ignoring task failure" }))
  * ```
  *
- * **Previously Known As**
- *
- * This API replaces the following from Effect 3.x:
- *
- * - `Effect.ignoreLogged`
- *
- * @category Error Handling
+ * @category error handling
  * @since 2.0.0
  */
 export declare const ignore: <Arg extends Effect<any, any, any> | {
@@ -6674,7 +6461,7 @@ export declare const ignore: <Arg extends Effect<any, any, any> | {
  * const programLog = task.pipe(Effect.ignoreCause({ log: true, message: "Ignoring failure cause" }))
  * ```
  *
- * @category Error Handling
+ * @category error handling
  * @since 4.0.0
  */
 export declare const ignoreCause: <Arg extends Effect<any, any, any> | {
@@ -6698,7 +6485,7 @@ export declare const ignoreCause: <Arg extends Effect<any, any, any> | {
  * **Example** (Usage)
  *
  * ```ts
- * import { Effect, ExecutionPlan, Layer, Context } from "effect"
+ * import { Context, Effect, ExecutionPlan, Layer } from "effect"
  *
  * const Endpoint = Context.Service<{ url: string }>("Endpoint")
  *
@@ -6733,7 +6520,7 @@ export declare const withExecutionPlan: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Effect, ExecutionPlan, Layer, Context } from "effect"
+     * import { Context, Effect, ExecutionPlan, Layer } from "effect"
      *
      * const Endpoint = Context.Service<{ url: string }>("Endpoint")
      *
@@ -6773,7 +6560,7 @@ export declare const withExecutionPlan: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Effect, ExecutionPlan, Layer, Context } from "effect"
+     * import { Context, Effect, ExecutionPlan, Layer } from "effect"
      *
      * const Endpoint = Context.Service<{ url: string }>("Endpoint")
      *
@@ -6809,7 +6596,7 @@ export declare const withExecutionPlan: {
  * If the `defectsOnly` option is set to `true`, only defects (unrecoverable
  * errors) will be reported, while regular failures will be ignored.
  *
- * @category Error Handling
+ * @category error handling
  * @since 4.0.0
  */
 export declare const withErrorReporting: <Arg extends Effect<any, any, any> | {
@@ -6986,9 +6773,7 @@ export declare const firstSuccessOf: <Eff extends Effect<any, any, any>>(effects
  * your program waits for a task to finish, ensuring that it doesn't hang
  * indefinitely if the task takes too long.
  *
- * @see {@link timeoutFail} for a version that raises a custom error.
- * @see {@link timeoutFailCause} for a version that raises a custom defect.
- * @see {@link timeoutTo} for a version that allows specifying both success and timeout handlers.
+ * @see {@link timeoutOrElse} for a version that allows specifying both success and timeout handlers.
  *
  * **Example** (Usage)
  *
@@ -7034,9 +6819,7 @@ export declare const timeout: {
      * your program waits for a task to finish, ensuring that it doesn't hang
      * indefinitely if the task takes too long.
      *
-     * @see {@link timeoutFail} for a version that raises a custom error.
-     * @see {@link timeoutFailCause} for a version that raises a custom defect.
-     * @see {@link timeoutTo} for a version that allows specifying both success and timeout handlers.
+     * @see {@link timeoutOrElse} for a version that allows specifying both success and timeout handlers.
      *
      * **Example** (Usage)
      *
@@ -7082,9 +6865,7 @@ export declare const timeout: {
      * your program waits for a task to finish, ensuring that it doesn't hang
      * indefinitely if the task takes too long.
      *
-     * @see {@link timeoutFail} for a version that raises a custom error.
-     * @see {@link timeoutFailCause} for a version that raises a custom defect.
-     * @see {@link timeoutTo} for a version that allows specifying both success and timeout handlers.
+     * @see {@link timeoutOrElse} for a version that allows specifying both success and timeout handlers.
      *
      * **Example** (Usage)
      *
@@ -7133,9 +6914,7 @@ export declare const timeout: {
  * source effect fails before the timeout, that failure is preserved.
  *
  * @see {@link timeout} for a version that raises a `TimeoutException`.
- * @see {@link timeoutFail} for a version that raises a custom error.
- * @see {@link timeoutFailCause} for a version that raises a custom defect.
- * @see {@link timeoutTo} for a version that allows specifying both success and timeout handlers.
+ * @see {@link timeoutOrElse} for a version that allows specifying both success and timeout handlers.
  *
  * **Example** (Usage)
  *
@@ -7181,9 +6960,7 @@ export declare const timeoutOption: {
      * source effect fails before the timeout, that failure is preserved.
      *
      * @see {@link timeout} for a version that raises a `TimeoutException`.
-     * @see {@link timeoutFail} for a version that raises a custom error.
-     * @see {@link timeoutFailCause} for a version that raises a custom defect.
-     * @see {@link timeoutTo} for a version that allows specifying both success and timeout handlers.
+     * @see {@link timeoutOrElse} for a version that allows specifying both success and timeout handlers.
      *
      * **Example** (Usage)
      *
@@ -7229,9 +7006,7 @@ export declare const timeoutOption: {
      * source effect fails before the timeout, that failure is preserved.
      *
      * @see {@link timeout} for a version that raises a `TimeoutException`.
-     * @see {@link timeoutFail} for a version that raises a custom error.
-     * @see {@link timeoutFailCause} for a version that raises a custom defect.
-     * @see {@link timeoutTo} for a version that allows specifying both success and timeout handlers.
+     * @see {@link timeoutOrElse} for a version that allows specifying both success and timeout handlers.
      *
      * **Example** (Usage)
      *
@@ -7301,7 +7076,7 @@ export declare const timeoutOption: {
  * ```
  *
  * @category Delays & Timeouts
- * @since 3.1.0
+ * @since 4.0.0
  */
 export declare const timeoutOrElse: {
     /**
@@ -7339,7 +7114,7 @@ export declare const timeoutOrElse: {
      * ```
      *
      * @category Delays & Timeouts
-     * @since 3.1.0
+     * @since 4.0.0
      */
     <A2, E2, R2>(options: {
         readonly duration: Duration.Input;
@@ -7380,7 +7155,7 @@ export declare const timeoutOrElse: {
      * ```
      *
      * @category Delays & Timeouts
-     * @since 3.1.0
+     * @since 4.0.0
      */
     <A, E, R, A2, E2, R2>(self: Effect<A, E, R>, options: {
         readonly duration: Duration.Input;
@@ -7793,7 +7568,7 @@ export declare const raceFirst: {
  * // Use Effect.filterMapEffect for effectful Filter.Filter callbacks
  * ```
  *
- * @category Filtering
+ * @category filtering
  * @since 2.0.0
  */
 export declare const filter: {
@@ -7815,7 +7590,7 @@ export declare const filter: {
      * // Use Effect.filterMapEffect for effectful Filter.Filter callbacks
      * ```
      *
-     * @category Filtering
+     * @category filtering
      * @since 2.0.0
      */
     <A, B extends A>(refinement: Predicate.Refinement<NoInfer<A>, B>): (elements: Iterable<A>) => Effect<Array<B>>;
@@ -7837,7 +7612,7 @@ export declare const filter: {
      * // Use Effect.filterMapEffect for effectful Filter.Filter callbacks
      * ```
      *
-     * @category Filtering
+     * @category filtering
      * @since 2.0.0
      */
     <A>(predicate: Predicate.Predicate<NoInfer<A>>): (elements: Iterable<A>) => Effect<Array<A>>;
@@ -7859,7 +7634,7 @@ export declare const filter: {
      * // Use Effect.filterMapEffect for effectful Filter.Filter callbacks
      * ```
      *
-     * @category Filtering
+     * @category filtering
      * @since 2.0.0
      */
     <A, E, R>(predicate: (a: NoInfer<A>, i: number) => Effect<boolean, E, R>, options?: {
@@ -7883,7 +7658,7 @@ export declare const filter: {
      * // Use Effect.filterMapEffect for effectful Filter.Filter callbacks
      * ```
      *
-     * @category Filtering
+     * @category filtering
      * @since 2.0.0
      */
     <A, B extends A>(elements: Iterable<A>, refinement: Predicate.Refinement<A, B>): Effect<Array<B>>;
@@ -7905,7 +7680,7 @@ export declare const filter: {
      * // Use Effect.filterMapEffect for effectful Filter.Filter callbacks
      * ```
      *
-     * @category Filtering
+     * @category filtering
      * @since 2.0.0
      */
     <A>(elements: Iterable<A>, predicate: Predicate.Predicate<A>): Effect<Array<A>>;
@@ -7927,7 +7702,7 @@ export declare const filter: {
      * // Use Effect.filterMapEffect for effectful Filter.Filter callbacks
      * ```
      *
-     * @category Filtering
+     * @category filtering
      * @since 2.0.0
      */
     <A, E, R>(iterable: Iterable<A>, predicate: (a: NoInfer<A>, i: number) => Effect<boolean, E, R>, options?: {
@@ -7937,36 +7712,36 @@ export declare const filter: {
 /**
  * Filters and maps elements of an iterable with a `Filter`.
  *
- * @category Filtering
- * @since 4.0.0
+ * @category filtering
+ * @since 2.0.0
  */
 export declare const filterMap: {
     /**
      * Filters and maps elements of an iterable with a `Filter`.
      *
-     * @category Filtering
-     * @since 4.0.0
+     * @category filtering
+     * @since 2.0.0
      */
     <A, B, X>(filter: Filter.Filter<NoInfer<A>, B, X>): (elements: Iterable<A>) => Effect<Array<B>>;
     /**
      * Filters and maps elements of an iterable with a `Filter`.
      *
-     * @category Filtering
-     * @since 4.0.0
+     * @category filtering
+     * @since 2.0.0
      */
     <A, B, X>(elements: Iterable<A>, filter: Filter.Filter<NoInfer<A>, B, X>): Effect<Array<B>>;
 };
 /**
  * Effectfully filters and maps elements of an iterable with a `FilterEffect`.
  *
- * @category Filtering
+ * @category filtering
  * @since 4.0.0
  */
 export declare const filterMapEffect: {
     /**
      * Effectfully filters and maps elements of an iterable with a `FilterEffect`.
      *
-     * @category Filtering
+     * @category filtering
      * @since 4.0.0
      */
     <A, B, X, E, R>(filter: Filter.FilterEffect<NoInfer<A>, B, X, E, R>, options?: {
@@ -7975,7 +7750,7 @@ export declare const filterMapEffect: {
     /**
      * Effectfully filters and maps elements of an iterable with a `FilterEffect`.
      *
-     * @category Filtering
+     * @category filtering
      * @since 4.0.0
      */
     <A, B, X, E, R>(elements: Iterable<A>, filter: Filter.FilterEffect<NoInfer<A>, B, X, E, R>, options?: {
@@ -8010,7 +7785,7 @@ export declare const filterMapEffect: {
  * // Result: "Number 5 is odd" (since 5 is not even)
  * ```
  *
- * @category Filtering
+ * @category filtering
  * @since 2.0.0
  */
 export declare const filterOrElse: {
@@ -8042,7 +7817,7 @@ export declare const filterOrElse: {
      * // Result: "Number 5 is odd" (since 5 is not even)
      * ```
      *
-     * @category Filtering
+     * @category filtering
      * @since 2.0.0
      */
     <A, C, E2, R2, B extends A>(refinement: Predicate.Refinement<NoInfer<A>, B>, orElse: (a: EqualsWith<A, B, NoInfer<A>, Exclude<NoInfer<A>, B>>) => Effect<C, E2, R2>): <E, R>(self: Effect<A, E, R>) => Effect<B | C, E2 | E, R2 | R>;
@@ -8074,7 +7849,7 @@ export declare const filterOrElse: {
      * // Result: "Number 5 is odd" (since 5 is not even)
      * ```
      *
-     * @category Filtering
+     * @category filtering
      * @since 2.0.0
      */
     <A, C, E2, R2>(predicate: Predicate.Predicate<NoInfer<A>>, orElse: (a: NoInfer<A>) => Effect<C, E2, R2>): <E, R>(self: Effect<A, E, R>) => Effect<A | C, E2 | E, R2 | R>;
@@ -8106,7 +7881,7 @@ export declare const filterOrElse: {
      * // Result: "Number 5 is odd" (since 5 is not even)
      * ```
      *
-     * @category Filtering
+     * @category filtering
      * @since 2.0.0
      */
     <A, E, R, C, E2, R2, B extends A>(self: Effect<A, E, R>, refinement: Predicate.Refinement<A, B>, orElse: (a: EqualsWith<A, B, A, Exclude<A, B>>) => Effect<C, E2, R2>): Effect<B | C, E | E2, R | R2>;
@@ -8138,7 +7913,7 @@ export declare const filterOrElse: {
      * // Result: "Number 5 is odd" (since 5 is not even)
      * ```
      *
-     * @category Filtering
+     * @category filtering
      * @since 2.0.0
      */
     <A, E, R, C, E2, R2>(self: Effect<A, E, R>, predicate: Predicate.Predicate<NoInfer<A>>, orElse: (a: NoInfer<A>) => Effect<C, E2, R2>): Effect<A | C, E | E2, R | R2>;
@@ -8146,21 +7921,21 @@ export declare const filterOrElse: {
 /**
  * Filters an effect with a `Filter`, providing an alternative effect on failure.
  *
- * @category Filtering
+ * @category filtering
  * @since 4.0.0
  */
 export declare const filterMapOrElse: {
     /**
      * Filters an effect with a `Filter`, providing an alternative effect on failure.
      *
-     * @category Filtering
+     * @category filtering
      * @since 4.0.0
      */
     <A, B, X, C, E2, R2>(filter: Filter.Filter<NoInfer<A>, B, X>, orElse: (x: X) => Effect<C, E2, R2>): <E, R>(self: Effect<A, E, R>) => Effect<B | C, E2 | E, R2 | R>;
     /**
      * Filters an effect with a `Filter`, providing an alternative effect on failure.
      *
-     * @category Filtering
+     * @category filtering
      * @since 4.0.0
      */
     <A, E, R, B, X, C, E2, R2>(self: Effect<A, E, R>, filter: Filter.Filter<NoInfer<A>, B, X>, orElse: (x: X) => Effect<C, E2, R2>): Effect<B | C, E | E2, R | R2>;
@@ -8192,7 +7967,7 @@ export declare const filterMapOrElse: {
  * // Result: Effect.fail("Expected even number, got 5")
  * ```
  *
- * @category Filtering
+ * @category filtering
  * @since 2.0.0
  */
 export declare const filterOrFail: {
@@ -8223,7 +7998,7 @@ export declare const filterOrFail: {
      * // Result: Effect.fail("Expected even number, got 5")
      * ```
      *
-     * @category Filtering
+     * @category filtering
      * @since 2.0.0
      */
     <A, E2, B extends A>(refinement: Predicate.Refinement<NoInfer<A>, B>, orFailWith: (a: NoInfer<A>) => E2): <E, R>(self: Effect<A, E, R>) => Effect<B, E2 | E, R>;
@@ -8254,7 +8029,7 @@ export declare const filterOrFail: {
      * // Result: Effect.fail("Expected even number, got 5")
      * ```
      *
-     * @category Filtering
+     * @category filtering
      * @since 2.0.0
      */
     <A, E2>(predicate: Predicate.Predicate<NoInfer<A>>, orFailWith: (a: NoInfer<A>) => E2): <E, R>(self: Effect<A, E, R>) => Effect<A, E2 | E, R>;
@@ -8285,7 +8060,7 @@ export declare const filterOrFail: {
      * // Result: Effect.fail("Expected even number, got 5")
      * ```
      *
-     * @category Filtering
+     * @category filtering
      * @since 2.0.0
      */
     <A, B extends A>(refinement: Predicate.Refinement<NoInfer<A>, B>): <E, R>(self: Effect<A, E, R>) => Effect<B, Cause.NoSuchElementError | E, R>;
@@ -8316,7 +8091,7 @@ export declare const filterOrFail: {
      * // Result: Effect.fail("Expected even number, got 5")
      * ```
      *
-     * @category Filtering
+     * @category filtering
      * @since 2.0.0
      */
     <A>(predicate: Predicate.Predicate<NoInfer<A>>): <E, R>(self: Effect<A, E, R>) => Effect<A, Cause.NoSuchElementError | E, R>;
@@ -8347,7 +8122,7 @@ export declare const filterOrFail: {
      * // Result: Effect.fail("Expected even number, got 5")
      * ```
      *
-     * @category Filtering
+     * @category filtering
      * @since 2.0.0
      */
     <A, E, R, E2, B extends A>(self: Effect<A, E, R>, refinement: Predicate.Refinement<NoInfer<A>, B>, orFailWith: (a: NoInfer<A>) => E2): Effect<B, E2 | E, R>;
@@ -8378,7 +8153,7 @@ export declare const filterOrFail: {
      * // Result: Effect.fail("Expected even number, got 5")
      * ```
      *
-     * @category Filtering
+     * @category filtering
      * @since 2.0.0
      */
     <A, E, R, E2>(self: Effect<A, E, R>, predicate: Predicate.Predicate<NoInfer<A>>, orFailWith: (a: NoInfer<A>) => E2): Effect<A, E2 | E, R>;
@@ -8409,7 +8184,7 @@ export declare const filterOrFail: {
      * // Result: Effect.fail("Expected even number, got 5")
      * ```
      *
-     * @category Filtering
+     * @category filtering
      * @since 2.0.0
      */
     <A, E, R, B extends A>(self: Effect<A, E, R>, refinement: Predicate.Refinement<NoInfer<A>, B>): Effect<B, E | Cause.NoSuchElementError, R>;
@@ -8440,7 +8215,7 @@ export declare const filterOrFail: {
      * // Result: Effect.fail("Expected even number, got 5")
      * ```
      *
-     * @category Filtering
+     * @category filtering
      * @since 2.0.0
      */
     <A, E, R>(self: Effect<A, E, R>, predicate: Predicate.Predicate<NoInfer<A>>): Effect<A, E | Cause.NoSuchElementError, R>;
@@ -8448,35 +8223,35 @@ export declare const filterOrFail: {
 /**
  * Filters an effect with a `Filter`, failing when the filter fails.
  *
- * @category Filtering
+ * @category filtering
  * @since 4.0.0
  */
 export declare const filterMapOrFail: {
     /**
      * Filters an effect with a `Filter`, failing when the filter fails.
      *
-     * @category Filtering
+     * @category filtering
      * @since 4.0.0
      */
     <A, B, X, E2>(filter: Filter.Filter<NoInfer<A>, B, X>, orFailWith: (x: X) => E2): <E, R>(self: Effect<A, E, R>) => Effect<B, E2 | E, R>;
     /**
      * Filters an effect with a `Filter`, failing when the filter fails.
      *
-     * @category Filtering
+     * @category filtering
      * @since 4.0.0
      */
     <A, B, X>(filter: Filter.Filter<NoInfer<A>, B, X>): <E, R>(self: Effect<A, E, R>) => Effect<B, Cause.NoSuchElementError | E, R>;
     /**
      * Filters an effect with a `Filter`, failing when the filter fails.
      *
-     * @category Filtering
+     * @category filtering
      * @since 4.0.0
      */
     <A, E, R, B, X, E2>(self: Effect<A, E, R>, filter: Filter.Filter<A, B, X>, orFailWith: (x: X) => E2): Effect<B, E2 | E, R>;
     /**
      * Filters an effect with a `Filter`, failing when the filter fails.
      *
-     * @category Filtering
+     * @category filtering
      * @since 4.0.0
      */
     <A, E, R, B, X>(self: Effect<A, E, R>, filter: Filter.Filter<A, B, X>): Effect<B, Cause.NoSuchElementError | E, R>;
@@ -8514,8 +8289,7 @@ export declare const filterMapOrFail: {
  * // { _id: 'Option', _tag: 'Some', value: undefined }
  * ```
  *
- * @see {@link whenEffect} for a version that allows the condition to be an effect.
- * @see {@link unless} for a version that executes the effect when the condition is `false`.
+ * @see {@link when} for conditional execution with a boolean condition.
  *
  * @category Conditional Operators
  * @since 2.0.0
@@ -8554,8 +8328,7 @@ export declare const when: {
      * // { _id: 'Option', _tag: 'Some', value: undefined }
      * ```
      *
-     * @see {@link whenEffect} for a version that allows the condition to be an effect.
-     * @see {@link unless} for a version that executes the effect when the condition is `false`.
+     * @see {@link when} for conditional execution with a boolean condition.
      *
      * @category Conditional Operators
      * @since 2.0.0
@@ -8594,8 +8367,7 @@ export declare const when: {
      * // { _id: 'Option', _tag: 'Some', value: undefined }
      * ```
      *
-     * @see {@link whenEffect} for a version that allows the condition to be an effect.
-     * @see {@link unless} for a version that executes the effect when the condition is `false`.
+     * @see {@link when} for conditional execution with a boolean condition.
      *
      * @category Conditional Operators
      * @since 2.0.0
@@ -8806,7 +8578,7 @@ export declare const match: {
  * @see {@link matchEffect} if you need to perform side effects in the handlers.
  *
  * @category Pattern Matching
- * @since 2.0.0
+ * @since 4.0.0
  */
 export declare const matchEager: {
     /**
@@ -8844,7 +8616,7 @@ export declare const matchEager: {
      * @see {@link matchEffect} if you need to perform side effects in the handlers.
      *
      * @category Pattern Matching
-     * @since 2.0.0
+     * @since 4.0.0
      */
     <E, A2, A, A3>(options: {
         readonly onFailure: (error: E) => A2;
@@ -8885,7 +8657,7 @@ export declare const matchEager: {
      * @see {@link matchEffect} if you need to perform side effects in the handlers.
      *
      * @category Pattern Matching
-     * @since 2.0.0
+     * @since 4.0.0
      */
     <A, E, R, A2, A3>(self: Effect<A, E, R>, options: {
         readonly onFailure: (error: E) => A2;
@@ -9040,7 +8812,7 @@ export declare const matchCause: {
  * ```
  *
  * @category Pattern Matching
- * @since 3.8.0
+ * @since 4.0.0
  */
 export declare const matchCauseEager: {
     /**
@@ -9070,7 +8842,7 @@ export declare const matchCauseEager: {
      * ```
      *
      * @category Pattern Matching
-     * @since 3.8.0
+     * @since 4.0.0
      */
     <E, A2, A, A3>(options: {
         readonly onFailure: (cause: Cause.Cause<E>) => A2;
@@ -9103,7 +8875,7 @@ export declare const matchCauseEager: {
      * ```
      *
      * @category Pattern Matching
-     * @since 3.8.0
+     * @since 4.0.0
      */
     <A, E, R, A2, A3>(self: Effect<A, E, R>, options: {
         readonly onFailure: (cause: Cause.Cause<E>) => A2;
@@ -9570,7 +9342,7 @@ export declare const isSuccess: <A, E, R>(self: Effect<A, E, R>) => Effect<boole
  * **Example** (Usage)
  *
  * ```ts
- * import { Console, Effect, Option, Context } from "effect"
+ * import { Console, Context, Effect, Option } from "effect"
  *
  * const Logger = Context.Service<{
  *   log: (msg: string) => void
@@ -9610,7 +9382,7 @@ export declare const context: <R = never>() => Effect<Context.Context<R>, never,
  * **Example** (Usage)
  *
  * ```ts
- * import { Console, Effect, Option, Context } from "effect"
+ * import { Console, Context, Effect, Option } from "effect"
  *
  * const Logger = Context.Service<{
  *   log: (msg: string) => void
@@ -9654,7 +9426,7 @@ export declare const contextWith: <R, A, E, R2>(f: (context: Context.Context<R>)
  * **Example** (Usage)
  *
  * ```ts
- * import { Effect, Layer, Context } from "effect"
+ * import { Context, Effect, Layer } from "effect"
  *
  * interface Database {
  *   readonly query: (sql: string) => Effect.Effect<string>
@@ -9689,7 +9461,7 @@ export declare const provide: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Effect, Layer, Context } from "effect"
+     * import { Context, Effect, Layer } from "effect"
      *
      * interface Database {
      *   readonly query: (sql: string) => Effect.Effect<string>
@@ -9726,7 +9498,7 @@ export declare const provide: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Effect, Layer, Context } from "effect"
+     * import { Context, Effect, Layer } from "effect"
      *
      * interface Database {
      *   readonly query: (sql: string) => Effect.Effect<string>
@@ -9763,7 +9535,7 @@ export declare const provide: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Effect, Layer, Context } from "effect"
+     * import { Context, Effect, Layer } from "effect"
      *
      * interface Database {
      *   readonly query: (sql: string) => Effect.Effect<string>
@@ -9798,7 +9570,7 @@ export declare const provide: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Effect, Layer, Context } from "effect"
+     * import { Context, Effect, Layer } from "effect"
      *
      * interface Database {
      *   readonly query: (sql: string) => Effect.Effect<string>
@@ -9835,7 +9607,7 @@ export declare const provide: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Effect, Layer, Context } from "effect"
+     * import { Context, Effect, Layer } from "effect"
      *
      * interface Database {
      *   readonly query: (sql: string) => Effect.Effect<string>
@@ -9872,7 +9644,7 @@ export declare const provide: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Effect, Layer, Context } from "effect"
+     * import { Context, Effect, Layer } from "effect"
      *
      * interface Database {
      *   readonly query: (sql: string) => Effect.Effect<string>
@@ -9912,7 +9684,7 @@ export declare const provide: {
  * **Example** (Usage)
  *
  * ```ts
- * import { Effect, Context } from "effect"
+ * import { Context, Effect } from "effect"
  *
  * // Define service keys
  * const Logger = Context.Service<{
@@ -9938,7 +9710,7 @@ export declare const provide: {
  * ```
  *
  * @category Environment
- * @since 2.0.0
+ * @since 4.0.0
  */
 export declare const provideContext: {
     /**
@@ -9953,7 +9725,7 @@ export declare const provideContext: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Effect, Context } from "effect"
+     * import { Context, Effect } from "effect"
      *
      * // Define service keys
      * const Logger = Context.Service<{
@@ -9979,7 +9751,7 @@ export declare const provideContext: {
      * ```
      *
      * @category Environment
-     * @since 2.0.0
+     * @since 4.0.0
      */
     <XR>(context: Context.Context<XR>): <A, E, R>(self: Effect<A, E, R>) => Effect<A, E, Exclude<R, XR>>;
     /**
@@ -9994,7 +9766,7 @@ export declare const provideContext: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Effect, Context } from "effect"
+     * import { Context, Effect } from "effect"
      *
      * // Define service keys
      * const Logger = Context.Service<{
@@ -10020,7 +9792,7 @@ export declare const provideContext: {
      * ```
      *
      * @category Environment
-     * @since 2.0.0
+     * @since 4.0.0
      */
     <A, E, R, XR>(self: Effect<A, E, R>, context: Context.Context<XR>): Effect<A, E, Exclude<R, XR>>;
 };
@@ -10030,7 +9802,7 @@ export declare const provideContext: {
  * **Example** (Usage)
  *
  * ```ts
- * import { Effect, Context } from "effect"
+ * import { Context, Effect } from "effect"
  *
  * interface Database {
  *   readonly query: (sql: string) => Effect.Effect<string>
@@ -10061,7 +9833,7 @@ export declare const service: <I, S>(service: Context.Key<I, S>) => Effect<S, ne
  * **Example** (Usage)
  *
  * ```ts
- * import { Effect, Option, Context } from "effect"
+ * import { Context, Effect, Option } from "effect"
  *
  * // Define a service key
  * const Logger = Context.Service<{
@@ -10095,7 +9867,7 @@ export declare const serviceOption: <I, S>(key: Context.Key<I, S>) => Effect<Opt
  * **Example** (Usage)
  *
  * ```ts
- * import { Effect, Context } from "effect"
+ * import { Context, Effect } from "effect"
  *
  * // Define services
  * const Logger = Context.Service<{
@@ -10137,7 +9909,7 @@ export declare const updateContext: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Effect, Context } from "effect"
+     * import { Context, Effect } from "effect"
      *
      * // Define services
      * const Logger = Context.Service<{
@@ -10179,7 +9951,7 @@ export declare const updateContext: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Effect, Context } from "effect"
+     * import { Context, Effect } from "effect"
      *
      * // Define services
      * const Logger = Context.Service<{
@@ -10221,7 +9993,7 @@ export declare const updateContext: {
  * **Example** (Usage)
  *
  * ```ts
- * import { Console, Effect, Context } from "effect"
+ * import { Console, Context, Effect } from "effect"
  *
  * // Define a counter service
  * const Counter = Context.Service<{ count: number }>("Counter")
@@ -10255,7 +10027,7 @@ export declare const updateService: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Console, Effect, Context } from "effect"
+     * import { Console, Context, Effect } from "effect"
      *
      * // Define a counter service
      * const Counter = Context.Service<{ count: number }>("Counter")
@@ -10289,7 +10061,7 @@ export declare const updateService: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Console, Effect, Context } from "effect"
+     * import { Console, Context, Effect } from "effect"
      *
      * // Define a counter service
      * const Counter = Context.Service<{ count: number }>("Counter")
@@ -10329,7 +10101,7 @@ export declare const updateService: {
  * **Example** (Usage)
  *
  * ```ts
- * import { Console, Effect, Context } from "effect"
+ * import { Console, Context, Effect } from "effect"
  *
  * // Define a service for configuration
  * const Config = Context.Service<{
@@ -10376,7 +10148,7 @@ export declare const provideService: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Console, Effect, Context } from "effect"
+     * import { Console, Context, Effect } from "effect"
      *
      * // Define a service for configuration
      * const Config = Context.Service<{
@@ -10423,7 +10195,7 @@ export declare const provideService: {
          * **Example** (Usage)
          *
          * ```ts
-         * import { Console, Effect, Context } from "effect"
+         * import { Console, Context, Effect } from "effect"
          *
          * // Define a service for configuration
          * const Config = Context.Service<{
@@ -10470,7 +10242,7 @@ export declare const provideService: {
          * **Example** (Usage)
          *
          * ```ts
-         * import { Console, Effect, Context } from "effect"
+         * import { Console, Context, Effect } from "effect"
          *
          * // Define a service for configuration
          * const Config = Context.Service<{
@@ -10518,7 +10290,7 @@ export declare const provideService: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Console, Effect, Context } from "effect"
+     * import { Console, Context, Effect } from "effect"
      *
      * // Define a service for configuration
      * const Config = Context.Service<{
@@ -10565,7 +10337,7 @@ export declare const provideService: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Console, Effect, Context } from "effect"
+     * import { Console, Context, Effect } from "effect"
      *
      * // Define a service for configuration
      * const Config = Context.Service<{
@@ -10611,7 +10383,7 @@ export declare const provideService: {
  * **Example** (Usage)
  *
  * ```ts
- * import { Console, Effect, Context } from "effect"
+ * import { Console, Context, Effect } from "effect"
  *
  * // Define a database connection service
  * interface DatabaseConnection {
@@ -10665,7 +10437,7 @@ export declare const provideServiceEffect: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Console, Effect, Context } from "effect"
+     * import { Console, Context, Effect } from "effect"
      *
      * // Define a database connection service
      * interface DatabaseConnection {
@@ -10719,7 +10491,7 @@ export declare const provideServiceEffect: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Console, Effect, Context } from "effect"
+     * import { Console, Context, Effect } from "effect"
      *
      * // Define a database connection service
      * interface DatabaseConnection {
@@ -10790,7 +10562,7 @@ export declare const provideServiceEffect: {
  * // [1, 2, 3, 4, 5]
  * ```
  *
- * @category References
+ * @category references
  * @since 2.0.0
  */
 export declare const withConcurrency: {
@@ -10823,7 +10595,7 @@ export declare const withConcurrency: {
      * // [1, 2, 3, 4, 5]
      * ```
      *
-     * @category References
+     * @category references
      * @since 2.0.0
      */
     (concurrency: number | "unbounded"): <A, E, R>(self: Effect<A, E, R>) => Effect<A, E, R>;
@@ -10856,7 +10628,7 @@ export declare const withConcurrency: {
      * // [1, 2, 3, 4, 5]
      * ```
      *
-     * @category References
+     * @category references
      * @since 2.0.0
      */
     <A, E, R>(self: Effect<A, E, R>, concurrency: number | "unbounded"): Effect<A, E, R>;
@@ -10890,7 +10662,7 @@ export declare const withConcurrency: {
  * // Releasing resource
  * ```
  *
- * @category Resource Management & Finalization
+ * @category resource management
  * @since 2.0.0
  */
 export declare const scope: Effect<Scope, never, Scope>;
@@ -10923,7 +10695,7 @@ export declare const scope: Effect<Scope, never, Scope>;
  * // Output: "Releasing resource"
  * ```
  *
- * @category Resource Management & Finalization
+ * @category resource management
  * @since 2.0.0
  */
 export declare const scoped: <A, E, R>(self: Effect<A, E, R>) => Effect<A, E, Exclude<R, Scope>>;
@@ -10963,8 +10735,8 @@ export declare const scoped: <A, E, R>(self: Effect<A, E, R>) => Effect<A, E, Ex
  * // Manual finalizer
  * ```
  *
- * @category Resource Management & Finalization
- * @since 2.0.0
+ * @category resource management
+ * @since 3.11.0
  */
 export declare const scopedWith: <A, E, R>(f: (scope: Scope) => Effect<A, E, R>) => Effect<A, E, R>;
 /**
@@ -11018,7 +10790,7 @@ export declare const scopedWith: <A, E, R>(f: (scope: Scope) => Effect<A, E, R>)
  * )
  * ```
  *
- * @category Resource Management & Finalization
+ * @category resource management
  * @since 2.0.0
  */
 export declare const acquireRelease: <A, E, R, R2>(acquire: Effect<A, E, R>, release: (a: A, exit: Exit.Exit<unknown, unknown>) => Effect<unknown, never, R2>, options?: {
@@ -11037,13 +10809,13 @@ export declare const acquireRelease: <A, E, R, R2>(acquire: Effect<A, E, R>, rel
  * JavaScript disposal protocal instead of requiring an explicit release
  * function.
  *
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/using}
+ * @see [JavaScript `using` declarations](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/using)
  *
  * **Example** (Usage)
  *
  * ```ts
  * import sqlite from "node:sqlite";
- * import { Effect } from "effect";
+ * import { Effect } from "effect"
  *
  * const program = Effect.scoped(
  *   Effect.gen(function* () {
@@ -11059,7 +10831,7 @@ export declare const acquireRelease: <A, E, R, R2>(acquire: Effect<A, E, R>, rel
  * )
  * ```
  *
- * @category Resource Management & Finalization
+ * @category resource management
  * @since 4.0.0
  */
 export declare const acquireDisposable: <A extends AsyncDisposable | Disposable, E, R>(acquire: Effect<A, E, R>) => Effect<A, E, R | Scope>;
@@ -11132,7 +10904,7 @@ export declare const acquireDisposable: <A extends AsyncDisposable | Disposable,
  * // Closing connection to db://localhost:5432 (success)
  * ```
  *
- * @category Resource Management & Finalization
+ * @category resource management
  * @since 2.0.0
  */
 export declare const acquireUseRelease: <Resource, E, R, A, E2, R2, E3, R3>(acquire: Effect<Resource, E, R>, use: (a: Resource) => Effect<A, E2, R2>, release: (a: Resource, exit: Exit.Exit<A, E2>) => Effect<void, E3, R3>) => Effect<A, E | E2 | E3, R | R2 | R3>;
@@ -11175,7 +10947,7 @@ export declare const acquireUseRelease: <Resource, E, R, A, E2, R2, E3, R3>(acqu
  * // operation result
  * ```
  *
- * @category Resource Management & Finalization
+ * @category resource management
  * @since 2.0.0
  */
 export declare const addFinalizer: <R>(finalizer: (exit: Exit.Exit<unknown, unknown>) => Effect<void, never, R>) => Effect<void, never, R | Scope>;
@@ -11216,7 +10988,7 @@ export declare const addFinalizer: <R>(finalizer: (exit: Exit.Exit<unknown, unkn
  * // 42
  * ```
  *
- * @category Resource Management & Finalization
+ * @category resource management
  * @since 2.0.0
  */
 export declare const ensuring: {
@@ -11257,7 +11029,7 @@ export declare const ensuring: {
      * // 42
      * ```
      *
-     * @category Resource Management & Finalization
+     * @category resource management
      * @since 2.0.0
      */
     <X, R1>(finalizer: Effect<X, never, R1>): <A, E, R>(self: Effect<A, E, R>) => Effect<A, E, R1 | R>;
@@ -11298,7 +11070,7 @@ export declare const ensuring: {
      * // 42
      * ```
      *
-     * @category Resource Management & Finalization
+     * @category resource management
      * @since 2.0.0
      */
     <A, E, R, X, R1>(self: Effect<A, E, R>, finalizer: Effect<X, never, R1>): Effect<A, E, R1 | R>;
@@ -11310,7 +11082,7 @@ export declare const ensuring: {
  * **Example** (Usage)
  *
  * ```ts
- * import { Cause, Data, Console, Effect } from "effect"
+ * import { Cause, Console, Data, Effect } from "effect"
  *
  * class TaskError extends Data.TaggedError("TaskError")<{ readonly message: string }> {}
  *
@@ -11327,7 +11099,7 @@ export declare const ensuring: {
  * // TaskError: Something went wrong
  * ```
  *
- * @category Resource Management & Finalization
+ * @category resource management
  * @since 2.0.0
  */
 export declare const onError: {
@@ -11338,7 +11110,7 @@ export declare const onError: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Cause, Data, Console, Effect } from "effect"
+     * import { Cause, Console, Data, Effect } from "effect"
      *
      * class TaskError extends Data.TaggedError("TaskError")<{ readonly message: string }> {}
      *
@@ -11355,7 +11127,7 @@ export declare const onError: {
      * // TaskError: Something went wrong
      * ```
      *
-     * @category Resource Management & Finalization
+     * @category resource management
      * @since 2.0.0
      */
     <E, X, R2>(cleanup: (cause: Cause.Cause<E>) => Effect<X, never, R2>): <A, R>(self: Effect<A, E, R>) => Effect<A, E, R2 | R>;
@@ -11366,7 +11138,7 @@ export declare const onError: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Cause, Data, Console, Effect } from "effect"
+     * import { Cause, Console, Data, Effect } from "effect"
      *
      * class TaskError extends Data.TaggedError("TaskError")<{ readonly message: string }> {}
      *
@@ -11383,7 +11155,7 @@ export declare const onError: {
      * // TaskError: Something went wrong
      * ```
      *
-     * @category Resource Management & Finalization
+     * @category resource management
      * @since 2.0.0
      */
     <A, E, R, X, R2>(self: Effect<A, E, R>, cleanup: (cause: Cause.Cause<E>) => Effect<X, never, R2>): Effect<A, E, R2 | R>;
@@ -11409,7 +11181,7 @@ export declare const onError: {
  * )
  * ```
  *
- * @category Resource Management & Finalization
+ * @category resource management
  * @since 4.0.0
  */
 export declare const onErrorIf: {
@@ -11434,7 +11206,7 @@ export declare const onErrorIf: {
      * )
      * ```
      *
-     * @category Resource Management & Finalization
+     * @category resource management
      * @since 4.0.0
      */
     <E, XE, XR>(predicate: Predicate.Predicate<Cause.Cause<E>>, f: (cause: Cause.Cause<E>) => Effect<void, XE, XR>): <A, R>(self: Effect<A, E, R>) => Effect<A, E | XE, R | XR>;
@@ -11459,7 +11231,7 @@ export declare const onErrorIf: {
      * )
      * ```
      *
-     * @category Resource Management & Finalization
+     * @category resource management
      * @since 4.0.0
      */
     <A, E, R, XE, XR>(self: Effect<A, E, R>, predicate: Predicate.Predicate<Cause.Cause<E>>, f: (cause: Cause.Cause<E>) => Effect<void, XE, XR>): Effect<A, E | XE, R | XR>;
@@ -11467,21 +11239,21 @@ export declare const onErrorIf: {
 /**
  * Runs the finalizer only when this effect fails and the cause matches the provided `Filter`.
  *
- * @category Resource Management & Finalization
+ * @category resource management
  * @since 4.0.0
  */
 export declare const onErrorFilter: {
     /**
      * Runs the finalizer only when this effect fails and the cause matches the provided `Filter`.
      *
-     * @category Resource Management & Finalization
+     * @category resource management
      * @since 4.0.0
      */
     <A, E, EB, X, XE, XR>(filter: Filter.Filter<Cause.Cause<E>, EB, X>, f: (failure: EB, cause: Cause.Cause<E>) => Effect<void, XE, XR>): <R>(self: Effect<A, E, R>) => Effect<A, E | XE, R | XR>;
     /**
      * Runs the finalizer only when this effect fails and the cause matches the provided `Filter`.
      *
-     * @category Resource Management & Finalization
+     * @category resource management
      * @since 4.0.0
      */
     <A, E, R, EB, X, XE, XR>(self: Effect<A, E, R>, filter: Filter.Filter<Cause.Cause<E>, EB, X>, f: (failure: EB, cause: Cause.Cause<E>) => Effect<void, XE, XR>): Effect<A, E | XE, R | XR>;
@@ -11495,8 +11267,8 @@ export declare const onErrorFilter: {
  * This low-level operator preserves the source effect's result unless the
  * finalizer fails. Prefer `onExit` for normal cleanup logic.
  *
- * @category Resource Management & Finalization
- * @since 2.0.0
+ * @category resource management
+ * @since 4.0.0
  */
 export declare const onExitPrimitive: <A, E, R, XE = never, XR = never>(self: Effect<A, E, R>, f: (exit: Exit.Exit<A, E>) => Effect<void, XE, XR> | undefined, interruptible?: boolean) => Effect<A, E | XE, R | XR>;
 /**
@@ -11523,7 +11295,7 @@ export declare const onExitPrimitive: <A, E, R, XE = never, XR = never>(self: Ef
  * // 42
  * ```
  *
- * @category Resource Management & Finalization
+ * @category resource management
  * @since 2.0.0
  */
 export declare const onExit: {
@@ -11551,7 +11323,7 @@ export declare const onExit: {
      * // 42
      * ```
      *
-     * @category Resource Management & Finalization
+     * @category resource management
      * @since 2.0.0
      */
     <A, E, XE = never, XR = never>(f: (exit: Exit.Exit<A, E>) => Effect<void, XE, XR>): <R>(self: Effect<A, E, R>) => Effect<A, E | XE, R | XR>;
@@ -11579,7 +11351,7 @@ export declare const onExit: {
      * // 42
      * ```
      *
-     * @category Resource Management & Finalization
+     * @category resource management
      * @since 2.0.0
      */
     <A, E, R, XE = never, XR = never>(self: Effect<A, E, R>, f: (exit: Exit.Exit<A, E>) => Effect<void, XE, XR>): Effect<A, E | XE, R | XR>;
@@ -11603,7 +11375,7 @@ export declare const onExit: {
  * )
  * ```
  *
- * @category Resource Management & Finalization
+ * @category resource management
  * @since 4.0.0
  */
 export declare const onExitIf: {
@@ -11626,7 +11398,7 @@ export declare const onExitIf: {
      * )
      * ```
      *
-     * @category Resource Management & Finalization
+     * @category resource management
      * @since 4.0.0
      */
     <A, E, XE, XR>(predicate: Predicate.Predicate<Exit.Exit<NoInfer<A>, NoInfer<E>>>, f: (exit: Exit.Exit<NoInfer<A>, NoInfer<E>>) => Effect<void, XE, XR>): <R>(self: Effect<A, E, R>) => Effect<A, E | XE, R | XR>;
@@ -11649,7 +11421,7 @@ export declare const onExitIf: {
      * )
      * ```
      *
-     * @category Resource Management & Finalization
+     * @category resource management
      * @since 4.0.0
      */
     <A, E, R, XE, XR>(self: Effect<A, E, R>, predicate: Predicate.Predicate<Exit.Exit<NoInfer<A>, NoInfer<E>>>, f: (exit: Exit.Exit<NoInfer<A>, NoInfer<E>>) => Effect<void, XE, XR>): Effect<A, E | XE, R | XR>;
@@ -11657,21 +11429,21 @@ export declare const onExitIf: {
 /**
  * Runs the cleanup effect only when the `Exit` matches the provided `Filter`.
  *
- * @category Resource Management & Finalization
+ * @category resource management
  * @since 4.0.0
  */
 export declare const onExitFilter: {
     /**
      * Runs the cleanup effect only when the `Exit` matches the provided `Filter`.
      *
-     * @category Resource Management & Finalization
+     * @category resource management
      * @since 4.0.0
      */
     <A, E, XE, XR, B, X>(filter: Filter.Filter<Exit.Exit<NoInfer<A>, NoInfer<E>>, B, X>, f: (b: B, exit: Exit.Exit<NoInfer<A>, NoInfer<E>>) => Effect<void, XE, XR>): <R>(self: Effect<A, E, R>) => Effect<A, E | XE, R | XR>;
     /**
      * Runs the cleanup effect only when the `Exit` matches the provided `Filter`.
      *
-     * @category Resource Management & Finalization
+     * @category resource management
      * @since 4.0.0
      */
     <A, E, R, XE, XR, B, X>(self: Effect<A, E, R>, filter: Filter.Filter<Exit.Exit<NoInfer<A>, NoInfer<E>>, B, X>, f: (b: B, exit: Exit.Exit<NoInfer<A>, NoInfer<E>>) => Effect<void, XE, XR>): Effect<A, E | XE, R | XR>;
@@ -12376,7 +12148,6 @@ export declare const abortSignal: Effect<AbortSignal, never, Scope>;
 /**
  * Type helpers for repeating effects.
  *
- * @category Repetition / Recursion
  * @since 2.0.0
  */
 export declare namespace Repeat {
@@ -12479,9 +12250,7 @@ export declare const forever: <Arg extends Effect<any, any, any> | {
  *
  * ```ts
  * // Success Example
- * import { Effect } from "effect"
- * import { Schedule } from "effect"
- * import { Console } from "effect"
+ * import { Console, Effect, Schedule } from "effect"
  *
  * const action = Console.log("success")
  * const policy = Schedule.addDelay(Schedule.recurs(2), () => Effect.succeed("100 millis"))
@@ -12494,8 +12263,7 @@ export declare const forever: <Arg extends Effect<any, any, any> | {
  *
  * ```ts
  * // Failure Example
- * import { Effect } from "effect"
- * import { Schedule } from "effect"
+ * import { Effect, Schedule } from "effect"
  *
  * let count = 0
  *
@@ -12547,9 +12315,7 @@ export declare const repeat: {
      *
      * ```ts
      * // Success Example
-     * import { Effect } from "effect"
-     * import { Schedule } from "effect"
-     * import { Console } from "effect"
+     * import { Console, Effect, Schedule } from "effect"
      *
      * const action = Console.log("success")
      * const policy = Schedule.addDelay(Schedule.recurs(2), () => Effect.succeed("100 millis"))
@@ -12562,8 +12328,7 @@ export declare const repeat: {
      *
      * ```ts
      * // Failure Example
-     * import { Effect } from "effect"
-     * import { Schedule } from "effect"
+     * import { Effect, Schedule } from "effect"
      *
      * let count = 0
      *
@@ -12615,9 +12380,7 @@ export declare const repeat: {
      *
      * ```ts
      * // Success Example
-     * import { Effect } from "effect"
-     * import { Schedule } from "effect"
-     * import { Console } from "effect"
+     * import { Console, Effect, Schedule } from "effect"
      *
      * const action = Console.log("success")
      * const policy = Schedule.addDelay(Schedule.recurs(2), () => Effect.succeed("100 millis"))
@@ -12630,8 +12393,7 @@ export declare const repeat: {
      *
      * ```ts
      * // Failure Example
-     * import { Effect } from "effect"
-     * import { Schedule } from "effect"
+     * import { Effect, Schedule } from "effect"
      *
      * let count = 0
      *
@@ -12683,9 +12445,7 @@ export declare const repeat: {
      *
      * ```ts
      * // Success Example
-     * import { Effect } from "effect"
-     * import { Schedule } from "effect"
-     * import { Console } from "effect"
+     * import { Console, Effect, Schedule } from "effect"
      *
      * const action = Console.log("success")
      * const policy = Schedule.addDelay(Schedule.recurs(2), () => Effect.succeed("100 millis"))
@@ -12698,8 +12458,7 @@ export declare const repeat: {
      *
      * ```ts
      * // Failure Example
-     * import { Effect } from "effect"
-     * import { Schedule } from "effect"
+     * import { Effect, Schedule } from "effect"
      *
      * let count = 0
      *
@@ -12751,9 +12510,7 @@ export declare const repeat: {
      *
      * ```ts
      * // Success Example
-     * import { Effect } from "effect"
-     * import { Schedule } from "effect"
-     * import { Console } from "effect"
+     * import { Console, Effect, Schedule } from "effect"
      *
      * const action = Console.log("success")
      * const policy = Schedule.addDelay(Schedule.recurs(2), () => Effect.succeed("100 millis"))
@@ -12766,8 +12523,7 @@ export declare const repeat: {
      *
      * ```ts
      * // Failure Example
-     * import { Effect } from "effect"
-     * import { Schedule } from "effect"
+     * import { Effect, Schedule } from "effect"
      *
      * let count = 0
      *
@@ -12819,9 +12575,7 @@ export declare const repeat: {
      *
      * ```ts
      * // Success Example
-     * import { Effect } from "effect"
-     * import { Schedule } from "effect"
-     * import { Console } from "effect"
+     * import { Console, Effect, Schedule } from "effect"
      *
      * const action = Console.log("success")
      * const policy = Schedule.addDelay(Schedule.recurs(2), () => Effect.succeed("100 millis"))
@@ -12834,8 +12588,7 @@ export declare const repeat: {
      *
      * ```ts
      * // Failure Example
-     * import { Effect } from "effect"
-     * import { Schedule } from "effect"
+     * import { Effect, Schedule } from "effect"
      *
      * let count = 0
      *
@@ -12887,9 +12640,7 @@ export declare const repeat: {
      *
      * ```ts
      * // Success Example
-     * import { Effect } from "effect"
-     * import { Schedule } from "effect"
-     * import { Console } from "effect"
+     * import { Console, Effect, Schedule } from "effect"
      *
      * const action = Console.log("success")
      * const policy = Schedule.addDelay(Schedule.recurs(2), () => Effect.succeed("100 millis"))
@@ -12902,8 +12653,7 @@ export declare const repeat: {
      *
      * ```ts
      * // Failure Example
-     * import { Effect } from "effect"
-     * import { Schedule } from "effect"
+     * import { Effect, Schedule } from "effect"
      *
      * let count = 0
      *
@@ -12944,8 +12694,7 @@ export declare const repeat: {
  * **Example** (Usage)
  *
  * ```ts
- * import { Console, Effect, Schedule } from "effect"
- * import * as Option from "effect/Option"
+ * import { Console, Effect, Option, Schedule } from "effect"
  *
  * let attempt = 0
  * const task = Effect.gen(function*() {
@@ -12988,8 +12737,7 @@ export declare const repeatOrElse: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Console, Effect, Schedule } from "effect"
-     * import * as Option from "effect/Option"
+     * import { Console, Effect, Option, Schedule } from "effect"
      *
      * let attempt = 0
      * const task = Effect.gen(function*() {
@@ -13032,8 +12780,7 @@ export declare const repeatOrElse: {
      * **Example** (Usage)
      *
      * ```ts
-     * import { Console, Effect, Schedule } from "effect"
-     * import * as Option from "effect/Option"
+     * import { Console, Effect, Option, Schedule } from "effect"
      *
      * let attempt = 0
      * const task = Effect.gen(function*() {
@@ -13464,7 +13211,7 @@ export declare const scheduleFrom: {
  * })
  * ```
  *
- * @category Tracing
+ * @category tracing
  * @since 2.0.0
  */
 export declare const tracer: Effect<Tracer>;
@@ -13485,7 +13232,7 @@ export declare const tracer: Effect<Tracer>;
  * // const traced = Effect.withTracer(program, customTracer)
  * ```
  *
- * @category Tracing
+ * @category tracing
  * @since 2.0.0
  */
 export declare const withTracer: {
@@ -13506,7 +13253,7 @@ export declare const withTracer: {
      * // const traced = Effect.withTracer(program, customTracer)
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     (value: Tracer): <A, E, R>(effect: Effect<A, E, R>) => Effect<A, E, R>;
@@ -13527,7 +13274,7 @@ export declare const withTracer: {
      * // const traced = Effect.withTracer(program, customTracer)
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     <A, E, R>(effect: Effect<A, E, R>, value: Tracer): Effect<A, E, R>;
@@ -13552,7 +13299,7 @@ export declare const withTracer: {
  * )
  * ```
  *
- * @category Tracing
+ * @category tracing
  * @since 2.0.0
  */
 export declare const withTracerEnabled: {
@@ -13576,7 +13323,7 @@ export declare const withTracerEnabled: {
      * )
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     (enabled: boolean): <A, E, R>(effect: Effect<A, E, R>) => Effect<A, E, R>;
@@ -13600,7 +13347,7 @@ export declare const withTracerEnabled: {
      * )
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     <A, E, R>(effect: Effect<A, E, R>, enabled: boolean): Effect<A, E, R>;
@@ -13620,7 +13367,7 @@ export declare const withTracerEnabled: {
  * )
  * ```
  *
- * @category Tracing
+ * @category tracing
  * @since 2.0.0
  */
 export declare const withTracerTiming: {
@@ -13639,7 +13386,7 @@ export declare const withTracerTiming: {
      * )
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     (enabled: boolean): <A, E, R>(effect: Effect<A, E, R>) => Effect<A, E, R>;
@@ -13658,7 +13405,7 @@ export declare const withTracerTiming: {
      * )
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     <A, E, R>(effect: Effect<A, E, R>, enabled: boolean): Effect<A, E, R>;
@@ -13687,7 +13434,7 @@ export declare const withTracerTiming: {
  * })
  * ```
  *
- * @category Tracing
+ * @category tracing
  * @since 2.0.0
  */
 export declare const annotateSpans: {
@@ -13715,7 +13462,7 @@ export declare const annotateSpans: {
      * })
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     (key: string, value: unknown): <A, E, R>(effect: Effect<A, E, R>) => Effect<A, E, R>;
@@ -13743,7 +13490,7 @@ export declare const annotateSpans: {
      * })
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     (values: Record<string, unknown>): <A, E, R>(effect: Effect<A, E, R>) => Effect<A, E, R>;
@@ -13771,7 +13518,7 @@ export declare const annotateSpans: {
      * })
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     <A, E, R>(effect: Effect<A, E, R>, key: string, value: unknown): Effect<A, E, R>;
@@ -13799,7 +13546,7 @@ export declare const annotateSpans: {
      * })
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     <A, E, R>(effect: Effect<A, E, R>, values: Record<string, unknown>): Effect<A, E, R>;
@@ -13825,7 +13572,7 @@ export declare const annotateSpans: {
  * const traced = Effect.withSpan(program, "user-operation")
  * ```
  *
- * @category Tracing
+ * @category tracing
  * @since 2.0.0
  */
 export declare const annotateCurrentSpan: {
@@ -13850,7 +13597,7 @@ export declare const annotateCurrentSpan: {
      * const traced = Effect.withSpan(program, "user-operation")
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     (key: string, value: unknown): Effect<void>;
@@ -13875,7 +13622,7 @@ export declare const annotateCurrentSpan: {
      * const traced = Effect.withSpan(program, "user-operation")
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     (values: Record<string, unknown>): Effect<void>;
@@ -13902,7 +13649,7 @@ export declare const annotateCurrentSpan: {
  * const traced = Effect.withSpan(program, "my-span")
  * ```
  *
- * @category Tracing
+ * @category tracing
  * @since 2.0.0
  */
 export declare const currentSpan: Effect<Span, Cause.NoSuchElementError>;
@@ -13934,7 +13681,7 @@ export declare const currentSpan: Effect<Span, Cause.NoSuchElementError>;
  * const traced = Effect.withSpan(program, "parent-span")
  * ```
  *
- * @category Tracing
+ * @category tracing
  * @since 2.0.0
  */
 export declare const currentParentSpan: Effect<AnySpan, Cause.NoSuchElementError>;
@@ -13967,7 +13714,7 @@ export declare const currentParentSpan: Effect<AnySpan, Cause.NoSuchElementError
  * // Output: Current span annotations: { userId: "123", operation: "data-processing" }
  * ```
  *
- * @category Tracing
+ * @category tracing
  * @since 2.0.0
  */
 export declare const spanAnnotations: Effect<Readonly<Record<string, unknown>>>;
@@ -13992,7 +13739,7 @@ export declare const spanAnnotations: Effect<Readonly<Record<string, unknown>>>;
  * })
  * ```
  *
- * @category Tracing
+ * @category tracing
  * @since 2.0.0
  */
 export declare const spanLinks: Effect<ReadonlyArray<SpanLink>>;
@@ -14045,7 +13792,7 @@ export declare const spanLinks: Effect<ReadonlyArray<SpanLink>>;
  * })
  * ```
  *
- * @category Tracing
+ * @category tracing
  * @since 2.0.0
  */
 export declare const linkSpans: {
@@ -14098,7 +13845,7 @@ export declare const linkSpans: {
      * })
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     (span: AnySpan | ReadonlyArray<AnySpan>, attributes?: Record<string, unknown>): <A, E, R>(self: Effect<A, E, R>) => Effect<A, E, R>;
@@ -14151,7 +13898,7 @@ export declare const linkSpans: {
      * })
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     <A, E, R>(self: Effect<A, E, R>, span: AnySpan | ReadonlyArray<AnySpan>, attributes?: Record<string, unknown>): Effect<A, E, R>;
@@ -14177,7 +13924,7 @@ export declare const linkSpans: {
  * })
  * ```
  *
- * @category Tracing
+ * @category tracing
  * @since 2.0.0
  */
 export declare const makeSpan: (name: string, options?: SpanOptionsNoTrace) => Effect<Span>;
@@ -14203,7 +13950,7 @@ export declare const makeSpan: (name: string, options?: SpanOptionsNoTrace) => E
  * )
  * ```
  *
- * @category Tracing
+ * @category tracing
  * @since 2.0.0
  */
 export declare const makeSpanScoped: (name: string, options?: SpanOptionsNoTrace | undefined) => Effect<Span, never, Scope>;
@@ -14229,7 +13976,7 @@ export declare const makeSpanScoped: (name: string, options?: SpanOptionsNoTrace
  * )
  * ```
  *
- * @category Tracing
+ * @category tracing
  * @since 2.0.0
  */
 export declare const useSpan: {
@@ -14255,7 +14002,7 @@ export declare const useSpan: {
      * )
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     <A, E, R>(name: string, evaluate: (span: Span) => Effect<A, E, R>): Effect<A, E, R>;
@@ -14281,7 +14028,7 @@ export declare const useSpan: {
      * )
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     <A, E, R>(name: string, options: SpanOptionsNoTrace, evaluate: (span: Span) => Effect<A, E, R>): Effect<A, E, R>;
@@ -14304,7 +14051,7 @@ export declare const useSpan: {
  * })
  * ```
  *
- * @category Tracing
+ * @category tracing
  * @since 2.0.0
  */
 export declare const withSpan: {
@@ -14326,7 +14073,7 @@ export declare const withSpan: {
      * })
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     <Args extends ReadonlyArray<any>>(name: string, options?: SpanOptionsNoTrace | ((...args: NoInfer<Args>) => SpanOptionsNoTrace) | undefined, traceOptions?: TraceOptions | undefined): <A, E, R>(self: Effect<A, E, R>, ...args: Args) => Effect<A, E, Exclude<R, ParentSpan>>;
@@ -14348,7 +14095,7 @@ export declare const withSpan: {
      * })
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     <A, E, R>(self: Effect<A, E, R>, name: string, options?: SpanOptions | undefined): Effect<A, E, Exclude<R, ParentSpan>>;
@@ -14372,7 +14119,7 @@ export declare const withSpan: {
  * )
  * ```
  *
- * @category Tracing
+ * @category tracing
  * @since 2.0.0
  */
 export declare const withSpanScoped: {
@@ -14395,7 +14142,7 @@ export declare const withSpanScoped: {
      * )
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     (name: string, options?: SpanOptions): <A, E, R>(self: Effect<A, E, R>) => Effect<A, E, Exclude<R, ParentSpan> | Scope>;
@@ -14418,7 +14165,7 @@ export declare const withSpanScoped: {
      * )
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     <A, E, R>(self: Effect<A, E, R>, name: string, options?: SpanOptions): Effect<A, E, Exclude<R, ParentSpan> | Scope>;
@@ -14439,7 +14186,7 @@ export declare const withSpanScoped: {
  * })
  * ```
  *
- * @category Tracing
+ * @category tracing
  * @since 2.0.0
  */
 export declare const withParentSpan: {
@@ -14459,7 +14206,7 @@ export declare const withParentSpan: {
      * })
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     (value: AnySpan, options?: TraceOptions): <A, E, R>(self: Effect<A, E, R>) => Effect<A, E, Exclude<R, ParentSpan>>;
@@ -14479,7 +14226,7 @@ export declare const withParentSpan: {
      * })
      * ```
      *
-     * @category Tracing
+     * @category tracing
      * @since 2.0.0
      */
     <A, E, R>(self: Effect<A, E, R>, value: AnySpan, options?: TraceOptions): Effect<A, E, Exclude<R, ParentSpan>>;
@@ -14820,7 +14567,7 @@ export declare const forkScoped: <Arg extends Effect<any, any, any> | {
  * ```
  *
  * @category Supervision & Fibers
- * @since 2.0.0
+ * @since 4.0.0
  */
 export declare const forkDetach: <Arg extends Effect<any, any, any> | {
     readonly startImmediately?: boolean | undefined;
@@ -14878,7 +14625,7 @@ export declare const fiber: Effect<Fiber<unknown, unknown>>;
  * ```
  *
  * @category Supervision & Fibers
- * @since 4.0.0
+ * @since 2.0.0
  */
 export declare const fiberId: Effect<number>;
 /**
@@ -14910,10 +14657,7 @@ export interface RunOptions {
  * **Example** (Running an Effect in the Background)
  *
  * ```ts
- * import { Effect } from "effect"
- * import { Schedule } from "effect"
- * import { Fiber } from "effect"
- * import { Console } from "effect"
+ * import { Console, Effect, Fiber, Schedule } from "effect"
  *
  * //      ┌─── Effect<number, never, never>
  * //      ▼
@@ -14941,7 +14685,7 @@ export declare const runFork: <A, E>(effect: Effect<A, E, never>, options?: RunO
  * **Example** (Usage)
  *
  * ```ts
- * import { Effect, Context } from "effect"
+ * import { Context, Effect } from "effect"
  *
  * interface Logger {
  *   log: (message: string) => void
@@ -14974,7 +14718,7 @@ export declare const runForkWith: <R>(context: Context.Context<R>) => <A, E>(eff
  * **Example** (Usage)
  *
  * ```ts
- * import { Console, Effect, Exit, Context } from "effect"
+ * import { Console, Context, Effect, Exit } from "effect"
  *
  * interface Logger {
  *   log: (message: string) => Effect.Effect<void>
@@ -15046,7 +14790,7 @@ export declare const runCallbackWith: <R>(context: Context.Context<R>) => <A, E>
  * ```
  *
  * @category Running Effects
- * @since 4.0.0
+ * @since 2.0.0
  */
 export declare const runCallback: <A, E>(effect: Effect<A, E, never>, options?: (RunOptions & {
     readonly onExit: (exit: Exit.Exit<A, E>) => void;
@@ -15095,7 +14839,7 @@ export declare const runPromise: <A, E>(effect: Effect<A, E>, options?: RunOptio
  * **Example** (Usage)
  *
  * ```ts
- * import { Effect, Context } from "effect"
+ * import { Context, Effect } from "effect"
  *
  * interface Config {
  *   apiUrl: string
@@ -15173,7 +14917,7 @@ export declare const runPromiseExit: <A, E>(effect: Effect<A, E>, options?: RunO
  * **Example** (Usage)
  *
  * ```ts
- * import { Effect, Exit, Context } from "effect"
+ * import { Context, Effect, Exit } from "effect"
  *
  * interface Database {
  *   query: (sql: string) => string
@@ -15268,7 +15012,7 @@ export declare const runSync: <A, E>(effect: Effect<A, E>) => A;
  * **Example** (Usage)
  *
  * ```ts
- * import { Effect, Context } from "effect"
+ * import { Context, Effect } from "effect"
  *
  * interface MathService {
  *   add: (a: number, b: number) => number
@@ -15371,7 +15115,7 @@ export declare const runSyncExit: <A, E>(effect: Effect<A, E>) => Exit.Exit<A, E
  * **Example** (Usage)
  *
  * ```ts
- * import { Effect, Exit, Context } from "effect"
+ * import { Context, Effect, Exit } from "effect"
  *
  * // Define a logger service
  * const Logger = Context.Service<{
@@ -15410,21 +15154,20 @@ export declare const runSyncExitWith: <R>(context: Context.Context<R>) => <A, E>
  *
  * Use these to describe generator-based signatures and traced or untraced variants.
  *
- * @category Function
- * @since 3.12.0
+ * @since 3.11.0
  */
 export declare namespace fn {
     /**
      * Generator return type accepted by `Effect.fn` and `Effect.fnUntraced`.
      *
-     * @category Models
+     * @category models
      * @since 3.19.0
      */
     type Return<A, E = never, R = never> = Generator<Effect<any, E, R>, A, any>;
     /**
      * Type of the untraced function builder used by `Effect.fnUntraced`.
      *
-     * @category Models
+     * @category models
      * @since 3.11.0
      */
     type Untraced = {
@@ -15642,8 +15385,8 @@ export declare namespace fn {
     /**
      * Type of the traced function builder used by `Effect.fn`.
      *
-     * @category Models
-     * @since 3.11.0
+     * @category models
+     * @since 4.0.0
      */
     type Traced = {
         <Eff extends Effect<any, any, any>, AEff, Args extends Array<any>>(body: (this: unassigned, ...args: Args) => Generator<Eff, AEff, never> | (Eff & Effect<AEff, any, any>)): (...args: Args) => Effect<AEff, [
@@ -16053,7 +15796,7 @@ export declare const fnUntraced: fn.Untraced;
  * ```
  *
  * @category Function
- * @since 3.12.0
+ * @since 3.11.0
  */
 export declare const fn: fn.Traced & {
     (name: string, options?: SpanOptionsNoTrace): fn.Traced;
@@ -16101,7 +15844,7 @@ export declare const clockWith: <A, E, R>(f: (clock: Clock) => Effect<A, E, R>)
  * })
  * ```
  *
- * @category Logging
+ * @category logging
  * @since 2.0.0
  */
 export declare const logWithLevel: (level?: Severity) => (...message: ReadonlyArray<any>) => Effect<void>;
@@ -16129,7 +15872,7 @@ export declare const logWithLevel: (level?: Severity) => (...message: ReadonlyAr
  * // 4
  * ```
  *
- * @category Logging
+ * @category logging
  * @since 2.0.0
  */
 export declare const log: (...message: ReadonlyArray<any>) => Effect<void>;
@@ -16158,7 +15901,7 @@ export declare const log: (...message: ReadonlyArray<any>) => Effect<void>;
  * // timestamp=2023-... level=FATAL message="System shutting down"
  * ```
  *
- * @category Logging
+ * @category logging
  * @since 2.0.0
  */
 export declare const logFatal: (...message: ReadonlyArray<any>) => Effect<void>;
@@ -16188,7 +15931,7 @@ export declare const logFatal: (...message: ReadonlyArray<any>) => Effect<void>;
  * // timestamp=2023-... level=WARN message="Using deprecated API endpoint"
  * ```
  *
- * @category Logging
+ * @category logging
  * @since 2.0.0
  */
 export declare const logWarning: (...message: ReadonlyArray<any>) => Effect<void>;
@@ -16221,7 +15964,7 @@ export declare const logWarning: (...message: ReadonlyArray<any>) => Effect<void
  * // timestamp=2023-... level=ERROR message="Caught error: Something went wrong"
  * ```
  *
- * @category Logging
+ * @category logging
  * @since 2.0.0
  */
 export declare const logError: (...message: ReadonlyArray<any>) => Effect<void>;
@@ -16249,7 +15992,7 @@ export declare const logError: (...message: ReadonlyArray<any>) => Effect<void>;
  * // timestamp=2023-... level=INFO message="Application version: 1.2.3"
  * ```
  *
- * @category Logging
+ * @category logging
  * @since 2.0.0
  */
 export declare const logInfo: (...message: ReadonlyArray<any>) => Effect<void>;
@@ -16278,7 +16021,7 @@ export declare const logInfo: (...message: ReadonlyArray<any>) => Effect<void>;
  * // timestamp=2023-... level=DEBUG message="Variable state: x=10 y=20 z=30"
  * ```
  *
- * @category Logging
+ * @category logging
  * @since 2.0.0
  */
 export declare const logDebug: (...message: ReadonlyArray<any>) => Effect<void>;
@@ -16310,7 +16053,7 @@ export declare const logDebug: (...message: ReadonlyArray<any>) => Effect<void>;
  * // timestamp=2023-... level=TRACE message="Exiting function processData"
  * ```
  *
- * @category Logging
+ * @category logging
  * @since 2.0.0
  */
 export declare const logTrace: (...message: ReadonlyArray<any>) => Effect<void>;
@@ -16339,8 +16082,8 @@ export declare const logTrace: (...message: ReadonlyArray<any>) => Effect<void>;
  * // Output includes both default and custom log outputs
  * ```
  *
- * @category Logging
- * @since 2.0.0
+ * @category logging
+ * @since 4.0.0
  */
 export declare const withLogger: (<Output>(logger: Logger<unknown, Output>) => <A, E, R>(effect: Effect<A, E, R>) => Effect<A, E, R>) & (<A, E, R, Output>(effect: Effect<A, E, R>, logger: Logger<unknown, Output>) => Effect<A, E, R>);
 /**
@@ -16370,7 +16113,7 @@ export declare const withLogger: (<Output>(logger: Logger<unknown, Output>) => <
  * // All log messages will include the userId and operation annotations
  * ```
  *
- * @category Logging
+ * @category logging
  * @since 2.0.0
  */
 export declare const annotateLogs: {
@@ -16403,8 +16146,8 @@ export declare const annotateLogs: {
  * Effect.runPromise(program)
  * ```
  *
- * @category Logging
- * @since 4.0.0
+ * @category logging
+ * @since 3.1.0
  */
 export declare const annotateLogsScoped: {
     /**
@@ -16430,8 +16173,8 @@ export declare const annotateLogsScoped: {
      * Effect.runPromise(program)
      * ```
      *
-     * @category Logging
-     * @since 4.0.0
+     * @category logging
+     * @since 3.1.0
      */
     (key: string, value: unknown): Effect<void, never, Scope>;
     /**
@@ -16457,8 +16200,8 @@ export declare const annotateLogsScoped: {
      * Effect.runPromise(program)
      * ```
      *
-     * @category Logging
-     * @since 4.0.0
+     * @category logging
+     * @since 3.1.0
      */
     (values: Record<string, unknown>): Effect<void, never, Scope>;
 };
@@ -16490,7 +16233,7 @@ export declare const annotateLogsScoped: {
  * // All log messages will include span information showing the nested operation context
  * ```
  *
- * @category Logging
+ * @category logging
  * @since 2.0.0
  */
 export declare const withLogSpan: ((label: string) => <A, E, R>(effect: Effect<A, E, R>) => Effect<A, E, R>) & (<A, E, R>(effect: Effect<A, E, R>, label: string) => Effect<A, E, R>);
@@ -17850,7 +17593,6 @@ export declare const txRetry: Effect<never, never, Transaction>;
 /**
  * Type helpers for converting callback-based functions into `Effect` functions.
  *
- * @category Effectify
  * @since 4.0.0
  */
 export declare namespace Effectify {