effect 3.10.18 → 3.10.19

package/dist/cjs/Effect.js

@@ -47,6 +47,7 @@ const isEffect = exports.isEffect = core.isEffect;
  * be recomputed upon next evaluation.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * let i = 1
@@ -74,6 +75,7 @@ const isEffect = exports.isEffect = core.isEffect;
  * // result 1
  * // expensive task...
  * // result 2
+ * ```
  *
  * @since 2.0.0
  * @category Caching
@@ -85,6 +87,7 @@ const cachedWithTTL = exports.cachedWithTTL = circular.cached;
  * invalidating the cached value before it naturally expires.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * let i = 1
@@ -115,6 +118,7 @@ const cachedWithTTL = exports.cachedWithTTL = circular.cached;
  * // result 1
  * // expensive task...
  * // result 2
+ * ```
  *
  * @since 2.0.0
  * @category Caching
@@ -126,6 +130,7 @@ const cachedInvalidateWithTTL = exports.cachedInvalidateWithTTL = circular.cache
  * the logic.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * let i = 1
@@ -159,6 +164,7 @@ const cachedInvalidateWithTTL = exports.cachedInvalidateWithTTL = circular.cache
  * // expensive task...
  * // result 3
  * // result 3
+ * ```
  *
  * @since 2.0.0
  * @category Caching
@@ -170,6 +176,7 @@ const cached = exports.cached = effect.memoize;
  * recompute them.
  *
  * @example
+ * ```ts
  * import { Effect, Random } from "effect"
  *
  * const program = Effect.gen(function* () {
@@ -192,6 +199,7 @@ const cached = exports.cached = effect.memoize;
  * // memoized version:
  * // 5
  * // 5
+ * ```
  *
  * @since 2.0.0
  * @category Caching
@@ -202,6 +210,7 @@ const cachedFunction = exports.cachedFunction = circular.cachedFunction;
  * called.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * const program = Effect.gen(function* () {
@@ -217,6 +226,7 @@ const cachedFunction = exports.cachedFunction = circular.cachedFunction;
  * // task1
  * // task1
  * // task2
+ * ```
  *
  * @since 2.0.0
  * @category Caching
@@ -272,6 +282,7 @@ const once = exports.once = effect.once;
  * @see {@link forEach} for iterating over elements and applying an effect.
  *
  * @example
+ * ```ts
  * // Title: Combining Effects in Tuples
  * import { Effect, Console } from "effect"
  *
@@ -289,6 +300,7 @@ const once = exports.once = effect.once;
  * // 42
  * // Hello
  * // [ 42, 'Hello' ]
+ * ```
  *
  * @example
  * // Title: Combining Effects in Iterables
@@ -437,6 +449,7 @@ const all = exports.all = fiberRuntime.all;
  * your data and then apply operations to it.
  *
  * @example
+ * ```ts
  * import { Effect, pipe } from "effect"
  *
  * const task1 = Effect.succeed(1).pipe(
@@ -460,6 +473,7 @@ const all = exports.all = fiberRuntime.all;
  * // timestamp=... level=INFO fiber=#3 message="task2 done"
  * // timestamp=... level=INFO fiber=#2 message="task1 done"
  * // [ 1, 'hello' ]
+ * ```
  *
  * @since 2.0.0
  * @category Collecting
@@ -521,6 +535,7 @@ const filter = exports.filter = fiberRuntime.filter;
  * @see {@link filter} for concurrent filtering without mapping.
  *
  * @example
+ * ```ts
  * import { Console, Effect, Option } from "effect"
  *
  * const task = (n: number) =>
@@ -541,6 +556,7 @@ const filter = exports.filter = fiberRuntime.filter;
  * // task3 done
  * // task4 done
  * // [ 2, 4 ]
+ * ```
  *
  * @since 2.0.0
  * @category Filtering
@@ -577,6 +593,7 @@ const findFirst = exports.findFirst = effect.findFirst;
  * @see {@link all} for combining multiple effects into one.
  *
  * @example
+ * ```ts
  * // Title: Applying Effects to Iterable Elements
  * import { Effect, Console } from "effect"
  *
@@ -592,6 +609,7 @@ const findFirst = exports.findFirst = effect.findFirst;
  * // Currently at index 3
  * // Currently at index 4
  * // [ 2, 4, 6, 8, 10 ]
+ * ```
  *
  * @example
  * // Title: Using discard to Ignore Results
@@ -650,6 +668,7 @@ const mergeAll = exports.mergeAll = fiberRuntime.mergeAll;
  * @see {@link validateFirst} for a function that stops at the first success.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * //      ┌─── Effect<[string[], number[]], never, never>
@@ -665,6 +684,7 @@ const mergeAll = exports.mergeAll = fiberRuntime.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
@@ -745,6 +765,7 @@ const takeWhile = exports.takeWhile = effect.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>
@@ -771,6 +792,7 @@ const takeWhile = exports.takeWhile = effect.takeWhile;
  * //     failure: [ '4 is not less that 4', '5 is not less that 4' ]
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Error Accumulation
@@ -792,6 +814,7 @@ const validateAll = exports.validateAll = fiberRuntime.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>
@@ -808,6 +831,7 @@ const validateAll = exports.validateAll = fiberRuntime.validateAll;
  * // Output:
  * // item 4
  * // 4
+ * ```
  *
  * @since 2.0.0
  * @category Error Accumulation
@@ -838,6 +862,7 @@ const validateFirst = exports.validateFirst = fiberRuntime.validateFirst;
  * behavior of the returned effect.
  *
  * @example
+ * ```ts
  * // Title: Wrapping a Callback API
  * import { Effect } from "effect"
  * import * as NodeFS from "node:fs"
@@ -858,6 +883,7 @@ const validateFirst = exports.validateFirst = fiberRuntime.validateFirst;
  * //      ┌─── Effect<Buffer, Error, never>
  * //      ▼
  * const program = readFile("example.txt")
+ * ```
  *
  * @example
  * // Title: Handling Interruption with Cleanup
@@ -948,12 +974,14 @@ const asyncEffect = exports.asyncEffect = _runtime.asyncEffect;
  * 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
@@ -976,6 +1004,7 @@ const withFiberRuntime = exports.withFiberRuntime = core.withFiberRuntime;
  * @see {@link succeed} to create an effect that represents a successful value.
  *
  * @example
+ * ```ts
  * // Title: Creating a Failed Effect
  * import { Effect } from "effect"
  *
@@ -984,6 +1013,7 @@ const withFiberRuntime = exports.withFiberRuntime = core.withFiberRuntime;
  * const failure = Effect.fail(
  *   new Error("Operation failed due to network error")
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Creating Effects
@@ -1025,6 +1055,7 @@ const failCauseSync = exports.failCauseSync = core.failCauseSync;
  * @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"
  *
@@ -1041,6 +1072,7 @@ const failCauseSync = exports.failCauseSync = core.failCauseSync;
  * // Output:
  * // (FiberFailure) Error: Cannot divide by zero
  * //   ...stack trace...
+ * ```
  *
  * @since 2.0.0
  * @category Creating Effects
@@ -1069,6 +1101,7 @@ const die = exports.die = core.die;
  * lazily.
  *
  * @example
+ * ```ts
  * // Title: Terminating on Division by Zero with a Specified Message
  * import { Effect } from "effect"
  *
@@ -1085,6 +1118,7 @@ const die = exports.die = core.die;
  * // Output:
  * // (FiberFailure) RuntimeException: Cannot divide by zero
  * //   ...stack trace...
+ * ```
  *
  * @since 2.0.0
  * @category Creating Effects
@@ -1118,6 +1152,7 @@ const dieSync = exports.dieSync = core.dieSync;
  * effects and return the final result at the end.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const addServiceCharge = (amount: number) => amount + 1
@@ -1144,6 +1179,7 @@ const dieSync = exports.dieSync = core.dieSync;
  *   const finalAmount = addServiceCharge(discountedAmount)
  *   return `Final amount to charge: ${finalAmount}`
  * })
+ * ```
  *
  * @since 2.0.0
  * @category Creating Effects
@@ -1190,6 +1226,7 @@ const none = exports.none = effect.none;
  * @see {@link tryPromise} for a version that can handle failures.
  *
  * @example
+ * ```ts
  * // Title: Delayed Message
  * import { Effect } from "effect"
  *
@@ -1206,6 +1243,7 @@ const none = exports.none = effect.none;
  * //      ┌─── Effect<string, never, never>
  * //      ▼
  * const program = delay("Async operation completed successfully!")
+ * ```
  *
  * @since 2.0.0
  * @category Creating Effects
@@ -1222,6 +1260,7 @@ const promise = exports.promise = effect.promise;
  * @see {@link fail} to create an effect that represents a failure.
  *
  * @example
+ * ```ts
  * // Title: Creating a Successful Effect
  * import { Effect } from "effect"
  *
@@ -1230,6 +1269,7 @@ const promise = exports.promise = effect.promise;
  * //      ┌─── Effect<number, never, never>
  * //      ▼
  * const success = Effect.succeed(42)
+ * ```
  *
  * @since 2.0.0
  * @category Creating Effects
@@ -1264,6 +1304,7 @@ const succeedSome = exports.succeedSome = effect.succeedSome;
  * - **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"
  *
@@ -1278,6 +1319,7 @@ const succeedSome = exports.succeedSome = effect.succeedSome;
  *
  * console.log(Effect.runSync(good)) // Output: 1
  * console.log(Effect.runSync(good)) // Output: 2
+ * ```
  *
  * @example
  * // Title: Recursive Fibonacci
@@ -1350,6 +1392,7 @@ const suspend = exports.suspend = core.suspend;
  * @see {@link try_ | try} for a version that can handle failures.
  *
  * @example
+ * ```ts
  * // Title: Logging a Message
  * import { Effect } from "effect"
  *
@@ -1361,6 +1404,7 @@ const suspend = exports.suspend = core.suspend;
  * //      ┌─── Effect<void, never, never>
  * //      ▼
  * const program = log("Hello, World!")
+ * ```
  *
  * @since 2.0.0
  * @category Creating Effects
@@ -1389,6 +1433,7 @@ const _catch = exports.catch = effect._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"
  *
@@ -1421,6 +1466,7 @@ const _catch = exports.catch = effect._catch;
  *     Effect.succeed(`Recovering from ${error._tag}`)
  *   )
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1444,6 +1490,7 @@ const catchAll = exports.catchAll = core.catchAll;
  * dynamically loaded plugins, controlled recovery might be needed.
  *
  * @example
+ * ```ts
  * // Title: Recovering from All Errors
  * import { Cause, Effect } from "effect"
  *
@@ -1461,6 +1508,7 @@ const catchAll = exports.catchAll = core.catchAll;
  *
  * Effect.runPromise(recovered).then(console.log)
  * // Output: "Recovered from a regular error"
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1490,6 +1538,7 @@ const catchAllCause = exports.catchAllCause = core.catchAllCause;
  * dynamically loaded plugins, controlled recovery might be needed.
  *
  * @example
+ * ```ts
  * // Title: Handling All Defects
  * import { Effect, Cause, Console } from "effect"
  *
@@ -1514,6 +1563,7 @@ const catchAllCause = exports.catchAllCause = core.catchAllCause;
  * //   _tag: "Success",
  * //   value: undefined
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1531,6 +1581,7 @@ const catchAllDefect = exports.catchAllDefect = effect.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"
  *
@@ -1565,6 +1616,7 @@ const catchAllDefect = exports.catchAllDefect = effect.catchAllDefect;
  *     () => Effect.succeed("Recovering from HttpError")
  *   )
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1585,6 +1637,7 @@ const catchIf = exports.catchIf = core.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"
  *
@@ -1622,6 +1675,7 @@ const catchIf = exports.catchIf = core.catchIf;
  *     }
  *   })
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1661,6 +1715,7 @@ const catchSomeCause = exports.catchSomeCause = effect.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"
  *
@@ -1691,6 +1746,7 @@ const catchSomeCause = exports.catchSomeCause = effect.catchSomeCause;
  * //     defect: { _tag: 'RuntimeException' }
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1714,6 +1770,7 @@ const catchSomeDefect = exports.catchSomeDefect = effect.catchSomeDefect;
  * types at once.
  *
  * @example
+ * ```ts
  * // Title: Handling Errors by Tag
  * import { Effect, Random } from "effect"
  *
@@ -1747,6 +1804,7 @@ const catchSomeDefect = exports.catchSomeDefect = effect.catchSomeDefect;
  *     Effect.succeed("Recovering from HttpError")
  *   )
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1767,6 +1825,7 @@ const catchTag = exports.catchTag = effect.catchTag;
  * field is used to identify and match errors.
  *
  * @example
+ * ```ts
  * // Title: Handling Multiple Tagged Error Types at Once
  * import { Effect, Random } from "effect"
  *
@@ -1802,6 +1861,7 @@ const catchTag = exports.catchTag = effect.catchTag;
  *       Effect.succeed(`Recovering from ValidationError`)
  *   })
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1819,6 +1879,7 @@ const catchTags = exports.catchTags = effect.catchTags;
  * interruptions, etc.).
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * //      ┌─── Effect<number, string, never>
@@ -1831,6 +1892,7 @@ const catchTags = exports.catchTags = effect.catchTags;
  *   const cause = yield* Effect.cause(program)
  *   yield* Console.log(cause)
  * })
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1852,6 +1914,7 @@ const eventually = exports.eventually = effect.eventually;
  * 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>
@@ -1861,6 +1924,7 @@ const eventually = exports.eventually = effect.eventually;
  * //      ┌─── Effect<void, never, never>
  * //      ▼
  * const program = Effect.ignore(task)
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1886,6 +1950,7 @@ const ignoreLogged = exports.ignoreLogged = effect.ignoreLogged;
  * 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!")
@@ -1904,6 +1969,7 @@ const ignoreLogged = exports.ignoreLogged = effect.ignoreLogged;
  * //   _tag: 'Failure',
  * //   cause: { _id: 'Cause', _tag: 'Fail', failure: [ 'Oh uh!', 'Oh no!' ] }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1925,6 +1991,7 @@ const parallelErrors = exports.parallelErrors = effect.parallelErrors;
  * @see {@link unsandbox} to restore the original error handling.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * //      ┌─── Effect<string, Error, never>
@@ -1959,6 +2026,7 @@ const parallelErrors = exports.parallelErrors = effect.parallelErrors;
  * // Output:
  * // Caught a defect: Oh uh!
  * // fallback result on failure
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1981,6 +2049,7 @@ const sandbox = exports.sandbox = effect.sandbox;
  * @see {@link retryOrElse} for a version that allows you to run a fallback.
  *
  * @example
+ * ```ts
  * import { Effect, Schedule } from "effect"
  *
  * let count = 0
@@ -2009,6 +2078,7 @@ const sandbox = exports.sandbox = effect.sandbox;
  * // failure
  * // success
  * // yay!
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -2026,6 +2096,7 @@ const retry = exports.retry = _schedule.retry_combined;
  * @see {@link retry} for a version that does not run a fallback effect.
  *
  * @example
+ * ```ts
  * import { Effect, Schedule, Console } from "effect"
  *
  * let count = 0
@@ -2057,6 +2128,7 @@ const retry = exports.retry = _schedule.retry_combined;
  * // failure
  * // orElse
  * // default value
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -2113,6 +2185,7 @@ const tryMapPromise = exports.tryMapPromise = effect.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"
  *
@@ -2125,6 +2198,7 @@ const tryMapPromise = exports.tryMapPromise = effect.tryMapPromise;
  * //      ┌─── Effect<Response, UnknownException, never>
  * //      ▼
  * const program = getTodo(1)
+ * ```
  *
  * @example
  * // Title: Custom Error Handling
@@ -2207,6 +2281,7 @@ const checkInterruptible = exports.checkInterruptible = core.checkInterruptible;
  * @see {@link Effect.uninterruptible} for creating an uninterruptible effect.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const longRunningTask = Effect.gen(function* () {
@@ -2236,6 +2311,7 @@ const checkInterruptible = exports.checkInterruptible = core.checkInterruptible;
  * //   }
  * // }
  * // Heavy processing done.
+ * ```
  *
  * @since 2.0.0
  * @category Interruption
@@ -2281,6 +2357,7 @@ const uninterruptibleMask = exports.uninterruptibleMask = core.uninterruptibleMa
  * or failing with specified error if the predicate fails
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const isPositive = (n: number): boolean => n > 0
@@ -2290,6 +2367,7 @@ const uninterruptibleMask = exports.uninterruptibleMask = core.uninterruptibleMa
  *
  * // fails with `"0 is not positive"`
  * Effect.liftPredicate(0, isPositive, n => `${n} is not positive`)
+ * ```
  *
  * @category Condition Checking
  * @since 3.4.0
@@ -2302,6 +2380,7 @@ const liftPredicate = exports.liftPredicate = effect.liftPredicate;
  * replace it with a new constant value.
  *
  * @example
+ * ```ts
  * // Title: Replacing a Value
  * import { pipe, Effect } from "effect"
  *
@@ -2310,6 +2389,7 @@ const liftPredicate = exports.liftPredicate = effect.liftPredicate;
  *
  * Effect.runPromise(program).then(console.log)
  * // Output: "new value"
+ * ```
  *
  * @since 2.0.0
  * @category Mapping
@@ -2353,6 +2433,7 @@ const asVoid = exports.asVoid = core.asVoid;
  * treat an error as a valid result.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * //      ┌─── Effect<number, string, never>
@@ -2362,6 +2443,7 @@ const asVoid = exports.asVoid = core.asVoid;
  * //      ┌─── Effect<string, number, never>
  * //      ▼
  * const flipped = Effect.flip(program)
+ * ```
  *
  * @since 2.0.0
  * @category Mapping
@@ -2402,6 +2484,7 @@ const flipWith = exports.flipWith = effect.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"
  *
@@ -2416,6 +2499,7 @@ const flipWith = exports.flipWith = effect.flipWith;
  *
  * Effect.runPromise(finalAmount).then(console.log)
  * // Output: 101
+ * ```
  * @since 2.0.0
  * @category Mapping
  */
@@ -2440,6 +2524,7 @@ const map = exports.map = core.map;
  * input collection type.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * // Define an initial state and a transformation function
@@ -2458,6 +2543,7 @@ const map = exports.map = core.map;
  * // Output:
  * // 6
  * // [ 'A', 'BB', 'CCC' ]
+ * ```
  *
  * @since 2.0.0
  * @category Mapping
@@ -2476,6 +2562,7 @@ const mapAccum = exports.mapAccum = effect.mapAccum;
  * @see {@link mapError} for a version that operates on the error channel.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * //      ┌─── Effect<number, string, never>
@@ -2488,6 +2575,7 @@ const mapAccum = exports.mapAccum = effect.mapAccum;
  *   onFailure: (message) => new Error(message),
  *   onSuccess: (n) => n > 0
  * })
+ * ```
  *
  * @since 2.0.0
  * @category Mapping
@@ -2507,6 +2595,7 @@ const mapBoth = exports.mapBoth = core.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>
@@ -2519,6 +2608,7 @@ const mapBoth = exports.mapBoth = core.mapBoth;
  *   simulatedTask,
  *   (message) => new Error(message)
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Mapping
@@ -2546,6 +2636,7 @@ const mapErrorCause = exports.mapErrorCause = effect.mapErrorCause;
  * errors as part of the outcome.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * //      ┌─── Effect<number, string, never>
@@ -2555,6 +2646,7 @@ const mapErrorCause = exports.mapErrorCause = effect.mapErrorCause;
  * //      ┌─── Effect<number | string, never, never>
  * //      ▼
  * const recovered = Effect.merge(program)
+ * ```
  *
  * @since 2.0.0
  * @category Mapping
@@ -3026,6 +3118,7 @@ const timedWith = exports.timedWith = effect.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* () {
@@ -3051,6 +3144,7 @@ const timedWith = exports.timedWith = effect.timedWith;
  * //     failure: { _tag: 'TimeoutException' }
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category delays & timeouts
@@ -3076,6 +3170,7 @@ const timeout = exports.timeout = circular.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* () {
@@ -3099,6 +3194,7 @@ const timeout = exports.timeout = circular.timeout;
  * //   { _id: 'Option', _tag: 'Some', value: 'Result' },
  * //   { _id: 'Option', _tag: 'None' }
  * // ]
+ * ```
  *
  * @since 3.1.0
  * @category delays & timeouts
@@ -3123,6 +3219,7 @@ const timeoutOption = exports.timeoutOption = circular.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* () {
@@ -3155,6 +3252,7 @@ const timeoutOption = exports.timeoutOption = circular.timeoutOption;
  * //     failure: MyTimeoutError { _tag: 'MyTimeoutError' }
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category delays & timeouts
@@ -3178,6 +3276,7 @@ const timeoutFail = exports.timeoutFail = circular.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* () {
@@ -3202,6 +3301,7 @@ const timeoutFail = exports.timeoutFail = circular.timeoutFail;
  * //   _tag: 'Failure',
  * //   cause: { _id: 'Cause', _tag: 'Die', defect: 'Timed out!' }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category delays & timeouts
@@ -3229,6 +3329,7 @@ const timeoutFailCause = exports.timeoutFailCause = circular.timeoutFailCause;
  * @see {@link timeoutFailCause} for a version that raises a custom defect.
  *
  * @example
+ * ```ts
  * import { Effect, Either } from "effect"
  *
  * const task = Effect.gen(function* () {
@@ -3256,6 +3357,7 @@ const timeoutFailCause = exports.timeoutFailCause = circular.timeoutFailCause;
  * //   _tag: "Left",
  * //   left: "Timed out!"
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category delays & timeouts
@@ -3322,6 +3424,7 @@ const mapInputContext = exports.mapInputContext = core.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")<
@@ -3353,6 +3456,7 @@ const mapInputContext = exports.mapInputContext = core.mapInputContext;
  * // Output:
  * // timestamp=... level=INFO fiber=#0 message="Executing query: SELECT * FROM users"
  * // []
+ * ```
  *
  * @since 2.0.0
  * @category Context
@@ -3371,6 +3475,7 @@ const provide = exports.provide = layer.effect_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
@@ -3398,6 +3503,7 @@ const provide = exports.provide = layer.effect_provide;
  * Effect.runPromise(runnable)
  * // Example Output:
  * // random number: 0.8241872233134417
+ * ```
  *
  * @since 2.0.0
  * @category Context
@@ -3468,6 +3574,7 @@ const updateService = exports.updateService = effect.updateService;
  * @see {@link let_ let}
  *
  * @example
+ * ```ts
  * import { Effect, pipe } from "effect"
  *
  * const result = pipe(
@@ -3477,6 +3584,7 @@ const updateService = exports.updateService = effect.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
@@ -3497,6 +3605,7 @@ const Do = exports.Do = effect.Do;
  * @see {@link let_ let}
  *
  * @example
+ * ```ts
  * import { Effect, pipe } from "effect"
  *
  * const result = pipe(
@@ -3506,6 +3615,7 @@ const Do = exports.Do = effect.Do;
  *   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
@@ -3517,6 +3627,7 @@ const bind = exports.bind = effect.bind;
  * results in a Do notation pipeline.
  *
  * @example
+ * ```ts
  * import { Effect, Either, pipe } from "effect"
  *
  * const result = pipe(
@@ -3528,6 +3639,7 @@ const bind = exports.bind = effect.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
@@ -3548,6 +3660,7 @@ const bindAll = exports.bindAll = circular.bindAll;
  * @see {@link let_ let}
  *
  * @example
+ * ```ts
  * import { Effect, pipe } from "effect"
  *
  * const result = pipe(
@@ -3557,6 +3670,7 @@ const bindAll = exports.bindAll = circular.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
@@ -3581,6 +3695,7 @@ const let_ = exports.let = effect.let_;
  * @see {@link exit} for a version that uses `Exit` instead.
  *
  * @example
+ * ```ts
  * // Title: Using Effect.option to Handle Errors
  * import { Effect } from "effect"
  *
@@ -3613,6 +3728,7 @@ const let_ = exports.let = effect.let_;
  * //   _tag: 'Failure',
  * //   cause: { _id: 'Cause', _tag: 'Die', defect: 'Boom!' }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Outcome Encapsulation
@@ -3637,6 +3753,7 @@ const option = exports.option = effect.option;
  * @see {@link exit} for a version that uses `Exit` instead.
  *
  * @example
+ * ```ts
  * import { Effect, Either, Random } from "effect"
  *
  * class HttpError {
@@ -3672,6 +3789,7 @@ const option = exports.option = effect.option;
  *     onRight: (value) => value // Do nothing in case of success
  *   })
  * })
+ * ```
  *
  * @since 2.0.0
  * @category Outcome Encapsulation
@@ -3694,6 +3812,7 @@ const either = exports.either = core.either;
  * @see {@link either} for a version that uses `Either` instead.
  *
  * @example
+ * ```ts
  * import { Effect, Cause, Console, Exit } from "effect"
  *
  * // Simulating a runtime error
@@ -3725,6 +3844,7 @@ const either = exports.either = core.either;
  * //   _tag: "Success",
  * //   value: undefined
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Outcome Encapsulation
@@ -3741,6 +3861,7 @@ const exit = exports.exit = core.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
@@ -3764,6 +3885,7 @@ const exit = exports.exit = core.exit;
  * // Output:
  * // 42
  * // true
+ * ```
  *
  * @since 2.0.0
  * @category Synchronization Utilities
@@ -3805,6 +3927,7 @@ const filterOrElse = exports.filterOrElse = effect.filterOrElse;
  * Let's explore this concept through an example:
  *
  * @example
+ * ```ts
  * import { Effect, pipe } from "effect"
  *
  * // Define a user interface
@@ -3825,6 +3948,7 @@ const filterOrElse = exports.filterOrElse = effect.filterOrElse;
  *   // 'user' now has the type `User` (not `User | null`)
  *   Effect.andThen((user) => user.name)
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Filtering
@@ -3868,6 +3992,7 @@ const unlessEffect = exports.unlessEffect = effect.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"
  *
@@ -3893,6 +4018,7 @@ const unlessEffect = exports.unlessEffect = effect.unlessEffect;
  * //   _id: "Option",
  * //   _tag: "None"
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Conditional Operators
@@ -3916,6 +4042,7 @@ const when = exports.when = effect.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"
  *
@@ -3926,6 +4053,7 @@ const when = exports.when = effect.when;
  * console.log(Effect.runSync(randomIntOption))
  * // Example Output:
  * // { _id: 'Option', _tag: 'Some', value: 8609104974198840 }
+ * ```
  *
  * @since 2.0.0
  * @category Conditional Operators
@@ -3976,6 +4104,7 @@ const whenRef = exports.whenRef = effect.whenRef;
  * changing the original one.
  *
  * @example
+ * ```ts
  * import { pipe, Effect } from "effect"
  *
  * // Function to apply a discount safely to a transaction amount
@@ -3998,6 +4127,7 @@ const whenRef = exports.whenRef = effect.whenRef;
  *
  * Effect.runPromise(finalAmount).then(console.log)
  * // Output: 95
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -4037,6 +4167,7 @@ const flatMap = exports.flatMap = core.flatMap;
  * treating them as effects.
  *
  * @example
+ * ```ts
  * // Title: Applying a Discount Based on Fetched Amount
  * import { pipe, Effect } from "effect"
  *
@@ -4071,6 +4202,7 @@ const flatMap = exports.flatMap = core.flatMap;
  *
  * Effect.runPromise(result2).then(console.log)
  * // Output: 190
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -4151,6 +4283,7 @@ const summarized = exports.summarized = effect.summarized;
  * will fail too.
  *
  * @example
+ * ```ts
  * // Title: Logging a step in a pipeline
  * import { Console, Effect, pipe } from "effect"
  *
@@ -4178,6 +4311,7 @@ const summarized = exports.summarized = effect.summarized;
  * // Output:
  * // Apply a discount to: 100
  * // 95
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -4195,6 +4329,7 @@ const tap = exports.tap = core.tap;
  * altering the result.
  *
  * @example
+ * ```ts
  * import { Effect, Random, Console } from "effect"
  *
  * // Simulate a task that might fail
@@ -4214,6 +4349,7 @@ const tap = exports.tap = core.tap;
  * Effect.runFork(tapping)
  * // Example Output:
  * // failure: random number is negative
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -4230,6 +4366,7 @@ const tapBoth = exports.tapBoth = effect.tapBoth;
  * severe errors.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * // Simulate a task that fails with a recoverable error
@@ -4257,6 +4394,7 @@ const tapBoth = exports.tapBoth = effect.tapBoth;
  * // Output:
  * // defect: RuntimeException: Something went wrong
  * //   ... stack trace ...
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -4272,6 +4410,7 @@ const tapDefect = exports.tapDefect = effect.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
@@ -4285,6 +4424,7 @@ const tapDefect = exports.tapDefect = effect.tapDefect;
  * Effect.runFork(tapping)
  * // Output:
  * // expected error: NetworkError
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -4300,6 +4440,7 @@ const tapError = exports.tapError = effect.tapError;
  * without modifying the error or the overall result of the effect.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * class NetworkError {
@@ -4324,6 +4465,7 @@ const tapError = exports.tapError = effect.tapError;
  * Effect.runFork(tapping)
  * // Output:
  * // expected error: 504
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -4339,6 +4481,7 @@ const tapErrorTag = exports.tapErrorTag = effect.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
@@ -4365,6 +4508,7 @@ const tapErrorTag = exports.tapErrorTag = effect.tapErrorTag;
  * // Output:
  * // error cause: RuntimeException: Something went wrong
  * //   ... stack trace ...
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -4396,6 +4540,7 @@ const forever = exports.forever = effect.forever;
  * ```
  *
  * @example
+ * ```ts
  * // Title: Effectful Iteration
  * import { Effect } from "effect"
  *
@@ -4412,6 +4557,7 @@ const forever = exports.forever = effect.forever;
  *
  * Effect.runPromise(result).then(console.log)
  * // Output: 6
+ * ```
  *
  * @since 2.0.0
  * @category Looping
@@ -4444,6 +4590,7 @@ const iterate = exports.iterate = effect.iterate;
  * discarded, and the final result will be `void`.
  *
  * @example
+ * ```ts
  * // Title: Looping with Collected Results
  * import { Effect } from "effect"
  *
@@ -4463,6 +4610,7 @@ const iterate = exports.iterate = effect.iterate;
  *
  * Effect.runPromise(result).then(console.log)
  * // Output: [1, 2, 3, 4, 5]
+ * ```
  *
  * @example
  * // Title: Loop with Discarded Results
@@ -4504,6 +4652,7 @@ const loop = exports.loop = effect.loop;
  * an additional time.
  *
  * @example
+ * ```ts
  * // Success Example
  * import { Effect, Schedule, Console } from "effect"
  *
@@ -4512,6 +4661,7 @@ const loop = exports.loop = effect.loop;
  * const program = Effect.repeat(action, policy)
  *
  * Effect.runPromise(program).then((n) => console.log(`repetitions: ${n}`))
+ * ```
  *
  * @example
  * // Failure Example
@@ -4547,12 +4697,14 @@ const repeat = exports.repeat = _schedule.repeat_combined;
  * 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
@@ -4567,6 +4719,7 @@ const repeatN = exports.repeatN = effect.repeatN;
  * initially and then repeats it an additional time if it succeeds.
  *
  * @example
+ * ```ts
  * import { Effect, Schedule } from "effect"
  *
  * let count = 0
@@ -4596,6 +4749,7 @@ const repeatN = exports.repeatN = effect.repeatN;
  * )
  *
  * Effect.runPromise(program).then((n) => console.log(`repetitions: ${n}`))
+ * ```
  *
  * @since 2.0.0
  * @category repetition / recursion
@@ -4718,6 +4872,7 @@ const isSuccess = exports.isSuccess = effect.isSuccess;
  * @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)
@@ -4743,6 +4898,7 @@ const isSuccess = exports.isSuccess = effect.isSuccess;
  * // 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
@@ -4778,6 +4934,7 @@ const matchCause = exports.matchCause = core.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!")
@@ -4805,6 +4962,7 @@ const matchCause = exports.matchCause = core.matchCause;
  *
  * Effect.runSync(program)
  * // Output: "Die: Uh oh!"
+ * ```
  *
  * @since 2.0.0
  * @category getters & folding
@@ -4833,6 +4991,7 @@ const matchEffect = exports.matchEffect = core.matchEffect;
  * To adjust the log level, use the `Logger.withMinimumLogLevel` function.
  *
  * @example
+ * ```ts
  * import { Cause, Effect } from "effect"
  *
  * const program = Effect.log(
@@ -4846,6 +5005,7 @@ const matchEffect = exports.matchEffect = core.matchEffect;
  * // Output:
  * // timestamp=... level=INFO fiber=#0 message=message1 message=message2 cause="Error: Oh no!
  * // Error: Oh uh!"
+ * ```
  *
  * @since 2.0.0
  * @category Logging
@@ -4874,12 +5034,14 @@ const logTrace = exports.logTrace = effect.logTrace;
  * `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
@@ -4919,6 +5081,7 @@ const logFatal = exports.logFatal = effect.logFatal;
  * time-sensitive processes.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -4928,6 +5091,7 @@ const logFatal = exports.logFatal = effect.logFatal;
  *
  * // Effect.runFork(program)
  * // timestamp=... level=INFO fiber=#0 message="The job is finished!" myspan=1011ms
+ * ```
  *
  * @since 2.0.0
  * @category Logging
@@ -4939,6 +5103,7 @@ const withLogSpan = exports.withLogSpan = effect.withLogSpan;
  * to log messages, making them more informative and easier to trace.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -4949,6 +5114,7 @@ const withLogSpan = exports.withLogSpan = effect.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
@@ -4961,6 +5127,7 @@ const annotateLogs = exports.annotateLogs = effect.annotateLogs;
  * defined `Scope`, making it easier to manage context-specific logging.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -4975,6 +5142,7 @@ const annotateLogs = exports.annotateLogs = effect.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
@@ -5010,6 +5178,7 @@ const withUnhandledErrorLogLevel = exports.withUnhandledErrorLogLevel = core.wit
  * @see {@link orDieWith} if you need to customize the error.
  *
  * @example
+ * ```ts
  * // Title: Propagating an Error as a Defect
  * import { Effect } from "effect"
  *
@@ -5026,6 +5195,7 @@ const withUnhandledErrorLogLevel = exports.withUnhandledErrorLogLevel = core.wit
  * // Output:
  * // (FiberFailure) Error: Cannot divide by zero
  * //   ...stack trace...
+ * ```
  *
  * @since 2.0.0
  * @category Converting Failures to Defects
@@ -5049,6 +5219,7 @@ const orDie = exports.orDie = core.orDie;
  * @see {@link orDie} if you don't need to customize the error.
  *
  * @example
+ * ```ts
  * // Title: Customizing Defect
  * import { Effect } from "effect"
  *
@@ -5068,6 +5239,7 @@ const orDie = exports.orDie = core.orDie;
  * // Output:
  * // (FiberFailure) Error: defect: Cannot divide by zero
  * //   ...stack trace...
+ * ```
  *
  * @since 2.0.0
  * @category Converting Failures to Defects
@@ -5084,6 +5256,7 @@ const orDieWith = exports.orDieWith = core.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")
@@ -5099,6 +5272,7 @@ const orDieWith = exports.orDieWith = core.orDieWith;
  * const program2 = Effect.orElse(failure, () => fallback)
  * console.log(Effect.runSync(program2))
  * // Output: "fallback"
+ * ```
  *
  * @since 2.0.0
  * @category Fallback
@@ -5117,6 +5291,7 @@ const orElse = exports.orElse = core.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> => {
@@ -5138,6 +5313,7 @@ const orElse = exports.orElse = core.orElse;
  * //   _tag: 'Failure',
  * //   cause: { _id: 'Cause', _tag: 'Fail', failure: 'invalid age' }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Fallback
@@ -5161,6 +5337,7 @@ const orElseFail = exports.orElseFail = effect.orElseFail;
  * already succeeds, it will remain unchanged.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const validate = (age: number): Effect.Effect<number, string> => {
@@ -5178,6 +5355,7 @@ const orElseFail = exports.orElseFail = effect.orElseFail;
  * console.log(Effect.runSyncExit(program))
  * // Output:
  * // { _id: 'Exit', _tag: 'Success', value: 18 }
+ * ```
  *
  * @since 2.0.0
  * @category Fallback
@@ -5201,6 +5379,7 @@ const orElseSucceed = exports.orElseSucceed = effect.orElseSucceed;
  * error.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * interface Config {
@@ -5247,6 +5426,7 @@ const orElseSucceed = exports.orElseSucceed = effect.orElseSucceed;
  * // Unavailable config for node2
  * // Config for node3 found
  * // { host: 'node3.example.com', port: 8080, apiKey: '12345-abcde' }
+ * ```
  *
  * @since 2.0.0
  * @category Fallback
@@ -5378,6 +5558,7 @@ const unsafeMakeLatch = exports.unsafeMakeLatch = circular.unsafeMakeLatch;
  * @category latch
  * @since 3.8.0
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * Effect.gen(function*() {
@@ -5394,6 +5575,7 @@ const unsafeMakeLatch = exports.unsafeMakeLatch = circular.unsafeMakeLatch;
  *   yield* latch.open
  *   yield* fiber.await
  * })
+ * ```
  */
 const makeLatch = exports.makeLatch = circular.makeLatch;
 /**
@@ -5410,6 +5592,7 @@ const makeLatch = exports.makeLatch = circular.makeLatch;
  * `runFork` is a good default choice.
  *
  * @example
+ * ```ts
  * // Title: Running an Effect in the Background
  * import { Effect, Console, Schedule, Fiber } from "effect"
  *
@@ -5427,6 +5610,7 @@ const makeLatch = exports.makeLatch = circular.makeLatch;
  * setTimeout(() => {
  *   Effect.runFork(Fiber.interrupt(fiber))
  * }, 500)
+ * ```
  *
  * @since 2.0.0
  * @category Running Effects
@@ -5452,11 +5636,13 @@ const runCallback = exports.runCallback = _runtime.unsafeRunEffect;
  * @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
@@ -5487,6 +5673,7 @@ const runPromise = exports.runPromise = _runtime.unsafeRunPromiseEffect;
  *   a `Cause` type.
  *
  * @example
+ * ```ts
  * // Title: Handling Results as Exit
  * import { Effect } from "effect"
  *
@@ -5511,6 +5698,7 @@ const runPromise = exports.runPromise = _runtime.unsafeRunPromiseEffect;
  * //     failure: "my error"
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Running Effects
@@ -5532,6 +5720,7 @@ const runPromiseExit = exports.runPromiseExit = _runtime.unsafeRunPromiseExitEff
  * throwing an error.
  *
  * @example
+ * ```ts
  * // Title: Synchronous Logging
  * import { Effect } from "effect"
  *
@@ -5545,6 +5734,7 @@ const runPromiseExit = exports.runPromiseExit = _runtime.unsafeRunPromiseExitEff
  *
  * console.log(result)
  * // Output: 1
+ * ```
  *
  * @example
  * // Title: Incorrect Usage with Failing or Async Effects
@@ -5593,6 +5783,7 @@ const runSync = exports.runSync = _runtime.unsafeRunSyncEffect;
  * resolved synchronously.
  *
  * @example
+ * ```ts
  * // Title: Handling Results as Exit
  * import { Effect } from "effect"
  *
@@ -5615,6 +5806,7 @@ const runSync = exports.runSync = _runtime.unsafeRunSyncEffect;
  * //     failure: "my error"
  * //   }
  * // }
+ * ```
  *
  * @example
  * // Title: Asynchronous Operation Resulting in Die
@@ -5655,6 +5847,7 @@ const runSyncExit = exports.runSyncExit = _runtime.unsafeRunSyncExitEffect;
  * @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))
@@ -5682,6 +5875,7 @@ const runSyncExit = exports.runSyncExit = _runtime.unsafeRunSyncExitEffect;
  * //     right: { _id: 'Cause', _tag: 'Fail', failure: 'Oh no!' }
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Error Accumulation
@@ -5710,6 +5904,7 @@ const validateWith = exports.validateWith = fiberRuntime.validateWith;
  * @see {@link validate} for a version that accumulates errors.
  *
  * @example
+ * ```ts
  * // Title: Combining Two Effects Sequentially
  * import { Effect } from "effect"
  *
@@ -5733,6 +5928,7 @@ const validateWith = exports.validateWith = fiberRuntime.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
@@ -5778,6 +5974,7 @@ const zip = exports.zip = fiberRuntime.zipOptions;
  * @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(
@@ -5796,6 +5993,7 @@ const zip = exports.zip = fiberRuntime.zipOptions;
  * // timestamp=... level=INFO fiber=#0 message="task1 done"
  * // timestamp=... level=INFO fiber=#0 message="task2 done"
  * // 1
+ * ```
  *
  * @since 2.0.0
  * @category Zipping
@@ -5819,6 +6017,7 @@ const zipLeft = exports.zipLeft = fiberRuntime.zipLeftOptions;
  * @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(
@@ -5837,6 +6036,7 @@ const zipLeft = exports.zipLeft = fiberRuntime.zipLeftOptions;
  * // timestamp=... level=INFO fiber=#0 message="task1 done"
  * // timestamp=... level=INFO fiber=#0 message="task2 done"
  * // hello
+ * ```
  *
  * @since 2.0.0
  * @category Zipping
@@ -5858,6 +6058,7 @@ const zipRight = exports.zipRight = fiberRuntime.zipRightOptions;
  * use the `{ concurrent: true }` option.
  *
  * @example
+ * ```ts
  * // Title: Combining Effects with a Custom Function
  * import { Effect } from "effect"
  *
@@ -5882,6 +6083,7 @@ const zipRight = exports.zipRight = fiberRuntime.zipRightOptions;
  * // timestamp=... level=INFO fiber=#3 message="task1 done"
  * // timestamp=... level=INFO fiber=#2 message="task2 done"
  * // 6
+ * ```
  *
  * @since 2.0.0
  * @category Zipping
@@ -5958,6 +6160,7 @@ const withTracerScoped = exports.withTracerScoped = fiberRuntime.withTracerScope
  * @since 2.0.0
  * @category Tracing
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * Effect.succeed(42).pipe(
@@ -5965,6 +6168,7 @@ const withTracerScoped = exports.withTracerScoped = fiberRuntime.withTracerScope
  *   // the span will not be registered with the tracer
  *   Effect.withTracerEnabled(false)
  * )
+ * ```
  */
 const withTracerEnabled = exports.withTracerEnabled = core.withTracerEnabled;
 /**
@@ -6055,6 +6259,7 @@ const withSpan = exports.withSpan = effect.withSpan;
  * @since 3.2.0
  * @category Tracing
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const getTodo = Effect.functionWithSpan({
@@ -6064,6 +6269,7 @@ const withSpan = exports.withSpan = effect.withSpan;
  *     attributes: { id }
  *   })
  * })
+ * ```
  */
 const functionWithSpan = exports.functionWithSpan = effect.functionWithSpan;
 /**
@@ -6094,6 +6300,7 @@ const withParentSpan = exports.withParentSpan = effect.withParentSpan;
  * value.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * //      ┌─── Effect<number, NoSuchElementException, never>
@@ -6119,6 +6326,7 @@ const withParentSpan = exports.withParentSpan = effect.withParentSpan;
  * //     failure: { _tag: 'NoSuchElementException' }
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Optional Wrapping
@@ -6136,6 +6344,7 @@ const fromNullable = exports.fromNullable = effect.fromNullable;
  * unchanged.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * //      ┌─── Effect<number, NoSuchElementException, never>
@@ -6159,6 +6368,7 @@ const fromNullable = exports.fromNullable = effect.fromNullable;
  *
  * Effect.runPromise(option2).then(console.log)
  * // Output: { _tag: 'None' }
+ * ```
  *
  * @since 2.0.0
  * @category Optional Wrapping
@@ -6192,6 +6402,7 @@ const makeTagProxy = TagClass => {
 };
 /**
  * @example
+ * ```ts
  * import { Effect, Layer } from "effect"
  *
  * class MapTag extends Effect.Tag("MapTag")<MapTag, Map<string, string>>() {
@@ -6200,6 +6411,7 @@ const makeTagProxy = TagClass => {
  *    Effect.sync(() => new Map())
  *  )
  * }
+ * ```
  *
  * @since 2.0.0
  * @category Context
@@ -6226,6 +6438,7 @@ const Tag = id => () => {
 };
 /**
  * @example
+ * ```ts
  * import { Effect } from 'effect';
  *
  * class Prefix extends Effect.Service<Prefix>()("Prefix", {
@@ -6245,6 +6458,7 @@ const Tag = id => () => {
  *  }),
  *  dependencies: [Prefix.Default]
  * }) {}
+ * ```
  *
  * @since 3.9.0
  * @category Context