effect 3.10.18 → 3.11.0

package/dist/dts/Effect.d.ts

@@ -47,7 +47,7 @@ import type * as Supervisor from "./Supervisor.js";
 import type * as Tracer from "./Tracer.js";
 import type { Concurrency, Contravariant, Covariant, NoExcessProperties, NoInfer, NotFunction } from "./Types.js";
 import type * as Unify from "./Unify.js";
-import type { YieldWrap } from "./Utils.js";
+import { type YieldWrap } from "./Utils.js";
 /**
  * @since 2.0.0
  * @category Symbols
@@ -130,6 +130,9 @@ declare module "./Context.js" {
     interface Tag<Id, Value> extends Effect<Value, never, Id> {
         [Symbol.iterator](): EffectGenerator<Tag<Id, Value>>;
     }
+    interface Reference<Id, Value> extends Effect<Value> {
+        [Symbol.iterator](): EffectGenerator<Reference<Id, Value>>;
+    }
     interface TagUnifyIgnore {
         Effect?: true;
         Either?: true;
@@ -230,6 +233,7 @@ export declare const isEffect: (u: unknown) => u is Effect<unknown, unknown, unk
  * be recomputed upon next evaluation.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * let i = 1
@@ -257,6 +261,7 @@ export declare const isEffect: (u: unknown) => u is Effect<unknown, unknown, unk
  * // result 1
  * // expensive task...
  * // result 2
+ * ```
  *
  * @since 2.0.0
  * @category Caching
@@ -268,6 +273,7 @@ export declare const cachedWithTTL: {
      * be recomputed upon next evaluation.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * let i = 1
@@ -295,6 +301,7 @@ export declare const cachedWithTTL: {
      * // result 1
      * // expensive task...
      * // result 2
+     * ```
      *
      * @since 2.0.0
      * @category Caching
@@ -306,6 +313,7 @@ export declare const cachedWithTTL: {
      * be recomputed upon next evaluation.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * let i = 1
@@ -333,6 +341,7 @@ export declare const cachedWithTTL: {
      * // result 1
      * // expensive task...
      * // result 2
+     * ```
      *
      * @since 2.0.0
      * @category Caching
@@ -345,6 +354,7 @@ export declare const cachedWithTTL: {
  * invalidating the cached value before it naturally expires.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * let i = 1
@@ -375,6 +385,7 @@ export declare const cachedWithTTL: {
  * // result 1
  * // expensive task...
  * // result 2
+ * ```
  *
  * @since 2.0.0
  * @category Caching
@@ -386,6 +397,7 @@ export declare const cachedInvalidateWithTTL: {
      * invalidating the cached value before it naturally expires.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * let i = 1
@@ -416,6 +428,7 @@ export declare const cachedInvalidateWithTTL: {
      * // result 1
      * // expensive task...
      * // result 2
+     * ```
      *
      * @since 2.0.0
      * @category Caching
@@ -427,6 +440,7 @@ export declare const cachedInvalidateWithTTL: {
      * invalidating the cached value before it naturally expires.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * let i = 1
@@ -457,6 +471,7 @@ export declare const cachedInvalidateWithTTL: {
      * // result 1
      * // expensive task...
      * // result 2
+     * ```
      *
      * @since 2.0.0
      * @category Caching
@@ -469,6 +484,7 @@ export declare const cachedInvalidateWithTTL: {
  * the logic.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * let i = 1
@@ -502,6 +518,7 @@ export declare const cachedInvalidateWithTTL: {
  * // expensive task...
  * // result 3
  * // result 3
+ * ```
  *
  * @since 2.0.0
  * @category Caching
@@ -513,6 +530,7 @@ export declare const cached: <A, E, R>(self: Effect<A, E, R>) => Effect<Effect<A
  * recompute them.
  *
  * @example
+ * ```ts
  * import { Effect, Random } from "effect"
  *
  * const program = Effect.gen(function* () {
@@ -535,6 +553,7 @@ export declare const cached: <A, E, R>(self: Effect<A, E, R>) => Effect<Effect<A
  * // memoized version:
  * // 5
  * // 5
+ * ```
  *
  * @since 2.0.0
  * @category Caching
@@ -545,6 +564,7 @@ export declare const cachedFunction: <A, B, E, R>(f: (a: A) => Effect<B, E, R>,
  * called.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * const program = Effect.gen(function* () {
@@ -560,6 +580,7 @@ export declare const cachedFunction: <A, B, E, R>(f: (a: A) => Effect<B, E, R>,
  * // task1
  * // task1
  * // task2
+ * ```
  *
  * @since 2.0.0
  * @category Caching
@@ -615,6 +636,7 @@ export declare const once: <A, E, R>(self: Effect<A, E, R>) => Effect<Effect<voi
  * @see {@link forEach} for iterating over elements and applying an effect.
  *
  * @example
+ * ```ts
  * // Title: Combining Effects in Tuples
  * import { Effect, Console } from "effect"
  *
@@ -632,6 +654,7 @@ export declare const once: <A, E, R>(self: Effect<A, E, R>) => Effect<Effect<voi
  * // 42
  * // Hello
  * // [ 42, 'Hello' ]
+ * ```
  *
  * @example
  * // Title: Combining Effects in Iterables
@@ -786,6 +809,7 @@ export declare const all: <const Arg extends Iterable<Effect<any, any, any>> | R
  * your data and then apply operations to it.
  *
  * @example
+ * ```ts
  * import { Effect, pipe } from "effect"
  *
  * const task1 = Effect.succeed(1).pipe(
@@ -809,6 +833,7 @@ export declare const all: <const Arg extends Iterable<Effect<any, any, any>> | R
  * // timestamp=... level=INFO fiber=#3 message="task2 done"
  * // timestamp=... level=INFO fiber=#2 message="task1 done"
  * // [ 1, 'hello' ]
+ * ```
  *
  * @since 2.0.0
  * @category Collecting
@@ -1052,6 +1077,7 @@ export declare const filter: {
  * @see {@link filter} for concurrent filtering without mapping.
  *
  * @example
+ * ```ts
  * import { Console, Effect, Option } from "effect"
  *
  * const task = (n: number) =>
@@ -1072,6 +1098,7 @@ export declare const filter: {
  * // task3 done
  * // task4 done
  * // [ 2, 4 ]
+ * ```
  *
  * @since 2.0.0
  * @category Filtering
@@ -1088,6 +1115,7 @@ export declare const filterMap: {
      * @see {@link filter} for concurrent filtering without mapping.
      *
      * @example
+     * ```ts
      * import { Console, Effect, Option } from "effect"
      *
      * const task = (n: number) =>
@@ -1108,6 +1136,7 @@ export declare const filterMap: {
      * // task3 done
      * // task4 done
      * // [ 2, 4 ]
+     * ```
      *
      * @since 2.0.0
      * @category Filtering
@@ -1124,6 +1153,7 @@ export declare const filterMap: {
      * @see {@link filter} for concurrent filtering without mapping.
      *
      * @example
+     * ```ts
      * import { Console, Effect, Option } from "effect"
      *
      * const task = (n: number) =>
@@ -1144,6 +1174,7 @@ export declare const filterMap: {
      * // task3 done
      * // task4 done
      * // [ 2, 4 ]
+     * ```
      *
      * @since 2.0.0
      * @category Filtering
@@ -1196,6 +1227,7 @@ export declare const findFirst: {
  * @see {@link all} for combining multiple effects into one.
  *
  * @example
+ * ```ts
  * // Title: Applying Effects to Iterable Elements
  * import { Effect, Console } from "effect"
  *
@@ -1211,6 +1243,7 @@ export declare const findFirst: {
  * // Currently at index 3
  * // Currently at index 4
  * // [ 2, 4, 6, 8, 10 ]
+ * ```
  *
  * @example
  * // Title: Using discard to Ignore Results
@@ -1261,6 +1294,7 @@ export declare const forEach: {
      * @see {@link all} for combining multiple effects into one.
      *
      * @example
+     * ```ts
      * // Title: Applying Effects to Iterable Elements
      * import { Effect, Console } from "effect"
      *
@@ -1276,6 +1310,7 @@ export declare const forEach: {
      * // Currently at index 3
      * // Currently at index 4
      * // [ 2, 4, 6, 8, 10 ]
+     * ```
      *
      * @example
      * // Title: Using discard to Ignore Results
@@ -1331,6 +1366,7 @@ export declare const forEach: {
      * @see {@link all} for combining multiple effects into one.
      *
      * @example
+     * ```ts
      * // Title: Applying Effects to Iterable Elements
      * import { Effect, Console } from "effect"
      *
@@ -1346,6 +1382,7 @@ export declare const forEach: {
      * // Currently at index 3
      * // Currently at index 4
      * // [ 2, 4, 6, 8, 10 ]
+     * ```
      *
      * @example
      * // Title: Using discard to Ignore Results
@@ -1401,6 +1438,7 @@ export declare const forEach: {
      * @see {@link all} for combining multiple effects into one.
      *
      * @example
+     * ```ts
      * // Title: Applying Effects to Iterable Elements
      * import { Effect, Console } from "effect"
      *
@@ -1416,6 +1454,7 @@ export declare const forEach: {
      * // Currently at index 3
      * // Currently at index 4
      * // [ 2, 4, 6, 8, 10 ]
+     * ```
      *
      * @example
      * // Title: Using discard to Ignore Results
@@ -1471,6 +1510,7 @@ export declare const forEach: {
      * @see {@link all} for combining multiple effects into one.
      *
      * @example
+     * ```ts
      * // Title: Applying Effects to Iterable Elements
      * import { Effect, Console } from "effect"
      *
@@ -1486,6 +1526,7 @@ export declare const forEach: {
      * // Currently at index 3
      * // Currently at index 4
      * // [ 2, 4, 6, 8, 10 ]
+     * ```
      *
      * @example
      * // Title: Using discard to Ignore Results
@@ -1575,6 +1616,7 @@ export declare const mergeAll: {
  * @see {@link validateFirst} for a function that stops at the first success.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * //      ┌─── Effect<[string[], number[]], never, never>
@@ -1590,6 +1632,7 @@ export declare const mergeAll: {
  * Effect.runPromise(program).then(console.log, console.error)
  * // Output:
  * // [ [ '1 is not even', '3 is not even' ], [ 0, 2, 4 ] ]
+ * ```
  *
  * @since 2.0.0
  * @category Error Accumulation
@@ -1611,6 +1654,7 @@ export declare const partition: {
      * @see {@link validateFirst} for a function that stops at the first success.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * //      ┌─── Effect<[string[], number[]], never, never>
@@ -1626,6 +1670,7 @@ export declare const partition: {
      * Effect.runPromise(program).then(console.log, console.error)
      * // Output:
      * // [ [ '1 is not even', '3 is not even' ], [ 0, 2, 4 ] ]
+     * ```
      *
      * @since 2.0.0
      * @category Error Accumulation
@@ -1651,6 +1696,7 @@ export declare const partition: {
      * @see {@link validateFirst} for a function that stops at the first success.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * //      ┌─── Effect<[string[], number[]], never, never>
@@ -1666,6 +1712,7 @@ export declare const partition: {
      * Effect.runPromise(program).then(console.log, console.error)
      * // Output:
      * // [ [ '1 is not even', '3 is not even' ], [ 0, 2, 4 ] ]
+     * ```
      *
      * @since 2.0.0
      * @category Error Accumulation
@@ -1925,6 +1972,7 @@ export declare const takeWhile: {
  * @see {@link partition} when you need to separate successes and failures instead of losing successes with errors.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * //      ┌─── Effect<number[], string[], never>
@@ -1951,6 +1999,7 @@ export declare const takeWhile: {
  * //     failure: [ '4 is not less that 4', '5 is not less that 4' ]
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Error Accumulation
@@ -1973,6 +2022,7 @@ export declare const validateAll: {
      * @see {@link partition} when you need to separate successes and failures instead of losing successes with errors.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * //      ┌─── Effect<number[], string[], never>
@@ -1999,6 +2049,7 @@ export declare const validateAll: {
      * //     failure: [ '4 is not less that 4', '5 is not less that 4' ]
      * //   }
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category Error Accumulation
@@ -2026,6 +2077,7 @@ export declare const validateAll: {
      * @see {@link partition} when you need to separate successes and failures instead of losing successes with errors.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * //      ┌─── Effect<number[], string[], never>
@@ -2052,6 +2104,7 @@ export declare const validateAll: {
      * //     failure: [ '4 is not less that 4', '5 is not less that 4' ]
      * //   }
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category Error Accumulation
@@ -2079,6 +2132,7 @@ export declare const validateAll: {
      * @see {@link partition} when you need to separate successes and failures instead of losing successes with errors.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * //      ┌─── Effect<number[], string[], never>
@@ -2105,6 +2159,7 @@ export declare const validateAll: {
      * //     failure: [ '4 is not less that 4', '5 is not less that 4' ]
      * //   }
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category Error Accumulation
@@ -2132,6 +2187,7 @@ export declare const validateAll: {
      * @see {@link partition} when you need to separate successes and failures instead of losing successes with errors.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * //      ┌─── Effect<number[], string[], never>
@@ -2158,6 +2214,7 @@ export declare const validateAll: {
      * //     failure: [ '4 is not less that 4', '5 is not less that 4' ]
      * //   }
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category Error Accumulation
@@ -2185,6 +2242,7 @@ export declare const validateAll: {
  * @see {@link firstSuccessOf} for a similar function that processes multiple effects and returns the first successful one or the last error.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * //      ┌─── Effect<number, string[], never>
@@ -2201,6 +2259,7 @@ export declare const validateAll: {
  * // Output:
  * // item 4
  * // 4
+ * ```
  *
  * @since 2.0.0
  * @category Error Accumulation
@@ -2222,6 +2281,7 @@ export declare const validateFirst: {
      * @see {@link firstSuccessOf} for a similar function that processes multiple effects and returns the first successful one or the last error.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * //      ┌─── Effect<number, string[], never>
@@ -2238,6 +2298,7 @@ export declare const validateFirst: {
      * // Output:
      * // item 4
      * // 4
+     * ```
      *
      * @since 2.0.0
      * @category Error Accumulation
@@ -2263,6 +2324,7 @@ export declare const validateFirst: {
      * @see {@link firstSuccessOf} for a similar function that processes multiple effects and returns the first successful one or the last error.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * //      ┌─── Effect<number, string[], never>
@@ -2279,6 +2341,7 @@ export declare const validateFirst: {
      * // Output:
      * // item 4
      * // 4
+     * ```
      *
      * @since 2.0.0
      * @category Error Accumulation
@@ -2314,6 +2377,7 @@ export declare const validateFirst: {
  * behavior of the returned effect.
  *
  * @example
+ * ```ts
  * // Title: Wrapping a Callback API
  * import { Effect } from "effect"
  * import * as NodeFS from "node:fs"
@@ -2334,6 +2398,7 @@ export declare const validateFirst: {
  * //      ┌─── Effect<Buffer, Error, never>
  * //      ▼
  * const program = readFile("example.txt")
+ * ```
  *
  * @example
  * // Title: Handling Interruption with Cleanup
@@ -2424,12 +2489,14 @@ export declare const asyncEffect: <A, E, R, R3, E2, R2>(register: (callback: (_:
  * the "this" of the effect.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const throwingFunction = () => { throw new Error() }
  * const blowUp = Effect.custom(throwingFunction, function() {
  *   return Effect.succeed(this.effect_instruction_i0())
  * })
+ * ```
  *
  * @since 2.0.0
  * @category Creating Effects
@@ -2442,12 +2509,14 @@ export declare const custom: {
      * the "this" of the effect.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const throwingFunction = () => { throw new Error() }
      * const blowUp = Effect.custom(throwingFunction, function() {
      *   return Effect.succeed(this.effect_instruction_i0())
      * })
+     * ```
      *
      * @since 2.0.0
      * @category Creating Effects
@@ -2462,12 +2531,14 @@ export declare const custom: {
      * the "this" of the effect.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const throwingFunction = () => { throw new Error() }
      * const blowUp = Effect.custom(throwingFunction, function() {
      *   return Effect.succeed(this.effect_instruction_i0())
      * })
+     * ```
      *
      * @since 2.0.0
      * @category Creating Effects
@@ -2483,12 +2554,14 @@ export declare const custom: {
      * the "this" of the effect.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const throwingFunction = () => { throw new Error() }
      * const blowUp = Effect.custom(throwingFunction, function() {
      *   return Effect.succeed(this.effect_instruction_i0())
      * })
+     * ```
      *
      * @since 2.0.0
      * @category Creating Effects
@@ -2516,6 +2589,7 @@ export declare const withFiberRuntime: <A, E = never, R = never>(withRuntime: (f
  * @see {@link succeed} to create an effect that represents a successful value.
  *
  * @example
+ * ```ts
  * // Title: Creating a Failed Effect
  * import { Effect } from "effect"
  *
@@ -2524,6 +2598,7 @@ export declare const withFiberRuntime: <A, E = never, R = never>(withRuntime: (f
  * const failure = Effect.fail(
  *   new Error("Operation failed due to network error")
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Creating Effects
@@ -2565,6 +2640,7 @@ export declare const failCauseSync: <E>(evaluate: LazyArg<Cause.Cause<E>>) => Ef
  * @see {@link dieMessage} for a variant that throws a `RuntimeException` with a message.
  *
  * @example
+ * ```ts
  * // Title: Terminating on Division by Zero with a Specified Error
  * import { Effect } from "effect"
  *
@@ -2581,6 +2657,7 @@ export declare const failCauseSync: <E>(evaluate: LazyArg<Cause.Cause<E>>) => Ef
  * // Output:
  * // (FiberFailure) Error: Cannot divide by zero
  * //   ...stack trace...
+ * ```
  *
  * @since 2.0.0
  * @category Creating Effects
@@ -2609,6 +2686,7 @@ export declare const die: (defect: unknown) => Effect<never>;
  * lazily.
  *
  * @example
+ * ```ts
  * // Title: Terminating on Division by Zero with a Specified Message
  * import { Effect } from "effect"
  *
@@ -2625,6 +2703,7 @@ export declare const die: (defect: unknown) => Effect<never>;
  * // Output:
  * // (FiberFailure) RuntimeException: Cannot divide by zero
  * //   ...stack trace...
+ * ```
  *
  * @since 2.0.0
  * @category Creating Effects
@@ -2658,6 +2737,7 @@ export declare const dieSync: (evaluate: LazyArg<unknown>) => Effect<never>;
  * effects and return the final result at the end.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const addServiceCharge = (amount: number) => amount + 1
@@ -2684,6 +2764,7 @@ export declare const dieSync: (evaluate: LazyArg<unknown>) => Effect<never>;
  *   const finalAmount = addServiceCharge(discountedAmount)
  *   return `Final amount to charge: ${finalAmount}`
  * })
+ * ```
  *
  * @since 2.0.0
  * @category Creating Effects
@@ -2705,6 +2786,7 @@ export declare const gen: {
      * effects and return the final result at the end.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const addServiceCharge = (amount: number) => amount + 1
@@ -2731,6 +2813,7 @@ export declare const gen: {
      *   const finalAmount = addServiceCharge(discountedAmount)
      *   return `Final amount to charge: ${finalAmount}`
      * })
+     * ```
      *
      * @since 2.0.0
      * @category Creating Effects
@@ -2756,6 +2839,7 @@ export declare const gen: {
      * effects and return the final result at the end.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const addServiceCharge = (amount: number) => amount + 1
@@ -2782,6 +2866,7 @@ export declare const gen: {
      *   const finalAmount = addServiceCharge(discountedAmount)
      *   return `Final amount to charge: ${finalAmount}`
      * })
+     * ```
      *
      * @since 2.0.0
      * @category Creating Effects
@@ -2860,6 +2945,7 @@ export declare const none: <A, E, R>(self: Effect<Option.Option<A>, E, R>) => Ef
  * @see {@link tryPromise} for a version that can handle failures.
  *
  * @example
+ * ```ts
  * // Title: Delayed Message
  * import { Effect } from "effect"
  *
@@ -2876,6 +2962,7 @@ export declare const none: <A, E, R>(self: Effect<Option.Option<A>, E, R>) => Ef
  * //      ┌─── Effect<string, never, never>
  * //      ▼
  * const program = delay("Async operation completed successfully!")
+ * ```
  *
  * @since 2.0.0
  * @category Creating Effects
@@ -2892,6 +2979,7 @@ export declare const promise: <A>(evaluate: (signal: AbortSignal) => PromiseLike
  * @see {@link fail} to create an effect that represents a failure.
  *
  * @example
+ * ```ts
  * // Title: Creating a Successful Effect
  * import { Effect } from "effect"
  *
@@ -2900,6 +2988,7 @@ export declare const promise: <A>(evaluate: (signal: AbortSignal) => PromiseLike
  * //      ┌─── Effect<number, never, never>
  * //      ▼
  * const success = Effect.succeed(42)
+ * ```
  *
  * @since 2.0.0
  * @category Creating Effects
@@ -2934,6 +3023,7 @@ export declare const succeedSome: <A>(value: A) => Effect<Option.Option<A>>;
  * - **Unifying Return Types**: Can help TypeScript unify return types in situations where multiple branches of logic return different effects, simplifying type inference.
  *
  * @example
+ * ```ts
  * // Title: Lazy Evaluation with Side Effects
  * import { Effect } from "effect"
  *
@@ -2948,6 +3038,7 @@ export declare const succeedSome: <A>(value: A) => Effect<Option.Option<A>>;
  *
  * console.log(Effect.runSync(good)) // Output: 1
  * console.log(Effect.runSync(good)) // Output: 2
+ * ```
  *
  * @example
  * // Title: Recursive Fibonacci
@@ -3020,6 +3111,7 @@ export declare const suspend: <A, E, R>(effect: LazyArg<Effect<A, E, R>>) => Eff
  * @see {@link try_ | try} for a version that can handle failures.
  *
  * @example
+ * ```ts
  * // Title: Logging a Message
  * import { Effect } from "effect"
  *
@@ -3031,6 +3123,7 @@ export declare const suspend: <A, E, R>(effect: LazyArg<Effect<A, E, R>>) => Eff
  * //      ┌─── Effect<void, never, never>
  * //      ▼
  * const program = log("Hello, World!")
+ * ```
  *
  * @since 2.0.0
  * @category Creating Effects
@@ -3092,6 +3185,7 @@ _catch as catch };
  * @see {@link catchAllCause} for a version that can recover from both recoverable and unrecoverable errors.
  *
  * @example
+ * ```ts
  * // Title: Providing Recovery Logic for Recoverable Errors
  * import { Effect, Random } from "effect"
  *
@@ -3124,6 +3218,7 @@ _catch as catch };
  *     Effect.succeed(`Recovering from ${error._tag}`)
  *   )
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -3145,6 +3240,7 @@ export declare const catchAll: {
      * @see {@link catchAllCause} for a version that can recover from both recoverable and unrecoverable errors.
      *
      * @example
+     * ```ts
      * // Title: Providing Recovery Logic for Recoverable Errors
      * import { Effect, Random } from "effect"
      *
@@ -3177,6 +3273,7 @@ export declare const catchAll: {
      *     Effect.succeed(`Recovering from ${error._tag}`)
      *   )
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -3198,6 +3295,7 @@ export declare const catchAll: {
      * @see {@link catchAllCause} for a version that can recover from both recoverable and unrecoverable errors.
      *
      * @example
+     * ```ts
      * // Title: Providing Recovery Logic for Recoverable Errors
      * import { Effect, Random } from "effect"
      *
@@ -3230,6 +3328,7 @@ export declare const catchAll: {
      *     Effect.succeed(`Recovering from ${error._tag}`)
      *   )
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -3254,6 +3353,7 @@ export declare const catchAll: {
  * dynamically loaded plugins, controlled recovery might be needed.
  *
  * @example
+ * ```ts
  * // Title: Recovering from All Errors
  * import { Cause, Effect } from "effect"
  *
@@ -3271,6 +3371,7 @@ export declare const catchAll: {
  *
  * Effect.runPromise(recovered).then(console.log)
  * // Output: "Recovered from a regular error"
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -3294,6 +3395,7 @@ export declare const catchAllCause: {
      * dynamically loaded plugins, controlled recovery might be needed.
      *
      * @example
+     * ```ts
      * // Title: Recovering from All Errors
      * import { Cause, Effect } from "effect"
      *
@@ -3311,6 +3413,7 @@ export declare const catchAllCause: {
      *
      * Effect.runPromise(recovered).then(console.log)
      * // Output: "Recovered from a regular error"
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -3334,6 +3437,7 @@ export declare const catchAllCause: {
      * dynamically loaded plugins, controlled recovery might be needed.
      *
      * @example
+     * ```ts
      * // Title: Recovering from All Errors
      * import { Cause, Effect } from "effect"
      *
@@ -3351,6 +3455,7 @@ export declare const catchAllCause: {
      *
      * Effect.runPromise(recovered).then(console.log)
      * // Output: "Recovered from a regular error"
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -3381,6 +3486,7 @@ export declare const catchAllCause: {
  * dynamically loaded plugins, controlled recovery might be needed.
  *
  * @example
+ * ```ts
  * // Title: Handling All Defects
  * import { Effect, Cause, Console } from "effect"
  *
@@ -3405,6 +3511,7 @@ export declare const catchAllCause: {
  * //   _tag: "Success",
  * //   value: undefined
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -3434,6 +3541,7 @@ export declare const catchAllDefect: {
      * dynamically loaded plugins, controlled recovery might be needed.
      *
      * @example
+     * ```ts
      * // Title: Handling All Defects
      * import { Effect, Cause, Console } from "effect"
      *
@@ -3458,6 +3566,7 @@ export declare const catchAllDefect: {
      * //   _tag: "Success",
      * //   value: undefined
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -3487,6 +3596,7 @@ export declare const catchAllDefect: {
      * dynamically loaded plugins, controlled recovery might be needed.
      *
      * @example
+     * ```ts
      * // Title: Handling All Defects
      * import { Effect, Cause, Console } from "effect"
      *
@@ -3511,6 +3621,7 @@ export declare const catchAllDefect: {
      * //   _tag: "Success",
      * //   value: undefined
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -3529,6 +3640,7 @@ export declare const catchAllDefect: {
  * error type unless a user-defined type guard is used to narrow the type.
  *
  * @example
+ * ```ts
  * // Title: Catching Specific Errors with a Predicate
  * import { Effect, Random } from "effect"
  *
@@ -3563,6 +3675,7 @@ export declare const catchAllDefect: {
  *     () => Effect.succeed("Recovering from HttpError")
  *   )
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -3580,6 +3693,7 @@ export declare const catchIf: {
      * error type unless a user-defined type guard is used to narrow the type.
      *
      * @example
+     * ```ts
      * // Title: Catching Specific Errors with a Predicate
      * import { Effect, Random } from "effect"
      *
@@ -3614,6 +3728,7 @@ export declare const catchIf: {
      *     () => Effect.succeed("Recovering from HttpError")
      *   )
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -3631,6 +3746,7 @@ export declare const catchIf: {
      * error type unless a user-defined type guard is used to narrow the type.
      *
      * @example
+     * ```ts
      * // Title: Catching Specific Errors with a Predicate
      * import { Effect, Random } from "effect"
      *
@@ -3665,6 +3781,7 @@ export declare const catchIf: {
      *     () => Effect.succeed("Recovering from HttpError")
      *   )
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -3682,6 +3799,7 @@ export declare const catchIf: {
      * error type unless a user-defined type guard is used to narrow the type.
      *
      * @example
+     * ```ts
      * // Title: Catching Specific Errors with a Predicate
      * import { Effect, Random } from "effect"
      *
@@ -3716,6 +3834,7 @@ export declare const catchIf: {
      *     () => Effect.succeed("Recovering from HttpError")
      *   )
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -3733,6 +3852,7 @@ export declare const catchIf: {
      * error type unless a user-defined type guard is used to narrow the type.
      *
      * @example
+     * ```ts
      * // Title: Catching Specific Errors with a Predicate
      * import { Effect, Random } from "effect"
      *
@@ -3767,6 +3887,7 @@ export declare const catchIf: {
      *     () => Effect.succeed("Recovering from HttpError")
      *   )
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -3788,6 +3909,7 @@ export declare const catchIf: {
  * @see {@link catchIf} for a version that allows you to recover from errors based on a predicate.
  *
  * @example
+ * ```ts
  * // Title: Handling Specific Errors with Effect.catchSome
  * import { Effect, Random, Option } from "effect"
  *
@@ -3825,6 +3947,7 @@ export declare const catchIf: {
  *     }
  *   })
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -3845,6 +3968,7 @@ export declare const catchSome: {
      * @see {@link catchIf} for a version that allows you to recover from errors based on a predicate.
      *
      * @example
+     * ```ts
      * // Title: Handling Specific Errors with Effect.catchSome
      * import { Effect, Random, Option } from "effect"
      *
@@ -3882,6 +4006,7 @@ export declare const catchSome: {
      *     }
      *   })
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -3902,6 +4027,7 @@ export declare const catchSome: {
      * @see {@link catchIf} for a version that allows you to recover from errors based on a predicate.
      *
      * @example
+     * ```ts
      * // Title: Handling Specific Errors with Effect.catchSome
      * import { Effect, Random, Option } from "effect"
      *
@@ -3939,6 +4065,7 @@ export declare const catchSome: {
      *     }
      *   })
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -3994,6 +4121,7 @@ export declare const catchSomeCause: {
  * - If the defect does not match, the function returns `Option.none`, allowing the defect to propagate.
  *
  * @example
+ * ```ts
  * // Title: Handling Specific Defects
  * import { Effect, Cause, Option, Console } from "effect"
  *
@@ -4024,6 +4152,7 @@ export declare const catchSomeCause: {
  * //     defect: { _tag: 'RuntimeException' }
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -4056,6 +4185,7 @@ export declare const catchSomeDefect: {
      * - If the defect does not match, the function returns `Option.none`, allowing the defect to propagate.
      *
      * @example
+     * ```ts
      * // Title: Handling Specific Defects
      * import { Effect, Cause, Option, Console } from "effect"
      *
@@ -4086,6 +4216,7 @@ export declare const catchSomeDefect: {
      * //     defect: { _tag: 'RuntimeException' }
      * //   }
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -4118,6 +4249,7 @@ export declare const catchSomeDefect: {
      * - If the defect does not match, the function returns `Option.none`, allowing the defect to propagate.
      *
      * @example
+     * ```ts
      * // Title: Handling Specific Defects
      * import { Effect, Cause, Option, Console } from "effect"
      *
@@ -4148,6 +4280,7 @@ export declare const catchSomeDefect: {
      * //     defect: { _tag: 'RuntimeException' }
      * //   }
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -4172,6 +4305,7 @@ export declare const catchSomeDefect: {
  * types at once.
  *
  * @example
+ * ```ts
  * // Title: Handling Errors by Tag
  * import { Effect, Random } from "effect"
  *
@@ -4205,6 +4339,7 @@ export declare const catchSomeDefect: {
  *     Effect.succeed("Recovering from HttpError")
  *   )
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -4228,6 +4363,7 @@ export declare const catchTag: {
      * types at once.
      *
      * @example
+     * ```ts
      * // Title: Handling Errors by Tag
      * import { Effect, Random } from "effect"
      *
@@ -4261,6 +4397,7 @@ export declare const catchTag: {
      *     Effect.succeed("Recovering from HttpError")
      *   )
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -4290,6 +4427,7 @@ export declare const catchTag: {
      * types at once.
      *
      * @example
+     * ```ts
      * // Title: Handling Errors by Tag
      * import { Effect, Random } from "effect"
      *
@@ -4323,6 +4461,7 @@ export declare const catchTag: {
      *     Effect.succeed("Recovering from HttpError")
      *   )
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -4350,6 +4489,7 @@ export declare const catchTag: {
  * field is used to identify and match errors.
  *
  * @example
+ * ```ts
  * // Title: Handling Multiple Tagged Error Types at Once
  * import { Effect, Random } from "effect"
  *
@@ -4385,6 +4525,7 @@ export declare const catchTag: {
  *       Effect.succeed(`Recovering from ValidationError`)
  *   })
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -4405,6 +4546,7 @@ export declare const catchTags: {
      * field is used to identify and match errors.
      *
      * @example
+     * ```ts
      * // Title: Handling Multiple Tagged Error Types at Once
      * import { Effect, Random } from "effect"
      *
@@ -4440,6 +4582,7 @@ export declare const catchTags: {
      *       Effect.succeed(`Recovering from ValidationError`)
      *   })
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -4478,6 +4621,7 @@ export declare const catchTags: {
      * field is used to identify and match errors.
      *
      * @example
+     * ```ts
      * // Title: Handling Multiple Tagged Error Types at Once
      * import { Effect, Random } from "effect"
      *
@@ -4513,6 +4657,7 @@ export declare const catchTags: {
      *       Effect.succeed(`Recovering from ValidationError`)
      *   })
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -4549,6 +4694,7 @@ export declare const catchTags: {
  * interruptions, etc.).
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * //      ┌─── Effect<number, string, never>
@@ -4561,6 +4707,7 @@ export declare const catchTags: {
  *   const cause = yield* Effect.cause(program)
  *   yield* Console.log(cause)
  * })
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -4582,6 +4729,7 @@ export declare const eventually: <A, E, R>(self: Effect<A, E, R>) => Effect<A, n
  * side effects of the effect and do not need to handle or process its outcome.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * //      ┌─── Effect<number, string, never>
@@ -4591,6 +4739,7 @@ export declare const eventually: <A, E, R>(self: Effect<A, E, R>) => Effect<A, n
  * //      ┌─── Effect<void, never, never>
  * //      ▼
  * const program = Effect.ignore(task)
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -4616,6 +4765,7 @@ export declare const ignoreLogged: <A, E, R>(self: Effect<A, E, R>) => Effect<vo
  * it easier to manage and respond to errors from multiple operations at once.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const fail1 = Effect.fail("Oh uh!")
@@ -4634,6 +4784,7 @@ export declare const ignoreLogged: <A, E, R>(self: Effect<A, E, R>) => Effect<vo
  * //   _tag: 'Failure',
  * //   cause: { _id: 'Cause', _tag: 'Fail', failure: [ 'Oh uh!', 'Oh no!' ] }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -4655,6 +4806,7 @@ export declare const parallelErrors: <A, E, R>(self: Effect<A, E, R>) => Effect<
  * @see {@link unsandbox} to restore the original error handling.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * //      ┌─── Effect<string, Error, never>
@@ -4689,6 +4841,7 @@ export declare const parallelErrors: <A, E, R>(self: Effect<A, E, R>) => Effect<
  * // Output:
  * // Caught a defect: Oh uh!
  * // fallback result on failure
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -4746,6 +4899,7 @@ export declare namespace Retry {
  * @see {@link retryOrElse} for a version that allows you to run a fallback.
  *
  * @example
+ * ```ts
  * import { Effect, Schedule } from "effect"
  *
  * let count = 0
@@ -4774,6 +4928,7 @@ export declare namespace Retry {
  * // failure
  * // success
  * // yay!
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -4796,6 +4951,7 @@ export declare const retry: {
      * @see {@link retryOrElse} for a version that allows you to run a fallback.
      *
      * @example
+     * ```ts
      * import { Effect, Schedule } from "effect"
      *
      * let count = 0
@@ -4824,6 +4980,7 @@ export declare const retry: {
      * // failure
      * // success
      * // yay!
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -4846,6 +5003,7 @@ export declare const retry: {
      * @see {@link retryOrElse} for a version that allows you to run a fallback.
      *
      * @example
+     * ```ts
      * import { Effect, Schedule } from "effect"
      *
      * let count = 0
@@ -4874,6 +5032,7 @@ export declare const retry: {
      * // failure
      * // success
      * // yay!
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -4896,6 +5055,7 @@ export declare const retry: {
      * @see {@link retryOrElse} for a version that allows you to run a fallback.
      *
      * @example
+     * ```ts
      * import { Effect, Schedule } from "effect"
      *
      * let count = 0
@@ -4924,6 +5084,7 @@ export declare const retry: {
      * // failure
      * // success
      * // yay!
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -4946,6 +5107,7 @@ export declare const retry: {
      * @see {@link retryOrElse} for a version that allows you to run a fallback.
      *
      * @example
+     * ```ts
      * import { Effect, Schedule } from "effect"
      *
      * let count = 0
@@ -4974,6 +5136,7 @@ export declare const retry: {
      * // failure
      * // success
      * // yay!
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -4992,6 +5155,7 @@ export declare const retry: {
  * @see {@link retry} for a version that does not run a fallback effect.
  *
  * @example
+ * ```ts
  * import { Effect, Schedule, Console } from "effect"
  *
  * let count = 0
@@ -5023,6 +5187,7 @@ export declare const retry: {
  * // failure
  * // orElse
  * // default value
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -5040,6 +5205,7 @@ export declare const retryOrElse: {
      * @see {@link retry} for a version that does not run a fallback effect.
      *
      * @example
+     * ```ts
      * import { Effect, Schedule, Console } from "effect"
      *
      * let count = 0
@@ -5071,6 +5237,7 @@ export declare const retryOrElse: {
      * // failure
      * // orElse
      * // default value
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -5088,6 +5255,7 @@ export declare const retryOrElse: {
      * @see {@link retry} for a version that does not run a fallback effect.
      *
      * @example
+     * ```ts
      * import { Effect, Schedule, Console } from "effect"
      *
      * let count = 0
@@ -5119,6 +5287,7 @@ export declare const retryOrElse: {
      * // failure
      * // orElse
      * // default value
+     * ```
      *
      * @since 2.0.0
      * @category Error handling
@@ -5157,6 +5326,7 @@ export {
  * throw errors.
  *
  * @example
+ * ```ts
  * // Title: Safe JSON Parsing
  * import { Effect } from "effect"
  *
@@ -5168,6 +5338,7 @@ export {
  * //      ▼
  * const program = parse("")
  *
+ * ```
  * @example
  * // Title: Custom Error Handling
  * import { Effect } from "effect"
@@ -5294,6 +5465,7 @@ export declare const tryMapPromise: {
  * @see {@link promise} if the effectful computation is asynchronous and does not throw errors.
  *
  * @example
+ * ```ts
  * // Title: Fetching a TODO Item
  * import { Effect } from "effect"
  *
@@ -5306,6 +5478,7 @@ export declare const tryMapPromise: {
  * //      ┌─── Effect<Response, UnknownException, never>
  * //      ▼
  * const program = getTodo(1)
+ * ```
  *
  * @example
  * // Title: Custom Error Handling
@@ -5355,6 +5528,7 @@ export declare const tryPromise: {
      * @see {@link promise} if the effectful computation is asynchronous and does not throw errors.
      *
      * @example
+     * ```ts
      * // Title: Fetching a TODO Item
      * import { Effect } from "effect"
      *
@@ -5367,6 +5541,7 @@ export declare const tryPromise: {
      * //      ┌─── Effect<Response, UnknownException, never>
      * //      ▼
      * const program = getTodo(1)
+     * ```
      *
      * @example
      * // Title: Custom Error Handling
@@ -5419,6 +5594,7 @@ export declare const tryPromise: {
      * @see {@link promise} if the effectful computation is asynchronous and does not throw errors.
      *
      * @example
+     * ```ts
      * // Title: Fetching a TODO Item
      * import { Effect } from "effect"
      *
@@ -5431,6 +5607,7 @@ export declare const tryPromise: {
      * //      ┌─── Effect<Response, UnknownException, never>
      * //      ▼
      * const program = getTodo(1)
+     * ```
      *
      * @example
      * // Title: Custom Error Handling
@@ -5514,6 +5691,7 @@ export declare const checkInterruptible: <A, E, R>(f: (isInterruptible: boolean)
  * @see {@link Effect.uninterruptible} for creating an uninterruptible effect.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const longRunningTask = Effect.gen(function* () {
@@ -5543,6 +5721,7 @@ export declare const checkInterruptible: <A, E, R>(f: (isInterruptible: boolean)
  * //   }
  * // }
  * // Heavy processing done.
+ * ```
  *
  * @since 2.0.0
  * @category Interruption
@@ -5599,6 +5778,7 @@ export declare const uninterruptibleMask: <A, E, R>(f: (restore: <AX, EX, RX>(ef
  * or failing with specified error if the predicate fails
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const isPositive = (n: number): boolean => n > 0
@@ -5608,6 +5788,7 @@ export declare const uninterruptibleMask: <A, E, R>(f: (restore: <AX, EX, RX>(ef
  *
  * // fails with `"0 is not positive"`
  * Effect.liftPredicate(0, isPositive, n => `${n} is not positive`)
+ * ```
  *
  * @category Condition Checking
  * @since 3.4.0
@@ -5618,6 +5799,7 @@ export declare const liftPredicate: {
      * or failing with specified error if the predicate fails
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const isPositive = (n: number): boolean => n > 0
@@ -5627,6 +5809,7 @@ export declare const liftPredicate: {
      *
      * // fails with `"0 is not positive"`
      * Effect.liftPredicate(0, isPositive, n => `${n} is not positive`)
+     * ```
      *
      * @category Condition Checking
      * @since 3.4.0
@@ -5637,6 +5820,7 @@ export declare const liftPredicate: {
      * or failing with specified error if the predicate fails
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const isPositive = (n: number): boolean => n > 0
@@ -5646,6 +5830,7 @@ export declare const liftPredicate: {
      *
      * // fails with `"0 is not positive"`
      * Effect.liftPredicate(0, isPositive, n => `${n} is not positive`)
+     * ```
      *
      * @category Condition Checking
      * @since 3.4.0
@@ -5656,6 +5841,7 @@ export declare const liftPredicate: {
      * or failing with specified error if the predicate fails
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const isPositive = (n: number): boolean => n > 0
@@ -5665,6 +5851,7 @@ export declare const liftPredicate: {
      *
      * // fails with `"0 is not positive"`
      * Effect.liftPredicate(0, isPositive, n => `${n} is not positive`)
+     * ```
      *
      * @category Condition Checking
      * @since 3.4.0
@@ -5675,6 +5862,7 @@ export declare const liftPredicate: {
      * or failing with specified error if the predicate fails
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const isPositive = (n: number): boolean => n > 0
@@ -5684,6 +5872,7 @@ export declare const liftPredicate: {
      *
      * // fails with `"0 is not positive"`
      * Effect.liftPredicate(0, isPositive, n => `${n} is not positive`)
+     * ```
      *
      * @category Condition Checking
      * @since 3.4.0
@@ -5697,6 +5886,7 @@ export declare const liftPredicate: {
  * replace it with a new constant value.
  *
  * @example
+ * ```ts
  * // Title: Replacing a Value
  * import { pipe, Effect } from "effect"
  *
@@ -5705,6 +5895,7 @@ export declare const liftPredicate: {
  *
  * Effect.runPromise(program).then(console.log)
  * // Output: "new value"
+ * ```
  *
  * @since 2.0.0
  * @category Mapping
@@ -5717,6 +5908,7 @@ export declare const as: {
      * replace it with a new constant value.
      *
      * @example
+     * ```ts
      * // Title: Replacing a Value
      * import { pipe, Effect } from "effect"
      *
@@ -5725,6 +5917,7 @@ export declare const as: {
      *
      * Effect.runPromise(program).then(console.log)
      * // Output: "new value"
+     * ```
      *
      * @since 2.0.0
      * @category Mapping
@@ -5737,6 +5930,7 @@ export declare const as: {
      * replace it with a new constant value.
      *
      * @example
+     * ```ts
      * // Title: Replacing a Value
      * import { pipe, Effect } from "effect"
      *
@@ -5745,6 +5939,7 @@ export declare const as: {
      *
      * Effect.runPromise(program).then(console.log)
      * // Output: "new value"
+     * ```
      *
      * @since 2.0.0
      * @category Mapping
@@ -5789,6 +5984,7 @@ export declare const asVoid: <A, E, R>(self: Effect<A, E, R>) => Effect<void, E,
  * treat an error as a valid result.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * //      ┌─── Effect<number, string, never>
@@ -5798,6 +5994,7 @@ export declare const asVoid: <A, E, R>(self: Effect<A, E, R>) => Effect<void, E,
  * //      ┌─── Effect<string, number, never>
  * //      ▼
  * const flipped = Effect.flip(program)
+ * ```
  *
  * @since 2.0.0
  * @category Mapping
@@ -5855,6 +6052,7 @@ export declare const flipWith: {
  * @see {@link flatMap} or {@link andThen} for a version that can return a new effect.
  *
  * @example
+ * ```ts
  * // Title: Adding a Service Charge
  * import { pipe, Effect } from "effect"
  *
@@ -5869,6 +6067,7 @@ export declare const flipWith: {
  *
  * Effect.runPromise(finalAmount).then(console.log)
  * // Output: 101
+ * ```
  * @since 2.0.0
  * @category Mapping
  */
@@ -5900,6 +6099,7 @@ export declare const map: {
      * @see {@link flatMap} or {@link andThen} for a version that can return a new effect.
      *
      * @example
+     * ```ts
      * // Title: Adding a Service Charge
      * import { pipe, Effect } from "effect"
      *
@@ -5914,6 +6114,7 @@ export declare const map: {
      *
      * Effect.runPromise(finalAmount).then(console.log)
      * // Output: 101
+     * ```
      * @since 2.0.0
      * @category Mapping
      */
@@ -5945,6 +6146,7 @@ export declare const map: {
      * @see {@link flatMap} or {@link andThen} for a version that can return a new effect.
      *
      * @example
+     * ```ts
      * // Title: Adding a Service Charge
      * import { pipe, Effect } from "effect"
      *
@@ -5959,6 +6161,7 @@ export declare const map: {
      *
      * Effect.runPromise(finalAmount).then(console.log)
      * // Output: 101
+     * ```
      * @since 2.0.0
      * @category Mapping
      */
@@ -5984,6 +6187,7 @@ export declare const map: {
  * input collection type.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * // Define an initial state and a transformation function
@@ -6002,6 +6206,7 @@ export declare const map: {
  * // Output:
  * // 6
  * // [ 'A', 'BB', 'CCC' ]
+ * ```
  *
  * @since 2.0.0
  * @category Mapping
@@ -6027,6 +6232,7 @@ export declare const mapAccum: {
      * input collection type.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * // Define an initial state and a transformation function
@@ -6045,6 +6251,7 @@ export declare const mapAccum: {
      * // Output:
      * // 6
      * // [ 'A', 'BB', 'CCC' ]
+     * ```
      *
      * @since 2.0.0
      * @category Mapping
@@ -6070,6 +6277,7 @@ export declare const mapAccum: {
      * input collection type.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * // Define an initial state and a transformation function
@@ -6088,6 +6296,7 @@ export declare const mapAccum: {
      * // Output:
      * // 6
      * // [ 'A', 'BB', 'CCC' ]
+     * ```
      *
      * @since 2.0.0
      * @category Mapping
@@ -6107,6 +6316,7 @@ export declare const mapAccum: {
  * @see {@link mapError} for a version that operates on the error channel.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * //      ┌─── Effect<number, string, never>
@@ -6119,6 +6329,7 @@ export declare const mapAccum: {
  *   onFailure: (message) => new Error(message),
  *   onSuccess: (n) => n > 0
  * })
+ * ```
  *
  * @since 2.0.0
  * @category Mapping
@@ -6137,6 +6348,7 @@ export declare const mapBoth: {
      * @see {@link mapError} for a version that operates on the error channel.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * //      ┌─── Effect<number, string, never>
@@ -6149,6 +6361,7 @@ export declare const mapBoth: {
      *   onFailure: (message) => new Error(message),
      *   onSuccess: (n) => n > 0
      * })
+     * ```
      *
      * @since 2.0.0
      * @category Mapping
@@ -6170,6 +6383,7 @@ export declare const mapBoth: {
      * @see {@link mapError} for a version that operates on the error channel.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * //      ┌─── Effect<number, string, never>
@@ -6182,6 +6396,7 @@ export declare const mapBoth: {
      *   onFailure: (message) => new Error(message),
      *   onSuccess: (n) => n > 0
      * })
+     * ```
      *
      * @since 2.0.0
      * @category Mapping
@@ -6205,6 +6420,7 @@ export declare const mapBoth: {
  * @see {@link orElseFail} if you want to replace the error with a new one.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * //      ┌─── Effect<number, string, never>
@@ -6217,6 +6433,7 @@ export declare const mapBoth: {
  *   simulatedTask,
  *   (message) => new Error(message)
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Mapping
@@ -6236,6 +6453,7 @@ export declare const mapError: {
      * @see {@link orElseFail} if you want to replace the error with a new one.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * //      ┌─── Effect<number, string, never>
@@ -6248,6 +6466,7 @@ export declare const mapError: {
      *   simulatedTask,
      *   (message) => new Error(message)
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Mapping
@@ -6267,6 +6486,7 @@ export declare const mapError: {
      * @see {@link orElseFail} if you want to replace the error with a new one.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * //      ┌─── Effect<number, string, never>
@@ -6279,6 +6499,7 @@ export declare const mapError: {
      *   simulatedTask,
      *   (message) => new Error(message)
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Mapping
@@ -6330,6 +6551,7 @@ export declare const mapErrorCause: {
  * errors as part of the outcome.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * //      ┌─── Effect<number, string, never>
@@ -6339,6 +6561,7 @@ export declare const mapErrorCause: {
  * //      ┌─── Effect<number | string, never, never>
  * //      ▼
  * const recovered = Effect.merge(program)
+ * ```
  *
  * @since 2.0.0
  * @category Mapping
@@ -6681,6 +6904,15 @@ export declare const scope: Effect<Scope.Scope, never, Scope.Scope>;
  * @category scoping, resources & finalization
  */
 export declare const scopeWith: <A, E, R>(f: (scope: Scope.Scope) => Effect<A, E, R>) => Effect<A, E, R | Scope.Scope>;
+/**
+ * Creates a `Scope`, passes it to the specified effectful function, and then
+ * closes the scope as soon as the effect is complete (whether through success,
+ * failure, or interruption).
+ *
+ * @since 3.11.0
+ * @category scoping, resources & finalization
+ */
+export declare const scopedWith: <A, E, R>(f: (scope: Scope.Scope) => Effect<A, E, R>) => Effect<A, E, R>;
 /**
  * Scopes all resources used in this workflow to the lifetime of the workflow,
  * ensuring that their finalizers are run as soon as this workflow completes
@@ -7269,6 +7501,7 @@ export declare const timedWith: {
  * @see {@link timeoutTo} for a version that allows specifying both success and timeout handlers.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const task = Effect.gen(function* () {
@@ -7294,6 +7527,7 @@ export declare const timedWith: {
  * //     failure: { _tag: 'TimeoutException' }
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category delays & timeouts
@@ -7314,6 +7548,7 @@ export declare const timeout: {
      * @see {@link timeoutTo} for a version that allows specifying both success and timeout handlers.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const task = Effect.gen(function* () {
@@ -7339,6 +7574,7 @@ export declare const timeout: {
      * //     failure: { _tag: 'TimeoutException' }
      * //   }
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category delays & timeouts
@@ -7359,6 +7595,7 @@ export declare const timeout: {
      * @see {@link timeoutTo} for a version that allows specifying both success and timeout handlers.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const task = Effect.gen(function* () {
@@ -7384,6 +7621,7 @@ export declare const timeout: {
      * //     failure: { _tag: 'TimeoutException' }
      * //   }
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category delays & timeouts
@@ -7410,6 +7648,7 @@ export declare const timeout: {
  * @see {@link timeoutTo} for a version that allows specifying both success and timeout handlers.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const task = Effect.gen(function* () {
@@ -7433,6 +7672,7 @@ export declare const timeout: {
  * //   { _id: 'Option', _tag: 'Some', value: 'Result' },
  * //   { _id: 'Option', _tag: 'None' }
  * // ]
+ * ```
  *
  * @since 3.1.0
  * @category delays & timeouts
@@ -7458,6 +7698,7 @@ export declare const timeoutOption: {
      * @see {@link timeoutTo} for a version that allows specifying both success and timeout handlers.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const task = Effect.gen(function* () {
@@ -7481,6 +7722,7 @@ export declare const timeoutOption: {
      * //   { _id: 'Option', _tag: 'Some', value: 'Result' },
      * //   { _id: 'Option', _tag: 'None' }
      * // ]
+     * ```
      *
      * @since 3.1.0
      * @category delays & timeouts
@@ -7506,6 +7748,7 @@ export declare const timeoutOption: {
      * @see {@link timeoutTo} for a version that allows specifying both success and timeout handlers.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const task = Effect.gen(function* () {
@@ -7529,6 +7772,7 @@ export declare const timeoutOption: {
      * //   { _id: 'Option', _tag: 'Some', value: 'Result' },
      * //   { _id: 'Option', _tag: 'None' }
      * // ]
+     * ```
      *
      * @since 3.1.0
      * @category delays & timeouts
@@ -7554,6 +7798,7 @@ export declare const timeoutOption: {
  * @see {@link timeoutTo} for a version that allows specifying both success and timeout handlers.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const task = Effect.gen(function* () {
@@ -7586,6 +7831,7 @@ export declare const timeoutOption: {
  * //     failure: MyTimeoutError { _tag: 'MyTimeoutError' }
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category delays & timeouts
@@ -7610,6 +7856,7 @@ export declare const timeoutFail: {
      * @see {@link timeoutTo} for a version that allows specifying both success and timeout handlers.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const task = Effect.gen(function* () {
@@ -7642,6 +7889,7 @@ export declare const timeoutFail: {
      * //     failure: MyTimeoutError { _tag: 'MyTimeoutError' }
      * //   }
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category delays & timeouts
@@ -7669,6 +7917,7 @@ export declare const timeoutFail: {
      * @see {@link timeoutTo} for a version that allows specifying both success and timeout handlers.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const task = Effect.gen(function* () {
@@ -7701,6 +7950,7 @@ export declare const timeoutFail: {
      * //     failure: MyTimeoutError { _tag: 'MyTimeoutError' }
      * //   }
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category delays & timeouts
@@ -7728,6 +7978,7 @@ export declare const timeoutFail: {
  * @see {@link timeoutTo} for a version that allows specifying both success and timeout handlers.
  *
  * @example
+ * ```ts
  * import { Effect, Cause } from "effect"
  *
  * const task = Effect.gen(function* () {
@@ -7752,6 +8003,7 @@ export declare const timeoutFail: {
  * //   _tag: 'Failure',
  * //   cause: { _id: 'Cause', _tag: 'Die', defect: 'Timed out!' }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category delays & timeouts
@@ -7775,6 +8027,7 @@ export declare const timeoutFailCause: {
      * @see {@link timeoutTo} for a version that allows specifying both success and timeout handlers.
      *
      * @example
+     * ```ts
      * import { Effect, Cause } from "effect"
      *
      * const task = Effect.gen(function* () {
@@ -7799,6 +8052,7 @@ export declare const timeoutFailCause: {
      * //   _tag: 'Failure',
      * //   cause: { _id: 'Cause', _tag: 'Die', defect: 'Timed out!' }
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category delays & timeouts
@@ -7825,6 +8079,7 @@ export declare const timeoutFailCause: {
      * @see {@link timeoutTo} for a version that allows specifying both success and timeout handlers.
      *
      * @example
+     * ```ts
      * import { Effect, Cause } from "effect"
      *
      * const task = Effect.gen(function* () {
@@ -7849,6 +8104,7 @@ export declare const timeoutFailCause: {
      * //   _tag: 'Failure',
      * //   cause: { _id: 'Cause', _tag: 'Die', defect: 'Timed out!' }
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category delays & timeouts
@@ -7880,6 +8136,7 @@ export declare const timeoutFailCause: {
  * @see {@link timeoutFailCause} for a version that raises a custom defect.
  *
  * @example
+ * ```ts
  * import { Effect, Either } from "effect"
  *
  * const task = Effect.gen(function* () {
@@ -7907,6 +8164,7 @@ export declare const timeoutFailCause: {
  * //   _tag: "Left",
  * //   left: "Timed out!"
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category delays & timeouts
@@ -7934,6 +8192,7 @@ export declare const timeoutTo: {
      * @see {@link timeoutFailCause} for a version that raises a custom defect.
      *
      * @example
+     * ```ts
      * import { Effect, Either } from "effect"
      *
      * const task = Effect.gen(function* () {
@@ -7961,6 +8220,7 @@ export declare const timeoutTo: {
      * //   _tag: "Left",
      * //   left: "Timed out!"
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category delays & timeouts
@@ -7992,6 +8252,7 @@ export declare const timeoutTo: {
      * @see {@link timeoutFailCause} for a version that raises a custom defect.
      *
      * @example
+     * ```ts
      * import { Effect, Either } from "effect"
      *
      * const task = Effect.gen(function* () {
@@ -8019,6 +8280,7 @@ export declare const timeoutTo: {
      * //   _tag: "Left",
      * //   left: "Timed out!"
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category delays & timeouts
@@ -8122,6 +8384,7 @@ export declare const mapInputContext: {
  * @see {@link provideService} for providing a service to an effect.
  *
  * @example
+ * ```ts
  * import { Context, Effect, Layer } from "effect"
  *
  * class Database extends Context.Tag("Database")<
@@ -8153,6 +8416,7 @@ export declare const mapInputContext: {
  * // Output:
  * // timestamp=... level=INFO fiber=#0 message="Executing query: SELECT * FROM users"
  * // []
+ * ```
  *
  * @since 2.0.0
  * @category Context
@@ -8168,6 +8432,7 @@ export declare const provide: {
      * @see {@link provideService} for providing a service to an effect.
      *
      * @example
+     * ```ts
      * import { Context, Effect, Layer } from "effect"
      *
      * class Database extends Context.Tag("Database")<
@@ -8199,6 +8464,7 @@ export declare const provide: {
      * // Output:
      * // timestamp=... level=INFO fiber=#0 message="Executing query: SELECT * FROM users"
      * // []
+     * ```
      *
      * @since 2.0.0
      * @category Context
@@ -8220,6 +8486,7 @@ export declare const provide: {
      * @see {@link provideService} for providing a service to an effect.
      *
      * @example
+     * ```ts
      * import { Context, Effect, Layer } from "effect"
      *
      * class Database extends Context.Tag("Database")<
@@ -8251,6 +8518,7 @@ export declare const provide: {
      * // Output:
      * // timestamp=... level=INFO fiber=#0 message="Executing query: SELECT * FROM users"
      * // []
+     * ```
      *
      * @since 2.0.0
      * @category Context
@@ -8266,6 +8534,7 @@ export declare const provide: {
      * @see {@link provideService} for providing a service to an effect.
      *
      * @example
+     * ```ts
      * import { Context, Effect, Layer } from "effect"
      *
      * class Database extends Context.Tag("Database")<
@@ -8297,6 +8566,7 @@ export declare const provide: {
      * // Output:
      * // timestamp=... level=INFO fiber=#0 message="Executing query: SELECT * FROM users"
      * // []
+     * ```
      *
      * @since 2.0.0
      * @category Context
@@ -8312,6 +8582,7 @@ export declare const provide: {
      * @see {@link provideService} for providing a service to an effect.
      *
      * @example
+     * ```ts
      * import { Context, Effect, Layer } from "effect"
      *
      * class Database extends Context.Tag("Database")<
@@ -8343,6 +8614,7 @@ export declare const provide: {
      * // Output:
      * // timestamp=... level=INFO fiber=#0 message="Executing query: SELECT * FROM users"
      * // []
+     * ```
      *
      * @since 2.0.0
      * @category Context
@@ -8358,6 +8630,7 @@ export declare const provide: {
      * @see {@link provideService} for providing a service to an effect.
      *
      * @example
+     * ```ts
      * import { Context, Effect, Layer } from "effect"
      *
      * class Database extends Context.Tag("Database")<
@@ -8389,6 +8662,7 @@ export declare const provide: {
      * // Output:
      * // timestamp=... level=INFO fiber=#0 message="Executing query: SELECT * FROM users"
      * // []
+     * ```
      *
      * @since 2.0.0
      * @category Context
@@ -8404,6 +8678,7 @@ export declare const provide: {
      * @see {@link provideService} for providing a service to an effect.
      *
      * @example
+     * ```ts
      * import { Context, Effect, Layer } from "effect"
      *
      * class Database extends Context.Tag("Database")<
@@ -8435,6 +8710,7 @@ export declare const provide: {
      * // Output:
      * // timestamp=... level=INFO fiber=#0 message="Executing query: SELECT * FROM users"
      * // []
+     * ```
      *
      * @since 2.0.0
      * @category Context
@@ -8456,6 +8732,7 @@ export declare const provide: {
      * @see {@link provideService} for providing a service to an effect.
      *
      * @example
+     * ```ts
      * import { Context, Effect, Layer } from "effect"
      *
      * class Database extends Context.Tag("Database")<
@@ -8487,6 +8764,7 @@ export declare const provide: {
      * // Output:
      * // timestamp=... level=INFO fiber=#0 message="Executing query: SELECT * FROM users"
      * // []
+     * ```
      *
      * @since 2.0.0
      * @category Context
@@ -8502,6 +8780,7 @@ export declare const provide: {
      * @see {@link provideService} for providing a service to an effect.
      *
      * @example
+     * ```ts
      * import { Context, Effect, Layer } from "effect"
      *
      * class Database extends Context.Tag("Database")<
@@ -8533,6 +8812,7 @@ export declare const provide: {
      * // Output:
      * // timestamp=... level=INFO fiber=#0 message="Executing query: SELECT * FROM users"
      * // []
+     * ```
      *
      * @since 2.0.0
      * @category Context
@@ -8548,6 +8828,7 @@ export declare const provide: {
      * @see {@link provideService} for providing a service to an effect.
      *
      * @example
+     * ```ts
      * import { Context, Effect, Layer } from "effect"
      *
      * class Database extends Context.Tag("Database")<
@@ -8579,6 +8860,7 @@ export declare const provide: {
      * // Output:
      * // timestamp=... level=INFO fiber=#0 message="Executing query: SELECT * FROM users"
      * // []
+     * ```
      *
      * @since 2.0.0
      * @category Context
@@ -8594,6 +8876,7 @@ export declare const provide: {
      * @see {@link provideService} for providing a service to an effect.
      *
      * @example
+     * ```ts
      * import { Context, Effect, Layer } from "effect"
      *
      * class Database extends Context.Tag("Database")<
@@ -8625,6 +8908,7 @@ export declare const provide: {
      * // Output:
      * // timestamp=... level=INFO fiber=#0 message="Executing query: SELECT * FROM users"
      * // []
+     * ```
      *
      * @since 2.0.0
      * @category Context
@@ -8644,6 +8928,7 @@ export declare const provide: {
  * @see {@link provide} for providing multiple layers to an effect.
  *
  * @example
+ * ```ts
  * import { Effect, Context } from "effect"
  *
  * // Declaring a tag for a service that generates random numbers
@@ -8671,6 +8956,7 @@ export declare const provide: {
  * Effect.runPromise(runnable)
  * // Example Output:
  * // random number: 0.8241872233134417
+ * ```
  *
  * @since 2.0.0
  * @category Context
@@ -8689,6 +8975,7 @@ export declare const provideService: {
      * @see {@link provide} for providing multiple layers to an effect.
      *
      * @example
+     * ```ts
      * import { Effect, Context } from "effect"
      *
      * // Declaring a tag for a service that generates random numbers
@@ -8716,6 +9003,7 @@ export declare const provideService: {
      * Effect.runPromise(runnable)
      * // Example Output:
      * // random number: 0.8241872233134417
+     * ```
      *
      * @since 2.0.0
      * @category Context
@@ -8734,6 +9022,7 @@ export declare const provideService: {
      * @see {@link provide} for providing multiple layers to an effect.
      *
      * @example
+     * ```ts
      * import { Effect, Context } from "effect"
      *
      * // Declaring a tag for a service that generates random numbers
@@ -8761,6 +9050,7 @@ export declare const provideService: {
      * Effect.runPromise(runnable)
      * // Example Output:
      * // random number: 0.8241872233134417
+     * ```
      *
      * @since 2.0.0
      * @category Context
@@ -8879,6 +9169,7 @@ export declare const updateService: {
  * @see {@link let_ let}
  *
  * @example
+ * ```ts
  * import { Effect, pipe } from "effect"
  *
  * const result = pipe(
@@ -8888,6 +9179,7 @@ export declare const updateService: {
  *   Effect.let("sum", ({ x, y }) => x + y)
  * )
  * assert.deepStrictEqual(Effect.runSync(result), { x: 2, y: 3, sum: 5 })
+ * ```
  *
  * @category Do notation
  * @since 2.0.0
@@ -8908,6 +9200,7 @@ export declare const Do: Effect<{}>;
  * @see {@link let_ let}
  *
  * @example
+ * ```ts
  * import { Effect, pipe } from "effect"
  *
  * const result = pipe(
@@ -8917,6 +9210,7 @@ export declare const Do: Effect<{}>;
  *   Effect.let("sum", ({ x, y }) => x + y)
  * )
  * assert.deepStrictEqual(Effect.runSync(result), { x: 2, y: 3, sum: 5 })
+ * ```
  *
  * @category Do notation
  * @since 2.0.0
@@ -8937,6 +9231,7 @@ export declare const bind: {
      * @see {@link let_ let}
      *
      * @example
+     * ```ts
      * import { Effect, pipe } from "effect"
      *
      * const result = pipe(
@@ -8946,6 +9241,7 @@ export declare const bind: {
      *   Effect.let("sum", ({ x, y }) => x + y)
      * )
      * assert.deepStrictEqual(Effect.runSync(result), { x: 2, y: 3, sum: 5 })
+     * ```
      *
      * @category Do notation
      * @since 2.0.0
@@ -8968,6 +9264,7 @@ export declare const bind: {
      * @see {@link let_ let}
      *
      * @example
+     * ```ts
      * import { Effect, pipe } from "effect"
      *
      * const result = pipe(
@@ -8977,6 +9274,7 @@ export declare const bind: {
      *   Effect.let("sum", ({ x, y }) => x + y)
      * )
      * assert.deepStrictEqual(Effect.runSync(result), { x: 2, y: 3, sum: 5 })
+     * ```
      *
      * @category Do notation
      * @since 2.0.0
@@ -8991,6 +9289,7 @@ export declare const bind: {
  * results in a Do notation pipeline.
  *
  * @example
+ * ```ts
  * import { Effect, Either, pipe } from "effect"
  *
  * const result = pipe(
@@ -9002,6 +9301,7 @@ export declare const bind: {
  *   }), { concurrency: 2, mode: "either" })
  * )
  * assert.deepStrictEqual(Effect.runSync(result), { x: 2, a: Either.right(2), b: Either.left("oops") })
+ * ```
  *
  * @category Do notation
  * @since 3.7.0
@@ -9013,6 +9313,7 @@ export declare const bindAll: {
      * results in a Do notation pipeline.
      *
      * @example
+     * ```ts
      * import { Effect, Either, pipe } from "effect"
      *
      * const result = pipe(
@@ -9024,6 +9325,7 @@ export declare const bindAll: {
      *   }), { concurrency: 2, mode: "either" })
      * )
      * assert.deepStrictEqual(Effect.runSync(result), { x: 2, a: Either.right(2), b: Either.left("oops") })
+     * ```
      *
      * @category Do notation
      * @since 3.7.0
@@ -9042,6 +9344,7 @@ export declare const bindAll: {
      * results in a Do notation pipeline.
      *
      * @example
+     * ```ts
      * import { Effect, Either, pipe } from "effect"
      *
      * const result = pipe(
@@ -9053,6 +9356,7 @@ export declare const bindAll: {
      *   }), { concurrency: 2, mode: "either" })
      * )
      * assert.deepStrictEqual(Effect.runSync(result), { x: 2, a: Either.right(2), b: Either.left("oops") })
+     * ```
      *
      * @category Do notation
      * @since 3.7.0
@@ -9086,6 +9390,7 @@ export declare const bindAll: {
  * @see {@link let_ let}
  *
  * @example
+ * ```ts
  * import { Effect, pipe } from "effect"
  *
  * const result = pipe(
@@ -9095,6 +9400,7 @@ export declare const bindAll: {
  *   Effect.let("sum", ({ x, y }) => x + y)
  * )
  * assert.deepStrictEqual(Effect.runSync(result), { x: 2, y: 3, sum: 5 })
+ * ```
  *
  * @category Do notation
  * @since 2.0.0
@@ -9115,6 +9421,7 @@ export declare const bindTo: {
      * @see {@link let_ let}
      *
      * @example
+     * ```ts
      * import { Effect, pipe } from "effect"
      *
      * const result = pipe(
@@ -9124,6 +9431,7 @@ export declare const bindTo: {
      *   Effect.let("sum", ({ x, y }) => x + y)
      * )
      * assert.deepStrictEqual(Effect.runSync(result), { x: 2, y: 3, sum: 5 })
+     * ```
      *
      * @category Do notation
      * @since 2.0.0
@@ -9146,6 +9454,7 @@ export declare const bindTo: {
      * @see {@link let_ let}
      *
      * @example
+     * ```ts
      * import { Effect, pipe } from "effect"
      *
      * const result = pipe(
@@ -9155,6 +9464,7 @@ export declare const bindTo: {
      *   Effect.let("sum", ({ x, y }) => x + y)
      * )
      * assert.deepStrictEqual(Effect.runSync(result), { x: 2, y: 3, sum: 5 })
+     * ```
      *
      * @category Do notation
      * @since 2.0.0
@@ -9187,6 +9497,7 @@ export {
  * @see {@link bindTo}
  *
  * @example
+ * ```ts
  * import { Effect, pipe } from "effect"
  *
  * const result = pipe(
@@ -9197,6 +9508,7 @@ export {
  * )
  * assert.deepStrictEqual(Effect.runSync(result), { x: 2, y: 3, sum: 5 })
  *
+ * ```
  * @category Do notation
  * @since 2.0.0
  */
@@ -9219,6 +9531,7 @@ let_ as let };
  * @see {@link exit} for a version that uses `Exit` instead.
  *
  * @example
+ * ```ts
  * // Title: Using Effect.option to Handle Errors
  * import { Effect } from "effect"
  *
@@ -9251,6 +9564,7 @@ let_ as let };
  * //   _tag: 'Failure',
  * //   cause: { _id: 'Cause', _tag: 'Die', defect: 'Boom!' }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Outcome Encapsulation
@@ -9275,6 +9589,7 @@ export declare const option: <A, E, R>(self: Effect<A, E, R>) => Effect<Option.O
  * @see {@link exit} for a version that uses `Exit` instead.
  *
  * @example
+ * ```ts
  * import { Effect, Either, Random } from "effect"
  *
  * class HttpError {
@@ -9310,6 +9625,7 @@ export declare const option: <A, E, R>(self: Effect<A, E, R>) => Effect<Option.O
  *     onRight: (value) => value // Do nothing in case of success
  *   })
  * })
+ * ```
  *
  * @since 2.0.0
  * @category Outcome Encapsulation
@@ -9332,6 +9648,7 @@ export declare const either: <A, E, R>(self: Effect<A, E, R>) => Effect<Either.E
  * @see {@link either} for a version that uses `Either` instead.
  *
  * @example
+ * ```ts
  * import { Effect, Cause, Console, Exit } from "effect"
  *
  * // Simulating a runtime error
@@ -9363,6 +9680,7 @@ export declare const either: <A, E, R>(self: Effect<A, E, R>) => Effect<Either.E
  * //   _tag: "Success",
  * //   value: undefined
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Outcome Encapsulation
@@ -9379,6 +9697,7 @@ export declare const exit: <A, E, R>(self: Effect<A, E, R>) => Effect<Exit.Exit<
  * failure. Additionally, if the effect is interrupted, the `Deferred` will also be interrupted.
  *
  * @example
+ * ```ts
  * import { Deferred, Effect } from "effect"
  *
  * // Define an effect that succeeds
@@ -9402,6 +9721,7 @@ export declare const exit: <A, E, R>(self: Effect<A, E, R>) => Effect<Exit.Exit<
  * // Output:
  * // 42
  * // true
+ * ```
  *
  * @since 2.0.0
  * @category Synchronization Utilities
@@ -9418,6 +9738,7 @@ export declare const intoDeferred: {
      * failure. Additionally, if the effect is interrupted, the `Deferred` will also be interrupted.
      *
      * @example
+     * ```ts
      * import { Deferred, Effect } from "effect"
      *
      * // Define an effect that succeeds
@@ -9441,6 +9762,7 @@ export declare const intoDeferred: {
      * // Output:
      * // 42
      * // true
+     * ```
      *
      * @since 2.0.0
      * @category Synchronization Utilities
@@ -9457,6 +9779,7 @@ export declare const intoDeferred: {
      * failure. Additionally, if the effect is interrupted, the `Deferred` will also be interrupted.
      *
      * @example
+     * ```ts
      * import { Deferred, Effect } from "effect"
      *
      * // Define an effect that succeeds
@@ -9480,6 +9803,7 @@ export declare const intoDeferred: {
      * // Output:
      * // 42
      * // true
+     * ```
      *
      * @since 2.0.0
      * @category Synchronization Utilities
@@ -9505,6 +9829,7 @@ export {
  * is executed. If it is `false`, the `onFalse` effect is executed instead.
  *
  * @example
+ * ```ts
  * // Title: Simulating a Coin Flip
  * import { Effect, Random, Console } from "effect"
  *
@@ -9515,6 +9840,7 @@ export {
  *
  * Effect.runFork(flipTheCoin)
  *
+ * ```
  * @since 2.0.0
  * @category Conditional Operators
  */
@@ -9653,6 +9979,7 @@ export declare const filterOrElse: {
  * Let's explore this concept through an example:
  *
  * @example
+ * ```ts
  * import { Effect, pipe } from "effect"
  *
  * // Define a user interface
@@ -9673,6 +10000,7 @@ export declare const filterOrElse: {
  *   // 'user' now has the type `User` (not `User | null`)
  *   Effect.andThen((user) => user.name)
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Filtering
@@ -9689,6 +10017,7 @@ export declare const filterOrFail: {
      * Let's explore this concept through an example:
      *
      * @example
+     * ```ts
      * import { Effect, pipe } from "effect"
      *
      * // Define a user interface
@@ -9709,6 +10038,7 @@ export declare const filterOrFail: {
      *   // 'user' now has the type `User` (not `User | null`)
      *   Effect.andThen((user) => user.name)
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Filtering
@@ -9725,6 +10055,7 @@ export declare const filterOrFail: {
      * Let's explore this concept through an example:
      *
      * @example
+     * ```ts
      * import { Effect, pipe } from "effect"
      *
      * // Define a user interface
@@ -9745,6 +10076,7 @@ export declare const filterOrFail: {
      *   // 'user' now has the type `User` (not `User | null`)
      *   Effect.andThen((user) => user.name)
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Filtering
@@ -9761,6 +10093,7 @@ export declare const filterOrFail: {
      * Let's explore this concept through an example:
      *
      * @example
+     * ```ts
      * import { Effect, pipe } from "effect"
      *
      * // Define a user interface
@@ -9781,6 +10114,7 @@ export declare const filterOrFail: {
      *   // 'user' now has the type `User` (not `User | null`)
      *   Effect.andThen((user) => user.name)
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Filtering
@@ -9797,6 +10131,7 @@ export declare const filterOrFail: {
      * Let's explore this concept through an example:
      *
      * @example
+     * ```ts
      * import { Effect, pipe } from "effect"
      *
      * // Define a user interface
@@ -9817,6 +10152,7 @@ export declare const filterOrFail: {
      *   // 'user' now has the type `User` (not `User | null`)
      *   Effect.andThen((user) => user.name)
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Filtering
@@ -9833,6 +10169,7 @@ export declare const filterOrFail: {
      * Let's explore this concept through an example:
      *
      * @example
+     * ```ts
      * import { Effect, pipe } from "effect"
      *
      * // Define a user interface
@@ -9853,6 +10190,7 @@ export declare const filterOrFail: {
      *   // 'user' now has the type `User` (not `User | null`)
      *   Effect.andThen((user) => user.name)
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Filtering
@@ -9869,6 +10207,7 @@ export declare const filterOrFail: {
      * Let's explore this concept through an example:
      *
      * @example
+     * ```ts
      * import { Effect, pipe } from "effect"
      *
      * // Define a user interface
@@ -9889,6 +10228,7 @@ export declare const filterOrFail: {
      *   // 'user' now has the type `User` (not `User | null`)
      *   Effect.andThen((user) => user.name)
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Filtering
@@ -9905,6 +10245,7 @@ export declare const filterOrFail: {
      * Let's explore this concept through an example:
      *
      * @example
+     * ```ts
      * import { Effect, pipe } from "effect"
      *
      * // Define a user interface
@@ -9925,6 +10266,7 @@ export declare const filterOrFail: {
      *   // 'user' now has the type `User` (not `User | null`)
      *   Effect.andThen((user) => user.name)
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Filtering
@@ -9941,6 +10283,7 @@ export declare const filterOrFail: {
      * Let's explore this concept through an example:
      *
      * @example
+     * ```ts
      * import { Effect, pipe } from "effect"
      *
      * // Define a user interface
@@ -9961,6 +10304,7 @@ export declare const filterOrFail: {
      *   // 'user' now has the type `User` (not `User | null`)
      *   Effect.andThen((user) => user.name)
      * )
+     * ```
      *
      * @since 2.0.0
      * @category Filtering
@@ -10051,6 +10395,7 @@ export declare const unlessEffect: {
  * @see {@link unless} for a version that executes the effect when the condition is `false`.
  *
  * @example
+ * ```ts
  * // Title: Conditional Effect Execution
  * import { Effect, Option } from "effect"
  *
@@ -10076,6 +10421,7 @@ export declare const unlessEffect: {
  * //   _id: "Option",
  * //   _tag: "None"
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Conditional Operators
@@ -10097,6 +10443,7 @@ export declare const when: {
      * @see {@link unless} for a version that executes the effect when the condition is `false`.
      *
      * @example
+     * ```ts
      * // Title: Conditional Effect Execution
      * import { Effect, Option } from "effect"
      *
@@ -10122,6 +10469,7 @@ export declare const when: {
      * //   _id: "Option",
      * //   _tag: "None"
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category Conditional Operators
@@ -10143,6 +10491,7 @@ export declare const when: {
      * @see {@link unless} for a version that executes the effect when the condition is `false`.
      *
      * @example
+     * ```ts
      * // Title: Conditional Effect Execution
      * import { Effect, Option } from "effect"
      *
@@ -10168,6 +10517,7 @@ export declare const when: {
      * //   _id: "Option",
      * //   _tag: "None"
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category Conditional Operators
@@ -10192,6 +10542,7 @@ export declare const when: {
  * @see {@link unlessEffect} for a version that executes the effect when the condition is `false`.
  *
  * @example
+ * ```ts
  * // Title: Using an Effect as a Condition
  * import { Effect, Random } from "effect"
  *
@@ -10202,6 +10553,7 @@ export declare const when: {
  * console.log(Effect.runSync(randomIntOption))
  * // Example Output:
  * // { _id: 'Option', _tag: 'Some', value: 8609104974198840 }
+ * ```
  *
  * @since 2.0.0
  * @category Conditional Operators
@@ -10225,6 +10577,7 @@ export declare const whenEffect: {
      * @see {@link unlessEffect} for a version that executes the effect when the condition is `false`.
      *
      * @example
+     * ```ts
      * // Title: Using an Effect as a Condition
      * import { Effect, Random } from "effect"
      *
@@ -10235,6 +10588,7 @@ export declare const whenEffect: {
      * console.log(Effect.runSync(randomIntOption))
      * // Example Output:
      * // { _id: 'Option', _tag: 'Some', value: 8609104974198840 }
+     * ```
      *
      * @since 2.0.0
      * @category Conditional Operators
@@ -10258,6 +10612,7 @@ export declare const whenEffect: {
      * @see {@link unlessEffect} for a version that executes the effect when the condition is `false`.
      *
      * @example
+     * ```ts
      * // Title: Using an Effect as a Condition
      * import { Effect, Random } from "effect"
      *
@@ -10268,6 +10623,7 @@ export declare const whenEffect: {
      * console.log(Effect.runSync(randomIntOption))
      * // Example Output:
      * // { _id: 'Option', _tag: 'Some', value: 8609104974198840 }
+     * ```
      *
      * @since 2.0.0
      * @category Conditional Operators
@@ -10351,6 +10707,7 @@ export declare const whenRef: {
  * changing the original one.
  *
  * @example
+ * ```ts
  * import { pipe, Effect } from "effect"
  *
  * // Function to apply a discount safely to a transaction amount
@@ -10373,6 +10730,7 @@ export declare const whenRef: {
  *
  * Effect.runPromise(finalAmount).then(console.log)
  * // Output: 95
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -10408,6 +10766,7 @@ export declare const flatMap: {
      * changing the original one.
      *
      * @example
+     * ```ts
      * import { pipe, Effect } from "effect"
      *
      * // Function to apply a discount safely to a transaction amount
@@ -10430,6 +10789,7 @@ export declare const flatMap: {
      *
      * Effect.runPromise(finalAmount).then(console.log)
      * // Output: 95
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -10465,6 +10825,7 @@ export declare const flatMap: {
      * changing the original one.
      *
      * @example
+     * ```ts
      * import { pipe, Effect } from "effect"
      *
      * // Function to apply a discount safely to a transaction amount
@@ -10487,6 +10848,7 @@ export declare const flatMap: {
      *
      * Effect.runPromise(finalAmount).then(console.log)
      * // Output: 95
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -10527,6 +10889,7 @@ export declare const flatMap: {
  * treating them as effects.
  *
  * @example
+ * ```ts
  * // Title: Applying a Discount Based on Fetched Amount
  * import { pipe, Effect } from "effect"
  *
@@ -10561,6 +10924,7 @@ export declare const flatMap: {
  *
  * Effect.runPromise(result2).then(console.log)
  * // Output: 190
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -10600,6 +10964,7 @@ export declare const andThen: {
      * treating them as effects.
      *
      * @example
+     * ```ts
      * // Title: Applying a Discount Based on Fetched Amount
      * import { pipe, Effect } from "effect"
      *
@@ -10634,6 +10999,7 @@ export declare const andThen: {
      *
      * Effect.runPromise(result2).then(console.log)
      * // Output: 190
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -10673,6 +11039,7 @@ export declare const andThen: {
      * treating them as effects.
      *
      * @example
+     * ```ts
      * // Title: Applying a Discount Based on Fetched Amount
      * import { pipe, Effect } from "effect"
      *
@@ -10707,6 +11074,7 @@ export declare const andThen: {
      *
      * Effect.runPromise(result2).then(console.log)
      * // Output: 190
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -10746,6 +11114,7 @@ export declare const andThen: {
      * treating them as effects.
      *
      * @example
+     * ```ts
      * // Title: Applying a Discount Based on Fetched Amount
      * import { pipe, Effect } from "effect"
      *
@@ -10780,6 +11149,7 @@ export declare const andThen: {
      *
      * Effect.runPromise(result2).then(console.log)
      * // Output: 190
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -10819,6 +11189,7 @@ export declare const andThen: {
      * treating them as effects.
      *
      * @example
+     * ```ts
      * // Title: Applying a Discount Based on Fetched Amount
      * import { pipe, Effect } from "effect"
      *
@@ -10853,6 +11224,7 @@ export declare const andThen: {
      *
      * Effect.runPromise(result2).then(console.log)
      * // Output: 190
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -11030,6 +11402,7 @@ export declare const summarized: {
  * will fail too.
  *
  * @example
+ * ```ts
  * // Title: Logging a step in a pipeline
  * import { Console, Effect, pipe } from "effect"
  *
@@ -11057,6 +11430,7 @@ export declare const summarized: {
  * // Output:
  * // Apply a discount to: 100
  * // 95
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -11080,6 +11454,7 @@ export declare const tap: {
      * will fail too.
      *
      * @example
+     * ```ts
      * // Title: Logging a step in a pipeline
      * import { Console, Effect, pipe } from "effect"
      *
@@ -11107,6 +11482,7 @@ export declare const tap: {
      * // Output:
      * // Apply a discount to: 100
      * // 95
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -11130,6 +11506,7 @@ export declare const tap: {
      * will fail too.
      *
      * @example
+     * ```ts
      * // Title: Logging a step in a pipeline
      * import { Console, Effect, pipe } from "effect"
      *
@@ -11157,6 +11534,7 @@ export declare const tap: {
      * // Output:
      * // Apply a discount to: 100
      * // 95
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -11182,6 +11560,7 @@ export declare const tap: {
      * will fail too.
      *
      * @example
+     * ```ts
      * // Title: Logging a step in a pipeline
      * import { Console, Effect, pipe } from "effect"
      *
@@ -11209,6 +11588,7 @@ export declare const tap: {
      * // Output:
      * // Apply a discount to: 100
      * // 95
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -11232,6 +11612,7 @@ export declare const tap: {
      * will fail too.
      *
      * @example
+     * ```ts
      * // Title: Logging a step in a pipeline
      * import { Console, Effect, pipe } from "effect"
      *
@@ -11259,6 +11640,7 @@ export declare const tap: {
      * // Output:
      * // Apply a discount to: 100
      * // 95
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -11284,6 +11666,7 @@ export declare const tap: {
      * will fail too.
      *
      * @example
+     * ```ts
      * // Title: Logging a step in a pipeline
      * import { Console, Effect, pipe } from "effect"
      *
@@ -11311,6 +11694,7 @@ export declare const tap: {
      * // Output:
      * // Apply a discount to: 100
      * // 95
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -11334,6 +11718,7 @@ export declare const tap: {
      * will fail too.
      *
      * @example
+     * ```ts
      * // Title: Logging a step in a pipeline
      * import { Console, Effect, pipe } from "effect"
      *
@@ -11361,6 +11746,7 @@ export declare const tap: {
      * // Output:
      * // Apply a discount to: 100
      * // 95
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -11386,6 +11772,7 @@ export declare const tap: {
      * will fail too.
      *
      * @example
+     * ```ts
      * // Title: Logging a step in a pipeline
      * import { Console, Effect, pipe } from "effect"
      *
@@ -11413,6 +11800,7 @@ export declare const tap: {
      * // Output:
      * // Apply a discount to: 100
      * // 95
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -11436,6 +11824,7 @@ export declare const tap: {
      * will fail too.
      *
      * @example
+     * ```ts
      * // Title: Logging a step in a pipeline
      * import { Console, Effect, pipe } from "effect"
      *
@@ -11463,6 +11852,7 @@ export declare const tap: {
      * // Output:
      * // Apply a discount to: 100
      * // 95
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -11483,6 +11873,7 @@ export declare const tap: {
  * altering the result.
  *
  * @example
+ * ```ts
  * import { Effect, Random, Console } from "effect"
  *
  * // Simulate a task that might fail
@@ -11502,6 +11893,7 @@ export declare const tap: {
  * Effect.runFork(tapping)
  * // Example Output:
  * // failure: random number is negative
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -11519,6 +11911,7 @@ export declare const tapBoth: {
      * altering the result.
      *
      * @example
+     * ```ts
      * import { Effect, Random, Console } from "effect"
      *
      * // Simulate a task that might fail
@@ -11538,6 +11931,7 @@ export declare const tapBoth: {
      * Effect.runFork(tapping)
      * // Example Output:
      * // failure: random number is negative
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -11558,6 +11952,7 @@ export declare const tapBoth: {
      * altering the result.
      *
      * @example
+     * ```ts
      * import { Effect, Random, Console } from "effect"
      *
      * // Simulate a task that might fail
@@ -11577,6 +11972,7 @@ export declare const tapBoth: {
      * Effect.runFork(tapping)
      * // Example Output:
      * // failure: random number is negative
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -11597,6 +11993,7 @@ export declare const tapBoth: {
  * severe errors.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * // Simulate a task that fails with a recoverable error
@@ -11624,6 +12021,7 @@ export declare const tapBoth: {
  * // Output:
  * // defect: RuntimeException: Something went wrong
  * //   ... stack trace ...
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -11640,6 +12038,7 @@ export declare const tapDefect: {
      * severe errors.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * // Simulate a task that fails with a recoverable error
@@ -11667,6 +12066,7 @@ export declare const tapDefect: {
      * // Output:
      * // defect: RuntimeException: Something went wrong
      * //   ... stack trace ...
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -11683,6 +12083,7 @@ export declare const tapDefect: {
      * severe errors.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * // Simulate a task that fails with a recoverable error
@@ -11710,6 +12111,7 @@ export declare const tapDefect: {
      * // Output:
      * // defect: RuntimeException: Something went wrong
      * //   ... stack trace ...
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -11726,6 +12128,7 @@ export declare const tapDefect: {
  * while the operation you provide can inspect or act on it.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * // Simulate a task that fails with an error
@@ -11739,6 +12142,7 @@ export declare const tapDefect: {
  * Effect.runFork(tapping)
  * // Output:
  * // expected error: NetworkError
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -11754,6 +12158,7 @@ export declare const tapError: {
      * while the operation you provide can inspect or act on it.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * // Simulate a task that fails with an error
@@ -11767,6 +12172,7 @@ export declare const tapError: {
      * Effect.runFork(tapping)
      * // Output:
      * // expected error: NetworkError
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -11782,6 +12188,7 @@ export declare const tapError: {
      * while the operation you provide can inspect or act on it.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * // Simulate a task that fails with an error
@@ -11795,6 +12202,7 @@ export declare const tapError: {
      * Effect.runFork(tapping)
      * // Output:
      * // expected error: NetworkError
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -11811,6 +12219,7 @@ export declare const tapError: {
  * without modifying the error or the overall result of the effect.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * class NetworkError {
@@ -11835,6 +12244,7 @@ export declare const tapError: {
  * Effect.runFork(tapping)
  * // Output:
  * // expected error: 504
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -11850,6 +12260,7 @@ export declare const tapErrorTag: {
      * without modifying the error or the overall result of the effect.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * class NetworkError {
@@ -11874,6 +12285,7 @@ export declare const tapErrorTag: {
      * Effect.runFork(tapping)
      * // Output:
      * // expected error: 504
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -11893,6 +12305,7 @@ export declare const tapErrorTag: {
      * without modifying the error or the overall result of the effect.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * class NetworkError {
@@ -11917,6 +12330,7 @@ export declare const tapErrorTag: {
      * Effect.runFork(tapping)
      * // Output:
      * // expected error: 504
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -11937,6 +12351,7 @@ export declare const tapErrorTag: {
  * altering the error or the overall result of the effect.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * // Create a task that fails with a NetworkError
@@ -11963,6 +12378,7 @@ export declare const tapErrorTag: {
  * // Output:
  * // error cause: RuntimeException: Something went wrong
  * //   ... stack trace ...
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -11978,6 +12394,7 @@ export declare const tapErrorCause: {
      * altering the error or the overall result of the effect.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * // Create a task that fails with a NetworkError
@@ -12004,6 +12421,7 @@ export declare const tapErrorCause: {
      * // Output:
      * // error cause: RuntimeException: Something went wrong
      * //   ... stack trace ...
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -12019,6 +12437,7 @@ export declare const tapErrorCause: {
      * altering the error or the overall result of the effect.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * // Create a task that fails with a NetworkError
@@ -12045,6 +12464,7 @@ export declare const tapErrorCause: {
      * // Output:
      * // error cause: RuntimeException: Something went wrong
      * //   ... stack trace ...
+     * ```
      *
      * @since 2.0.0
      * @category sequencing
@@ -12077,6 +12497,7 @@ export declare const forever: <A, E, R>(self: Effect<A, E, R>) => Effect<never,
  * ```
  *
  * @example
+ * ```ts
  * // Title: Effectful Iteration
  * import { Effect } from "effect"
  *
@@ -12093,6 +12514,7 @@ export declare const forever: <A, E, R>(self: Effect<A, E, R>) => Effect<never,
  *
  * Effect.runPromise(result).then(console.log)
  * // Output: 6
+ * ```
  *
  * @since 2.0.0
  * @category Looping
@@ -12117,6 +12539,7 @@ export declare const iterate: {
      * ```
      *
      * @example
+     * ```ts
      * // Title: Effectful Iteration
      * import { Effect } from "effect"
      *
@@ -12133,6 +12556,7 @@ export declare const iterate: {
      *
      * Effect.runPromise(result).then(console.log)
      * // Output: 6
+     * ```
      *
      * @since 2.0.0
      * @category Looping
@@ -12160,6 +12584,7 @@ export declare const iterate: {
      * ```
      *
      * @example
+     * ```ts
      * // Title: Effectful Iteration
      * import { Effect } from "effect"
      *
@@ -12176,6 +12601,7 @@ export declare const iterate: {
      *
      * Effect.runPromise(result).then(console.log)
      * // Output: 6
+     * ```
      *
      * @since 2.0.0
      * @category Looping
@@ -12212,6 +12638,7 @@ export declare const iterate: {
  * discarded, and the final result will be `void`.
  *
  * @example
+ * ```ts
  * // Title: Looping with Collected Results
  * import { Effect } from "effect"
  *
@@ -12231,6 +12658,7 @@ export declare const iterate: {
  *
  * Effect.runPromise(result).then(console.log)
  * // Output: [1, 2, 3, 4, 5]
+ * ```
  *
  * @example
  * // Title: Loop with Discarded Results
@@ -12291,6 +12719,7 @@ export declare const loop: {
      * discarded, and the final result will be `void`.
      *
      * @example
+     * ```ts
      * // Title: Looping with Collected Results
      * import { Effect } from "effect"
      *
@@ -12310,6 +12739,7 @@ export declare const loop: {
      *
      * Effect.runPromise(result).then(console.log)
      * // Output: [1, 2, 3, 4, 5]
+     * ```
      *
      * @example
      * // Title: Loop with Discarded Results
@@ -12375,6 +12805,7 @@ export declare const loop: {
      * discarded, and the final result will be `void`.
      *
      * @example
+     * ```ts
      * // Title: Looping with Collected Results
      * import { Effect } from "effect"
      *
@@ -12394,6 +12825,7 @@ export declare const loop: {
      *
      * Effect.runPromise(result).then(console.log)
      * // Output: [1, 2, 3, 4, 5]
+     * ```
      *
      * @example
      * // Title: Loop with Discarded Results
@@ -12459,6 +12891,7 @@ export declare const loop: {
      * discarded, and the final result will be `void`.
      *
      * @example
+     * ```ts
      * // Title: Looping with Collected Results
      * import { Effect } from "effect"
      *
@@ -12478,6 +12911,7 @@ export declare const loop: {
      *
      * Effect.runPromise(result).then(console.log)
      * // Output: [1, 2, 3, 4, 5]
+     * ```
      *
      * @example
      * // Title: Loop with Discarded Results
@@ -12543,6 +12977,7 @@ export declare const loop: {
      * discarded, and the final result will be `void`.
      *
      * @example
+     * ```ts
      * // Title: Looping with Collected Results
      * import { Effect } from "effect"
      *
@@ -12562,6 +12997,7 @@ export declare const loop: {
      *
      * Effect.runPromise(result).then(console.log)
      * // Output: [1, 2, 3, 4, 5]
+     * ```
      *
      * @example
      * // Title: Loop with Discarded Results
@@ -12644,6 +13080,7 @@ export declare namespace Repeat {
  * an additional time.
  *
  * @example
+ * ```ts
  * // Success Example
  * import { Effect, Schedule, Console } from "effect"
  *
@@ -12652,6 +13089,7 @@ export declare namespace Repeat {
  * const program = Effect.repeat(action, policy)
  *
  * Effect.runPromise(program).then((n) => console.log(`repetitions: ${n}`))
+ * ```
  *
  * @example
  * // Failure Example
@@ -12688,6 +13126,7 @@ export declare const repeat: {
      * an additional time.
      *
      * @example
+     * ```ts
      * // Success Example
      * import { Effect, Schedule, Console } from "effect"
      *
@@ -12696,6 +13135,7 @@ export declare const repeat: {
      * const program = Effect.repeat(action, policy)
      *
      * Effect.runPromise(program).then((n) => console.log(`repetitions: ${n}`))
+     * ```
      *
      * @example
      * // Failure Example
@@ -12732,6 +13172,7 @@ export declare const repeat: {
      * an additional time.
      *
      * @example
+     * ```ts
      * // Success Example
      * import { Effect, Schedule, Console } from "effect"
      *
@@ -12740,6 +13181,7 @@ export declare const repeat: {
      * const program = Effect.repeat(action, policy)
      *
      * Effect.runPromise(program).then((n) => console.log(`repetitions: ${n}`))
+     * ```
      *
      * @example
      * // Failure Example
@@ -12776,6 +13218,7 @@ export declare const repeat: {
      * an additional time.
      *
      * @example
+     * ```ts
      * // Success Example
      * import { Effect, Schedule, Console } from "effect"
      *
@@ -12784,6 +13227,7 @@ export declare const repeat: {
      * const program = Effect.repeat(action, policy)
      *
      * Effect.runPromise(program).then((n) => console.log(`repetitions: ${n}`))
+     * ```
      *
      * @example
      * // Failure Example
@@ -12820,6 +13264,7 @@ export declare const repeat: {
      * an additional time.
      *
      * @example
+     * ```ts
      * // Success Example
      * import { Effect, Schedule, Console } from "effect"
      *
@@ -12828,6 +13273,7 @@ export declare const repeat: {
      * const program = Effect.repeat(action, policy)
      *
      * Effect.runPromise(program).then((n) => console.log(`repetitions: ${n}`))
+     * ```
      *
      * @example
      * // Failure Example
@@ -12864,12 +13310,14 @@ export declare const repeat: {
  * initially and then repeats it one additional time if it succeeds.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * const action = Console.log("success")
  * const program = Effect.repeatN(action, 2)
  *
  * Effect.runPromise(program)
+ * ```
  *
  * @since 2.0.0
  * @category repetition / recursion
@@ -12882,12 +13330,14 @@ export declare const repeatN: {
      * initially and then repeats it one additional time if it succeeds.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * const action = Console.log("success")
      * const program = Effect.repeatN(action, 2)
      *
      * Effect.runPromise(program)
+     * ```
      *
      * @since 2.0.0
      * @category repetition / recursion
@@ -12900,12 +13350,14 @@ export declare const repeatN: {
      * initially and then repeats it one additional time if it succeeds.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * const action = Console.log("success")
      * const program = Effect.repeatN(action, 2)
      *
      * Effect.runPromise(program)
+     * ```
      *
      * @since 2.0.0
      * @category repetition / recursion
@@ -12921,6 +13373,7 @@ export declare const repeatN: {
  * initially and then repeats it an additional time if it succeeds.
  *
  * @example
+ * ```ts
  * import { Effect, Schedule } from "effect"
  *
  * let count = 0
@@ -12950,6 +13403,7 @@ export declare const repeatN: {
  * )
  *
  * Effect.runPromise(program).then((n) => console.log(`repetitions: ${n}`))
+ * ```
  *
  * @since 2.0.0
  * @category repetition / recursion
@@ -12964,6 +13418,7 @@ export declare const repeatOrElse: {
      * initially and then repeats it an additional time if it succeeds.
      *
      * @example
+     * ```ts
      * import { Effect, Schedule } from "effect"
      *
      * let count = 0
@@ -12993,6 +13448,7 @@ export declare const repeatOrElse: {
      * )
      *
      * Effect.runPromise(program).then((n) => console.log(`repetitions: ${n}`))
+     * ```
      *
      * @since 2.0.0
      * @category repetition / recursion
@@ -13007,6 +13463,7 @@ export declare const repeatOrElse: {
      * initially and then repeats it an additional time if it succeeds.
      *
      * @example
+     * ```ts
      * import { Effect, Schedule } from "effect"
      *
      * let count = 0
@@ -13036,6 +13493,7 @@ export declare const repeatOrElse: {
      * )
      *
      * Effect.runPromise(program).then((n) => console.log(`repetitions: ${n}`))
+     * ```
      *
      * @since 2.0.0
      * @category repetition / recursion
@@ -13262,6 +13720,7 @@ export declare const isSuccess: <A, E, R>(self: Effect<A, E, R>) => Effect<boole
  * @see {@link matchEffect} if you need to perform side effects in the handlers.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const success: Effect.Effect<number, Error> = Effect.succeed(42)
@@ -13287,6 +13746,7 @@ export declare const isSuccess: <A, E, R>(self: Effect<A, E, R>) => Effect<boole
  * // Run and log the result of the failed effect
  * Effect.runPromise(program2).then(console.log)
  * // Output: "failure: Uh oh!"
+ * ```
  *
  * @since 2.0.0
  * @category getters & folding
@@ -13305,6 +13765,7 @@ export declare const match: {
      * @see {@link matchEffect} if you need to perform side effects in the handlers.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const success: Effect.Effect<number, Error> = Effect.succeed(42)
@@ -13330,6 +13791,7 @@ export declare const match: {
      * // Run and log the result of the failed effect
      * Effect.runPromise(program2).then(console.log)
      * // Output: "failure: Uh oh!"
+     * ```
      *
      * @since 2.0.0
      * @category getters & folding
@@ -13351,6 +13813,7 @@ export declare const match: {
      * @see {@link matchEffect} if you need to perform side effects in the handlers.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const success: Effect.Effect<number, Error> = Effect.succeed(42)
@@ -13376,6 +13839,7 @@ export declare const match: {
      * // Run and log the result of the failed effect
      * Effect.runPromise(program2).then(console.log)
      * // Output: "failure: Uh oh!"
+     * ```
      *
      * @since 2.0.0
      * @category getters & folding
@@ -13454,6 +13918,7 @@ export declare const matchCause: {
  * @see {@link matchEffect} if you don't need to handle the cause of the failure.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * const task: Effect.Effect<number, Error> = Effect.die("Uh oh!")
@@ -13481,6 +13946,7 @@ export declare const matchCause: {
  *
  * Effect.runSync(program)
  * // Output: "Die: Uh oh!"
+ * ```
  *
  * @since 2.0.0
  * @category getters & folding
@@ -13500,6 +13966,7 @@ export declare const matchCauseEffect: {
      * @see {@link matchEffect} if you don't need to handle the cause of the failure.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * const task: Effect.Effect<number, Error> = Effect.die("Uh oh!")
@@ -13527,6 +13994,7 @@ export declare const matchCauseEffect: {
      *
      * Effect.runSync(program)
      * // Output: "Die: Uh oh!"
+     * ```
      *
      * @since 2.0.0
      * @category getters & folding
@@ -13549,6 +14017,7 @@ export declare const matchCauseEffect: {
      * @see {@link matchEffect} if you don't need to handle the cause of the failure.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * const task: Effect.Effect<number, Error> = Effect.die("Uh oh!")
@@ -13576,6 +14045,7 @@ export declare const matchCauseEffect: {
      *
      * Effect.runSync(program)
      * // Output: "Die: Uh oh!"
+     * ```
      *
      * @since 2.0.0
      * @category getters & folding
@@ -13647,6 +14117,7 @@ export declare const matchEffect: {
  * To adjust the log level, use the `Logger.withMinimumLogLevel` function.
  *
  * @example
+ * ```ts
  * import { Cause, Effect } from "effect"
  *
  * const program = Effect.log(
@@ -13660,6 +14131,7 @@ export declare const matchEffect: {
  * // Output:
  * // timestamp=... level=INFO fiber=#0 message=message1 message=message2 cause="Error: Oh no!
  * // Error: Oh uh!"
+ * ```
  *
  * @since 2.0.0
  * @category Logging
@@ -13687,12 +14159,14 @@ export declare const logTrace: (...message: ReadonlyArray<any>) => Effect<void,
  * `Logger.withMinimumLogLevel` and set the log level to `LogLevel.Debug`.
  *
  * @example
+ * ```ts
  * import { Effect, Logger, LogLevel } from "effect"
  *
  * const program = Effect.logDebug("message1").pipe(Logger.withMinimumLogLevel(LogLevel.Debug))
  *
  * // Effect.runFork(program)
  * // timestamp=... level=DEBUG fiber=#0 message=message1
+ * ```
  *
  * @since 2.0.0
  * @category Logging
@@ -13732,6 +14206,7 @@ export declare const logFatal: (...message: ReadonlyArray<any>) => Effect<void,
  * time-sensitive processes.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -13741,6 +14216,7 @@ export declare const logFatal: (...message: ReadonlyArray<any>) => Effect<void,
  *
  * // Effect.runFork(program)
  * // timestamp=... level=INFO fiber=#0 message="The job is finished!" myspan=1011ms
+ * ```
  *
  * @since 2.0.0
  * @category Logging
@@ -13752,6 +14228,7 @@ export declare const withLogSpan: {
      * time-sensitive processes.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -13761,6 +14238,7 @@ export declare const withLogSpan: {
      *
      * // Effect.runFork(program)
      * // timestamp=... level=INFO fiber=#0 message="The job is finished!" myspan=1011ms
+     * ```
      *
      * @since 2.0.0
      * @category Logging
@@ -13772,6 +14250,7 @@ export declare const withLogSpan: {
      * time-sensitive processes.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -13781,6 +14260,7 @@ export declare const withLogSpan: {
      *
      * // Effect.runFork(program)
      * // timestamp=... level=INFO fiber=#0 message="The job is finished!" myspan=1011ms
+     * ```
      *
      * @since 2.0.0
      * @category Logging
@@ -13793,6 +14273,7 @@ export declare const withLogSpan: {
  * to log messages, making them more informative and easier to trace.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -13803,6 +14284,7 @@ export declare const withLogSpan: {
  * // Effect.runFork(program)
  * // timestamp=... level=INFO fiber=#0 message=message1 key=value
  * // timestamp=... level=INFO fiber=#0 message=message2 key=value
+ * ```
  *
  * @since 2.0.0
  * @category Logging
@@ -13814,6 +14296,7 @@ export declare const annotateLogs: {
      * to log messages, making them more informative and easier to trace.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -13824,6 +14307,7 @@ export declare const annotateLogs: {
      * // Effect.runFork(program)
      * // timestamp=... level=INFO fiber=#0 message=message1 key=value
      * // timestamp=... level=INFO fiber=#0 message=message2 key=value
+     * ```
      *
      * @since 2.0.0
      * @category Logging
@@ -13835,6 +14319,7 @@ export declare const annotateLogs: {
      * to log messages, making them more informative and easier to trace.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -13845,6 +14330,7 @@ export declare const annotateLogs: {
      * // Effect.runFork(program)
      * // timestamp=... level=INFO fiber=#0 message=message1 key=value
      * // timestamp=... level=INFO fiber=#0 message=message2 key=value
+     * ```
      *
      * @since 2.0.0
      * @category Logging
@@ -13856,6 +14342,7 @@ export declare const annotateLogs: {
      * to log messages, making them more informative and easier to trace.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -13866,6 +14353,7 @@ export declare const annotateLogs: {
      * // Effect.runFork(program)
      * // timestamp=... level=INFO fiber=#0 message=message1 key=value
      * // timestamp=... level=INFO fiber=#0 message=message2 key=value
+     * ```
      *
      * @since 2.0.0
      * @category Logging
@@ -13877,6 +14365,7 @@ export declare const annotateLogs: {
      * to log messages, making them more informative and easier to trace.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -13887,6 +14376,7 @@ export declare const annotateLogs: {
      * // Effect.runFork(program)
      * // timestamp=... level=INFO fiber=#0 message=message1 key=value
      * // timestamp=... level=INFO fiber=#0 message=message2 key=value
+     * ```
      *
      * @since 2.0.0
      * @category Logging
@@ -13900,6 +14390,7 @@ export declare const annotateLogs: {
  * defined `Scope`, making it easier to manage context-specific logging.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -13914,6 +14405,7 @@ export declare const annotateLogs: {
  * // timestamp=... level=INFO fiber=#0 message=message1 key=value
  * // timestamp=... level=INFO fiber=#0 message=message2 key=value
  * // timestamp=... level=INFO fiber=#0 message="no annotations again"
+ * ```
  *
  * @since 3.1.0
  * @category Logging
@@ -13926,6 +14418,7 @@ export declare const annotateLogsScoped: {
      * defined `Scope`, making it easier to manage context-specific logging.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -13940,6 +14433,7 @@ export declare const annotateLogsScoped: {
      * // timestamp=... level=INFO fiber=#0 message=message1 key=value
      * // timestamp=... level=INFO fiber=#0 message=message2 key=value
      * // timestamp=... level=INFO fiber=#0 message="no annotations again"
+     * ```
      *
      * @since 3.1.0
      * @category Logging
@@ -13952,6 +14446,7 @@ export declare const annotateLogsScoped: {
      * defined `Scope`, making it easier to manage context-specific logging.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -13966,6 +14461,7 @@ export declare const annotateLogsScoped: {
      * // timestamp=... level=INFO fiber=#0 message=message1 key=value
      * // timestamp=... level=INFO fiber=#0 message=message2 key=value
      * // timestamp=... level=INFO fiber=#0 message="no annotations again"
+     * ```
      *
      * @since 3.1.0
      * @category Logging
@@ -14017,6 +14513,7 @@ export declare const withUnhandledErrorLogLevel: {
  * @see {@link orDieWith} if you need to customize the error.
  *
  * @example
+ * ```ts
  * // Title: Propagating an Error as a Defect
  * import { Effect } from "effect"
  *
@@ -14033,6 +14530,7 @@ export declare const withUnhandledErrorLogLevel: {
  * // Output:
  * // (FiberFailure) Error: Cannot divide by zero
  * //   ...stack trace...
+ * ```
  *
  * @since 2.0.0
  * @category Converting Failures to Defects
@@ -14056,6 +14554,7 @@ export declare const orDie: <A, E, R>(self: Effect<A, E, R>) => Effect<A, never,
  * @see {@link orDie} if you don't need to customize the error.
  *
  * @example
+ * ```ts
  * // Title: Customizing Defect
  * import { Effect } from "effect"
  *
@@ -14075,6 +14574,7 @@ export declare const orDie: <A, E, R>(self: Effect<A, E, R>) => Effect<A, never,
  * // Output:
  * // (FiberFailure) Error: defect: Cannot divide by zero
  * //   ...stack trace...
+ * ```
  *
  * @since 2.0.0
  * @category Converting Failures to Defects
@@ -14098,6 +14598,7 @@ export declare const orDieWith: {
      * @see {@link orDie} if you don't need to customize the error.
      *
      * @example
+     * ```ts
      * // Title: Customizing Defect
      * import { Effect } from "effect"
      *
@@ -14117,6 +14618,7 @@ export declare const orDieWith: {
      * // Output:
      * // (FiberFailure) Error: defect: Cannot divide by zero
      * //   ...stack trace...
+     * ```
      *
      * @since 2.0.0
      * @category Converting Failures to Defects
@@ -14140,6 +14642,7 @@ export declare const orDieWith: {
      * @see {@link orDie} if you don't need to customize the error.
      *
      * @example
+     * ```ts
      * // Title: Customizing Defect
      * import { Effect } from "effect"
      *
@@ -14159,6 +14662,7 @@ export declare const orDieWith: {
      * // Output:
      * // (FiberFailure) Error: defect: Cannot divide by zero
      * //   ...stack trace...
+     * ```
      *
      * @since 2.0.0
      * @category Converting Failures to Defects
@@ -14176,6 +14680,7 @@ export declare const orDieWith: {
  * @see {@link catchAll} if you need to access the error in the fallback effect.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const success = Effect.succeed("success")
@@ -14191,6 +14696,7 @@ export declare const orDieWith: {
  * const program2 = Effect.orElse(failure, () => fallback)
  * console.log(Effect.runSync(program2))
  * // Output: "fallback"
+ * ```
  *
  * @since 2.0.0
  * @category Fallback
@@ -14207,6 +14713,7 @@ export declare const orElse: {
      * @see {@link catchAll} if you need to access the error in the fallback effect.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const success = Effect.succeed("success")
@@ -14222,6 +14729,7 @@ export declare const orElse: {
      * const program2 = Effect.orElse(failure, () => fallback)
      * console.log(Effect.runSync(program2))
      * // Output: "fallback"
+     * ```
      *
      * @since 2.0.0
      * @category Fallback
@@ -14238,6 +14746,7 @@ export declare const orElse: {
      * @see {@link catchAll} if you need to access the error in the fallback effect.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const success = Effect.succeed("success")
@@ -14253,6 +14762,7 @@ export declare const orElse: {
      * const program2 = Effect.orElse(failure, () => fallback)
      * console.log(Effect.runSync(program2))
      * // Output: "fallback"
+     * ```
      *
      * @since 2.0.0
      * @category Fallback
@@ -14272,6 +14782,7 @@ export declare const orElse: {
  * @see {@link mapError} if you need to access the error to transform it.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const validate = (age: number): Effect.Effect<number, string> => {
@@ -14293,6 +14804,7 @@ export declare const orElse: {
  * //   _tag: 'Failure',
  * //   cause: { _id: 'Cause', _tag: 'Fail', failure: 'invalid age' }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Fallback
@@ -14311,6 +14823,7 @@ export declare const orElseFail: {
      * @see {@link mapError} if you need to access the error to transform it.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const validate = (age: number): Effect.Effect<number, string> => {
@@ -14332,6 +14845,7 @@ export declare const orElseFail: {
      * //   _tag: 'Failure',
      * //   cause: { _id: 'Cause', _tag: 'Fail', failure: 'invalid age' }
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category Fallback
@@ -14350,6 +14864,7 @@ export declare const orElseFail: {
      * @see {@link mapError} if you need to access the error to transform it.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const validate = (age: number): Effect.Effect<number, string> => {
@@ -14371,6 +14886,7 @@ export declare const orElseFail: {
      * //   _tag: 'Failure',
      * //   cause: { _id: 'Cause', _tag: 'Fail', failure: 'invalid age' }
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category Fallback
@@ -14395,6 +14911,7 @@ export declare const orElseFail: {
  * already succeeds, it will remain unchanged.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const validate = (age: number): Effect.Effect<number, string> => {
@@ -14412,6 +14929,7 @@ export declare const orElseFail: {
  * console.log(Effect.runSyncExit(program))
  * // Output:
  * // { _id: 'Exit', _tag: 'Success', value: 18 }
+ * ```
  *
  * @since 2.0.0
  * @category Fallback
@@ -14435,6 +14953,7 @@ export declare const orElseSucceed: {
      * already succeeds, it will remain unchanged.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const validate = (age: number): Effect.Effect<number, string> => {
@@ -14452,6 +14971,7 @@ export declare const orElseSucceed: {
      * console.log(Effect.runSyncExit(program))
      * // Output:
      * // { _id: 'Exit', _tag: 'Success', value: 18 }
+     * ```
      *
      * @since 2.0.0
      * @category Fallback
@@ -14475,6 +14995,7 @@ export declare const orElseSucceed: {
      * already succeeds, it will remain unchanged.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const validate = (age: number): Effect.Effect<number, string> => {
@@ -14492,6 +15013,7 @@ export declare const orElseSucceed: {
      * console.log(Effect.runSyncExit(program))
      * // Output:
      * // { _id: 'Exit', _tag: 'Success', value: 18 }
+     * ```
      *
      * @since 2.0.0
      * @category Fallback
@@ -14516,6 +15038,7 @@ export declare const orElseSucceed: {
  * error.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * interface Config {
@@ -14562,6 +15085,7 @@ export declare const orElseSucceed: {
  * // Unavailable config for node2
  * // Config for node3 found
  * // { host: 'node3.example.com', port: 8080, apiKey: '12345-abcde' }
+ * ```
  *
  * @since 2.0.0
  * @category Fallback
@@ -14836,6 +15360,7 @@ export declare const unsafeMakeLatch: (open?: boolean | undefined) => Latch;
  * @category latch
  * @since 3.8.0
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * Effect.gen(function*() {
@@ -14852,6 +15377,7 @@ export declare const unsafeMakeLatch: (open?: boolean | undefined) => Latch;
  *   yield* latch.open
  *   yield* fiber.await
  * })
+ * ```
  */
 export declare const makeLatch: (open?: boolean | undefined) => Effect<Latch, never, never>;
 /**
@@ -14868,6 +15394,7 @@ export declare const makeLatch: (open?: boolean | undefined) => Effect<Latch, ne
  * `runFork` is a good default choice.
  *
  * @example
+ * ```ts
  * // Title: Running an Effect in the Background
  * import { Effect, Console, Schedule, Fiber } from "effect"
  *
@@ -14885,6 +15412,7 @@ export declare const makeLatch: (open?: boolean | undefined) => Effect<Latch, ne
  * setTimeout(() => {
  *   Effect.runFork(Fiber.interrupt(fiber))
  * }, 500)
+ * ```
  *
  * @since 2.0.0
  * @category Running Effects
@@ -14910,11 +15438,13 @@ export declare const runCallback: <A, E>(effect: Effect<A, E>, options?: Runtime
  * @see {@link runPromiseExit} for a version that returns an `Exit` type instead of rejecting.
  *
  * @example
+ * ```ts
  * // Title: Running a Successful Effect as a Promise
  * import { Effect } from "effect"
  *
  * Effect.runPromise(Effect.succeed(1)).then(console.log)
  * // Output: 1
+ * ```
  *
  * @example
  * //Example: Handling a Failing Effect as a Rejected Promise
@@ -14947,6 +15477,7 @@ export declare const runPromise: <A, E>(effect: Effect<A, E, never>, options?: {
  *   a `Cause` type.
  *
  * @example
+ * ```ts
  * // Title: Handling Results as Exit
  * import { Effect } from "effect"
  *
@@ -14971,6 +15502,7 @@ export declare const runPromise: <A, E>(effect: Effect<A, E, never>, options?: {
  * //     failure: "my error"
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Running Effects
@@ -14994,6 +15526,7 @@ export declare const runPromiseExit: <A, E>(effect: Effect<A, E, never>, options
  * throwing an error.
  *
  * @example
+ * ```ts
  * // Title: Synchronous Logging
  * import { Effect } from "effect"
  *
@@ -15007,6 +15540,7 @@ export declare const runPromiseExit: <A, E>(effect: Effect<A, E, never>, options
  *
  * console.log(result)
  * // Output: 1
+ * ```
  *
  * @example
  * // Title: Incorrect Usage with Failing or Async Effects
@@ -15055,6 +15589,7 @@ export declare const runSync: <A, E>(effect: Effect<A, E>) => A;
  * resolved synchronously.
  *
  * @example
+ * ```ts
  * // Title: Handling Results as Exit
  * import { Effect } from "effect"
  *
@@ -15077,6 +15612,7 @@ export declare const runSync: <A, E>(effect: Effect<A, E>) => A;
  * //     failure: "my error"
  * //   }
  * // }
+ * ```
  *
  * @example
  * // Title: Asynchronous Operation Resulting in Die
@@ -15117,6 +15653,7 @@ export declare const runSyncExit: <A, E>(effect: Effect<A, E>) => Exit.Exit<A, E
  * @see {@link zip} for a version that stops at the first error.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * const task1 = Console.log("task1").pipe(Effect.as(1))
@@ -15144,6 +15681,7 @@ export declare const runSyncExit: <A, E>(effect: Effect<A, E>) => Exit.Exit<A, E
  * //     right: { _id: 'Cause', _tag: 'Fail', failure: 'Oh no!' }
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Error Accumulation
@@ -15164,6 +15702,7 @@ export declare const validate: {
      * @see {@link zip} for a version that stops at the first error.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * const task1 = Console.log("task1").pipe(Effect.as(1))
@@ -15191,6 +15730,7 @@ export declare const validate: {
      * //     right: { _id: 'Cause', _tag: 'Fail', failure: 'Oh no!' }
      * //   }
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category Error Accumulation
@@ -15215,6 +15755,7 @@ export declare const validate: {
      * @see {@link zip} for a version that stops at the first error.
      *
      * @example
+     * ```ts
      * import { Effect, Console } from "effect"
      *
      * const task1 = Console.log("task1").pipe(Effect.as(1))
@@ -15242,6 +15783,7 @@ export declare const validate: {
      * //     right: { _id: 'Cause', _tag: 'Fail', failure: 'Oh no!' }
      * //   }
      * // }
+     * ```
      *
      * @since 2.0.0
      * @category Error Accumulation
@@ -15300,6 +15842,7 @@ export declare const validateWith: {
  * @see {@link validate} for a version that accumulates errors.
  *
  * @example
+ * ```ts
  * // Title: Combining Two Effects Sequentially
  * import { Effect } from "effect"
  *
@@ -15323,6 +15866,7 @@ export declare const validateWith: {
  * // timestamp=... level=INFO fiber=#0 message="task1 done"
  * // timestamp=... level=INFO fiber=#0 message="task2 done"
  * // [ 1, 'hello' ]
+ * ```
  *
  * @example
  * // Title: Combining Two Effects Concurrently
@@ -15365,6 +15909,7 @@ export declare const zip: {
      * @see {@link validate} for a version that accumulates errors.
      *
      * @example
+     * ```ts
      * // Title: Combining Two Effects Sequentially
      * import { Effect } from "effect"
      *
@@ -15388,6 +15933,7 @@ export declare const zip: {
      * // timestamp=... level=INFO fiber=#0 message="task1 done"
      * // timestamp=... level=INFO fiber=#0 message="task2 done"
      * // [ 1, 'hello' ]
+     * ```
      *
      * @example
      * // Title: Combining Two Effects Concurrently
@@ -15434,6 +15980,7 @@ export declare const zip: {
      * @see {@link validate} for a version that accumulates errors.
      *
      * @example
+     * ```ts
      * // Title: Combining Two Effects Sequentially
      * import { Effect } from "effect"
      *
@@ -15457,6 +16004,7 @@ export declare const zip: {
      * // timestamp=... level=INFO fiber=#0 message="task1 done"
      * // timestamp=... level=INFO fiber=#0 message="task2 done"
      * // [ 1, 'hello' ]
+     * ```
      *
      * @example
      * // Title: Combining Two Effects Concurrently
@@ -15507,6 +16055,7 @@ export declare const zip: {
  * @see {@link zipRight} for a version that returns the result of the second effect.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const task1 = Effect.succeed(1).pipe(
@@ -15525,6 +16074,7 @@ export declare const zip: {
  * // timestamp=... level=INFO fiber=#0 message="task1 done"
  * // timestamp=... level=INFO fiber=#0 message="task2 done"
  * // 1
+ * ```
  *
  * @since 2.0.0
  * @category Zipping
@@ -15548,6 +16098,7 @@ export declare const zipLeft: {
      * @see {@link zipRight} for a version that returns the result of the second effect.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const task1 = Effect.succeed(1).pipe(
@@ -15566,6 +16117,7 @@ export declare const zipLeft: {
      * // timestamp=... level=INFO fiber=#0 message="task1 done"
      * // timestamp=... level=INFO fiber=#0 message="task2 done"
      * // 1
+     * ```
      *
      * @since 2.0.0
      * @category Zipping
@@ -15593,6 +16145,7 @@ export declare const zipLeft: {
      * @see {@link zipRight} for a version that returns the result of the second effect.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const task1 = Effect.succeed(1).pipe(
@@ -15611,6 +16164,7 @@ export declare const zipLeft: {
      * // timestamp=... level=INFO fiber=#0 message="task1 done"
      * // timestamp=... level=INFO fiber=#0 message="task2 done"
      * // 1
+     * ```
      *
      * @since 2.0.0
      * @category Zipping
@@ -15639,6 +16193,7 @@ export declare const zipLeft: {
  * @see {@link zipLeft} for a version that returns the result of the first effect.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const task1 = Effect.succeed(1).pipe(
@@ -15657,6 +16212,7 @@ export declare const zipLeft: {
  * // timestamp=... level=INFO fiber=#0 message="task1 done"
  * // timestamp=... level=INFO fiber=#0 message="task2 done"
  * // hello
+ * ```
  *
  * @since 2.0.0
  * @category Zipping
@@ -15680,6 +16236,7 @@ export declare const zipRight: {
      * @see {@link zipLeft} for a version that returns the result of the first effect.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const task1 = Effect.succeed(1).pipe(
@@ -15698,6 +16255,7 @@ export declare const zipRight: {
      * // timestamp=... level=INFO fiber=#0 message="task1 done"
      * // timestamp=... level=INFO fiber=#0 message="task2 done"
      * // hello
+     * ```
      *
      * @since 2.0.0
      * @category Zipping
@@ -15725,6 +16283,7 @@ export declare const zipRight: {
      * @see {@link zipLeft} for a version that returns the result of the first effect.
      *
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * const task1 = Effect.succeed(1).pipe(
@@ -15743,6 +16302,7 @@ export declare const zipRight: {
      * // timestamp=... level=INFO fiber=#0 message="task1 done"
      * // timestamp=... level=INFO fiber=#0 message="task2 done"
      * // hello
+     * ```
      *
      * @since 2.0.0
      * @category Zipping
@@ -15769,6 +16329,7 @@ export declare const zipRight: {
  * use the `{ concurrent: true }` option.
  *
  * @example
+ * ```ts
  * // Title: Combining Effects with a Custom Function
  * import { Effect } from "effect"
  *
@@ -15793,6 +16354,7 @@ export declare const zipRight: {
  * // timestamp=... level=INFO fiber=#3 message="task1 done"
  * // timestamp=... level=INFO fiber=#2 message="task2 done"
  * // 6
+ * ```
  *
  * @since 2.0.0
  * @category Zipping
@@ -15814,6 +16376,7 @@ export declare const zipWith: {
      * use the `{ concurrent: true }` option.
      *
      * @example
+     * ```ts
      * // Title: Combining Effects with a Custom Function
      * import { Effect } from "effect"
      *
@@ -15838,6 +16401,7 @@ export declare const zipWith: {
      * // timestamp=... level=INFO fiber=#3 message="task1 done"
      * // timestamp=... level=INFO fiber=#2 message="task2 done"
      * // 6
+     * ```
      *
      * @since 2.0.0
      * @category Zipping
@@ -15863,6 +16427,7 @@ export declare const zipWith: {
      * use the `{ concurrent: true }` option.
      *
      * @example
+     * ```ts
      * // Title: Combining Effects with a Custom Function
      * import { Effect } from "effect"
      *
@@ -15887,6 +16452,7 @@ export declare const zipWith: {
      * // timestamp=... level=INFO fiber=#3 message="task1 done"
      * // timestamp=... level=INFO fiber=#2 message="task2 done"
      * // 6
+     * ```
      *
      * @since 2.0.0
      * @category Zipping
@@ -16038,6 +16604,7 @@ export declare const withTracerScoped: (value: Tracer.Tracer) => Effect<void, ne
  * @since 2.0.0
  * @category Tracing
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * Effect.succeed(42).pipe(
@@ -16045,6 +16612,7 @@ export declare const withTracerScoped: (value: Tracer.Tracer) => Effect<void, ne
  *   // the span will not be registered with the tracer
  *   Effect.withTracerEnabled(false)
  * )
+ * ```
  */
 export declare const withTracerEnabled: {
     /**
@@ -16053,6 +16621,7 @@ export declare const withTracerEnabled: {
      * @since 2.0.0
      * @category Tracing
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * Effect.succeed(42).pipe(
@@ -16060,6 +16629,7 @@ export declare const withTracerEnabled: {
      *   // the span will not be registered with the tracer
      *   Effect.withTracerEnabled(false)
      * )
+     * ```
      */
     (enabled: boolean): <A, E, R>(effect: Effect<A, E, R>) => Effect<A, E, R>;
     /**
@@ -16068,6 +16638,7 @@ export declare const withTracerEnabled: {
      * @since 2.0.0
      * @category Tracing
      * @example
+     * ```ts
      * import { Effect } from "effect"
      *
      * Effect.succeed(42).pipe(
@@ -16075,6 +16646,7 @@ export declare const withTracerEnabled: {
      *   // the span will not be registered with the tracer
      *   Effect.withTracerEnabled(false)
      * )
+     * ```
      */
     <A, E, R>(effect: Effect<A, E, R>, enabled: boolean): Effect<A, E, R>;
 };
@@ -16289,6 +16861,7 @@ export interface FunctionWithSpanOptions {
  * @since 3.2.0
  * @category Tracing
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const getTodo = Effect.functionWithSpan({
@@ -16298,6 +16871,7 @@ export interface FunctionWithSpanOptions {
  *     attributes: { id }
  *   })
  * })
+ * ```
  */
 export declare const functionWithSpan: <Args extends Array<any>, Ret extends Effect<any, any, any>>(options: {
     readonly body: (...args: Args) => Ret;
@@ -16366,6 +16940,7 @@ export declare const withParentSpan: {
  * value.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * //      ┌─── Effect<number, NoSuchElementException, never>
@@ -16391,6 +16966,7 @@ export declare const withParentSpan: {
  * //     failure: { _tag: 'NoSuchElementException' }
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Optional Wrapping
@@ -16408,6 +16984,7 @@ export declare const fromNullable: <A>(value: A) => Effect<NonNullable<A>, Cause
  * unchanged.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * //      ┌─── Effect<number, NoSuchElementException, never>
@@ -16431,6 +17008,7 @@ export declare const fromNullable: <A>(value: A) => Effect<NonNullable<A>, Cause
  *
  * Effect.runPromise(option2).then(console.log)
  * // Output: { _tag: 'None' }
+ * ```
  *
  * @since 2.0.0
  * @category Optional Wrapping
@@ -16472,6 +17050,7 @@ export declare namespace Tag {
 }
 /**
  * @example
+ * ```ts
  * import { Effect, Layer } from "effect"
  *
  * class MapTag extends Effect.Tag("MapTag")<MapTag, Map<string, string>>() {
@@ -16480,6 +17059,7 @@ export declare namespace Tag {
  *    Effect.sync(() => new Map())
  *  )
  * }
+ * ```
  *
  * @since 2.0.0
  * @category Context
@@ -16489,6 +17069,7 @@ export declare const Tag: <const Id extends string>(id: Id) => <Self, Type exten
 };
 /**
  * @example
+ * ```ts
  * import { Effect } from 'effect';
  *
  * class Prefix extends Effect.Service<Prefix>()("Prefix", {
@@ -16508,6 +17089,7 @@ export declare const Tag: <const Id extends string>(id: Id) => <Self, Type exten
  *  }),
  *  dependencies: [Prefix.Default]
  * }) {}
+ * ```
  *
  * @since 3.9.0
  * @category Context
@@ -16663,4 +17245,79 @@ export declare namespace Service {
         readonly accessors: true;
     } ? true : false;
 }
+/**
+ * @since 3.11.0
+ * @category models
+ */
+export declare namespace fn {
+    /**
+     * @since 3.11.0
+     * @category models
+     */
+    type FnEffect<AEff, Eff extends YieldWrap<Effect<any, any, any>>> = Effect<AEff, [
+        Eff
+    ] extends [never] ? never : [Eff] extends [YieldWrap<Effect<infer _A, infer E, infer _R>>] ? E : never, [
+        Eff
+    ] extends [never] ? never : [Eff] extends [YieldWrap<Effect<infer _A, infer _E, infer R>>] ? R : never>;
+    /**
+     * @since 3.11.0
+     * @category models
+     */
+    type Gen = {
+        <Eff extends YieldWrap<Effect<any, any, any>>, AEff, Args extends Array<any>>(body: (...args: Args) => Generator<Eff, AEff, never>): (...args: Args) => fn.FnEffect<AEff, Eff>;
+        <Eff extends YieldWrap<Effect<any, any, any>>, AEff, Args extends Array<any>, A extends Effect<any, any, any>>(body: (...args: Args) => Generator<Eff, AEff, never>, a: (_: fn.FnEffect<AEff, Eff>) => A): (...args: Args) => A;
+        <Eff extends YieldWrap<Effect<any, any, any>>, AEff, Args extends Array<any>, A, B extends Effect<any, any, any>>(body: (...args: Args) => Generator<Eff, AEff, never>, a: (_: fn.FnEffect<AEff, Eff>) => A, b: (_: A) => B): (...args: Args) => B;
+        <Eff extends YieldWrap<Effect<any, any, any>>, AEff, Args extends Array<any>, A, B, C extends Effect<any, any, any>>(body: (...args: Args) => Generator<Eff, AEff, never>, a: (_: fn.FnEffect<AEff, Eff>) => A, b: (_: A) => B, c: (_: B) => C): (...args: Args) => C;
+        <Eff extends YieldWrap<Effect<any, any, any>>, AEff, Args extends Array<any>, A, B, C, D extends Effect<any, any, any>>(body: (...args: Args) => Generator<Eff, AEff, never>, a: (_: fn.FnEffect<AEff, Eff>) => A, b: (_: A) => B, c: (_: B) => C, d: (_: C) => D): (...args: Args) => D;
+        <Eff extends YieldWrap<Effect<any, any, any>>, AEff, Args extends Array<any>, A, B, C, D, E extends Effect<any, any, any>>(body: (...args: Args) => Generator<Eff, AEff, never>, a: (_: fn.FnEffect<AEff, Eff>) => A, b: (_: A) => B, c: (_: B) => C, d: (_: C) => D, e: (_: D) => E): (...args: Args) => E;
+        <Eff extends YieldWrap<Effect<any, any, any>>, AEff, Args extends Array<any>, A, B, C, D, E, F extends Effect<any, any, any>>(body: (...args: Args) => Generator<Eff, AEff, never>, a: (_: fn.FnEffect<AEff, Eff>) => A, b: (_: A) => B, c: (_: B) => C, d: (_: C) => D, e: (_: D) => E, f: (_: E) => F): (...args: Args) => F;
+        <Eff extends YieldWrap<Effect<any, any, any>>, AEff, Args extends Array<any>, A, B, C, D, E, F, G extends Effect<any, any, any>>(body: (...args: Args) => Generator<Eff, AEff, never>, a: (_: fn.FnEffect<AEff, Eff>) => A, b: (_: A) => B, c: (_: B) => C, d: (_: C) => D, e: (_: D) => E, f: (_: E) => F, g: (_: F) => G): (...args: Args) => G;
+        <Eff extends YieldWrap<Effect<any, any, any>>, AEff, Args extends Array<any>, A, B, C, D, E, F, G, H extends Effect<any, any, any>>(body: (...args: Args) => Generator<Eff, AEff, never>, a: (_: fn.FnEffect<AEff, Eff>) => A, b: (_: A) => B, c: (_: B) => C, d: (_: C) => D, e: (_: D) => E, f: (_: E) => F, g: (_: F) => G, h: (_: G) => H): (...args: Args) => H;
+        <Eff extends YieldWrap<Effect<any, any, any>>, AEff, Args extends Array<any>, A, B, C, D, E, F, G, H, I extends Effect<any, any, any>>(body: (...args: Args) => Generator<Eff, AEff, never>, a: (_: fn.FnEffect<AEff, Eff>) => A, b: (_: A) => B, c: (_: B) => C, d: (_: C) => D, e: (_: D) => E, f: (_: E) => F, g: (_: F) => G, h: (_: G) => H, i: (_: H) => I): (...args: Args) => I;
+    };
+    /**
+     * @since 3.11.0
+     * @category models
+     */
+    type NonGen = {
+        <Eff extends Effect<any, any, any>, Args extends Array<any>>(body: (...args: Args) => Eff): (...args: Args) => Eff;
+        <Eff extends Effect<any, any, any>, A, Args extends Array<any>>(body: (...args: Args) => A, a: (_: A) => Eff): (...args: Args) => Eff;
+        <Eff extends Effect<any, any, any>, A, B, Args extends Array<any>>(body: (...args: Args) => A, a: (_: A) => B, b: (_: B) => Eff): (...args: Args) => Eff;
+        <Eff extends Effect<any, any, any>, A, B, C, Args extends Array<any>>(body: (...args: Args) => A, a: (_: A) => B, b: (_: B) => C, c: (_: C) => Eff): (...args: Args) => Eff;
+        <Eff extends Effect<any, any, any>, A, B, C, D, Args extends Array<any>>(body: (...args: Args) => A, a: (_: A) => B, b: (_: B) => C, c: (_: C) => D, d: (_: D) => Eff): (...args: Args) => Eff;
+        <Eff extends Effect<any, any, any>, A, B, C, D, E, Args extends Array<any>>(body: (...args: Args) => A, a: (_: A) => B, b: (_: B) => C, c: (_: C) => D, d: (_: D) => E, e: (_: E) => Eff): (...args: Args) => Eff;
+        <Eff extends Effect<any, any, any>, A, B, C, D, E, F, Args extends Array<any>>(body: (...args: Args) => A, a: (_: A) => B, b: (_: B) => C, c: (_: C) => D, d: (_: D) => E, e: (_: E) => F, f: (_: E) => Eff): (...args: Args) => Eff;
+        <Eff extends Effect<any, any, any>, A, B, C, D, E, F, G, Args extends Array<any>>(body: (...args: Args) => A, a: (_: A) => B, b: (_: B) => C, c: (_: C) => D, d: (_: D) => E, e: (_: E) => F, f: (_: E) => G, g: (_: G) => Eff): (...args: Args) => Eff;
+        <Eff extends Effect<any, any, any>, A, B, C, D, E, F, G, H, Args extends Array<any>>(body: (...args: Args) => A, a: (_: A) => B, b: (_: B) => C, c: (_: C) => D, d: (_: D) => E, e: (_: E) => F, f: (_: E) => G, g: (_: G) => H, h: (_: H) => Eff): (...args: Args) => Eff;
+        <Eff extends Effect<any, any, any>, A, B, C, D, E, F, G, H, I, Args extends Array<any>>(body: (...args: Args) => A, a: (_: A) => B, b: (_: B) => C, c: (_: C) => D, d: (_: D) => E, e: (_: E) => F, f: (_: E) => G, g: (_: G) => H, h: (_: H) => I, i: (_: H) => Eff): (...args: Args) => Eff;
+    };
+}
+/**
+ * Creates a function that returns an Effect which is automatically traced with a span pointing to the call site.
+ *
+ * The function can be created both using a generator function that can yield effects or using a normal function.
+ *
+ * @since 3.11.0
+ * @category function
+ *
+ * @example
+ * import { Effect } from "effect"
+ *
+ * const logExample = Effect.fn("logExample")(
+ *   function*<N extends number>(n: N) {
+ *     yield* Effect.annotateCurrentSpan("n", n)
+ *     yield* Effect.logInfo(`got: ${n}`)
+ *     yield* Effect.fail(new Error())
+ *   },
+ *   Effect.delay("1 second")
+ * )
+ *
+ * Effect.runFork(
+ *   // this location is printed on the stack trace of the following `Effect.logError`
+ *   logExample(100).pipe(
+ *     Effect.catchAllCause(Effect.logError)
+ *   )
+ * )
+ */
+export declare const fn: (name: string, options?: Tracer.SpanOptions) => fn.Gen & fn.NonGen;
 //# sourceMappingURL=Effect.d.ts.map