effect 3.10.18 → 3.11.0

package/dist/cjs/Effect.js

@@ -3,11 +3,12 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.forkDaemon = exports.forkAll = exports.fork = exports.forever = exports.forEach = exports.flipWith = exports.flip = exports.flatten = exports.flatMap = exports.firstSuccessOf = exports.findFirst = exports.finalizersMask = exports.filterOrFail = exports.filterOrElse = exports.filterOrDieMessage = exports.filterOrDie = exports.filterMap = exports.filter = exports.fiberIdWith = exports.fiberId = exports.failSync = exports.failCauseSync = exports.failCause = exports.fail = exports.exit = exports.exists = exports.every = exports.eventually = exports.ensuringChildren = exports.ensuringChild = exports.ensuring = exports.either = exports.dropWhile = exports.dropUntil = exports.disconnect = exports.diffFiberRefs = exports.dieSync = exports.dieMessage = exports.die = exports.descriptorWith = exports.descriptor = exports.delay = exports.daemonChildren = exports.custom = exports.currentSpan = exports.currentParentSpan = exports.contextWithEffect = exports.contextWith = exports.context = exports.consoleWith = exports.console = exports.configProviderWith = exports.clockWith = exports.clock = exports.checkInterruptible = exports.cause = exports.catchTags = exports.catchTag = exports.catchSomeDefect = exports.catchSomeCause = exports.catchSome = exports.catchIf = exports.catchAllDefect = exports.catchAllCause = exports.catchAll = exports.catch = exports.cachedWithTTL = exports.cachedInvalidateWithTTL = exports.cachedFunction = exports.cached = exports.cacheRequestResult = exports.blocked = exports.bindTo = exports.bindAll = exports.bind = exports.awaitAllChildren = exports.asyncEffect = exports.async = exports.asVoid = exports.asSomeError = exports.asSome = exports.as = exports.ap = exports.annotateSpans = exports.annotateLogsScoped = exports.annotateLogs = exports.annotateCurrentSpan = exports.andThen = exports.allowInterrupt = exports.allWith = exports.allSuccesses = exports.all = exports.addFinalizer = exports.acquireUseRelease = exports.acquireReleaseInterruptible = exports.acquireRelease = exports.Tag = exports.Service = exports.EffectTypeId = exports.Do = void 0;
-exports.retry = exports.request = exports.replicateEffect = exports.replicate = exports.repeatOrElse = exports.repeatN = exports.repeat = exports.reduceWhile = exports.reduceRight = exports.reduceEffect = exports.reduce = exports.randomWith = exports.random = exports.raceWith = exports.raceFirst = exports.raceAll = exports.race = exports.provideServiceEffect = exports.provideService = exports.provide = exports.promise = exports.patchRuntimeFlags = exports.patchFiberRefs = exports.partition = exports.parallelFinalizers = exports.parallelErrors = exports.orElseSucceed = exports.orElseFail = exports.orElse = exports.orDieWith = exports.orDie = exports.optionFromOptional = exports.option = exports.once = exports.onInterrupt = exports.onExit = exports.onError = exports.none = exports.never = exports.negate = exports.metricLabels = exports.mergeAll = exports.merge = exports.matchEffect = exports.matchCauseEffect = exports.matchCause = exports.match = exports.mapInputContext = exports.mapErrorCause = exports.mapError = exports.mapBoth = exports.mapAccum = exports.map = exports.makeSpanScoped = exports.makeSpan = exports.makeSemaphore = exports.makeLatch = exports.loop = exports.logWithLevel = exports.logWarning = exports.logTrace = exports.logInfo = exports.logFatal = exports.logError = exports.logDebug = exports.logAnnotations = exports.log = exports.locallyWith = exports.locallyScopedWith = exports.locallyScoped = exports.locally = exports.linkSpans = exports.liftPredicate = exports.let = exports.labelMetricsScoped = exports.labelMetrics = exports.iterate = exports.isSuccess = exports.isFailure = exports.isEffect = exports.intoDeferred = exports.interruptibleMask = exports.interruptible = exports.interruptWith = exports.interrupt = exports.inheritFiberRefs = exports.ignoreLogged = exports.ignore = exports.if = exports.head = exports.getRuntimeFlags = exports.getFiberRefs = exports.gen = exports.functionWithSpan = exports.fromNullable = exports.fromFiberEffect = exports.fromFiber = exports.forkWithErrorHandler = exports.forkScoped = exports.forkIn = void 0;
-exports.withRuntimeFlagsPatch = exports.withRequestCaching = exports.withRequestCache = exports.withRequestBatching = exports.withRandomScoped = exports.withRandom = exports.withParentSpan = exports.withMetric = exports.withMaxOpsBeforeYield = exports.withLogSpan = exports.withFiberRuntime = exports.withEarlyRelease = exports.withConsoleScoped = exports.withConsole = exports.withConfigProviderScoped = exports.withConfigProvider = exports.withConcurrency = exports.withClockScoped = exports.withClock = exports.whileLoop = exports.whenRef = exports.whenFiberRef = exports.whenEffect = exports.when = exports.void = exports.validateWith = exports.validateFirst = exports.validateAll = exports.validate = exports.using = exports.useSpan = exports.updateService = exports.updateFiberRefs = exports.unsandbox = exports.unsafeMakeSemaphore = exports.unsafeMakeLatch = exports.unlessEffect = exports.unless = exports.uninterruptibleMask = exports.uninterruptible = exports.tryPromise = exports.tryMapPromise = exports.tryMap = exports.try = exports.transplant = exports.tracerWith = exports.tracer = exports.timeoutTo = exports.timeoutOption = exports.timeoutFailCause = exports.timeoutFail = exports.timeout = exports.timedWith = exports.timed = exports.tapErrorTag = exports.tapErrorCause = exports.tapError = exports.tapDefect = exports.tapBoth = exports.tap = exports.takeWhile = exports.takeUntil = exports.tagMetricsScoped = exports.tagMetrics = exports.sync = exports.suspend = exports.supervised = exports.summarized = exports.succeedSome = exports.succeedNone = exports.succeed = exports.step = exports.spanLinks = exports.spanAnnotations = exports.sleep = exports.setFiberRefs = exports.serviceOptional = exports.serviceOption = exports.serviceMembers = exports.serviceFunctions = exports.serviceFunctionEffect = exports.serviceFunction = exports.serviceConstants = exports.sequentialFinalizers = exports.scoped = exports.scopeWith = exports.scope = exports.scheduleFrom = exports.scheduleForked = exports.schedule = exports.sandbox = exports.runtime = exports.runSyncExit = exports.runSync = exports.runRequestBlock = exports.runPromiseExit = exports.runPromise = exports.runFork = exports.runCallback = exports.retryOrElse = void 0;
-exports.zipWith = exports.zipRight = exports.zipLeft = exports.zip = exports.yieldNow = exports.withUnhandledErrorLogLevel = exports.withTracerTiming = exports.withTracerScoped = exports.withTracerEnabled = exports.withTracer = exports.withSpanScoped = exports.withSpan = exports.withSchedulingPriority = exports.withScheduler = exports.withRuntimeFlagsPatchScoped = void 0;
+exports.forkAll = exports.fork = exports.forever = exports.forEach = exports.fn = exports.flipWith = exports.flip = exports.flatten = exports.flatMap = exports.firstSuccessOf = exports.findFirst = exports.finalizersMask = exports.filterOrFail = exports.filterOrElse = exports.filterOrDieMessage = exports.filterOrDie = exports.filterMap = exports.filter = exports.fiberIdWith = exports.fiberId = exports.failSync = exports.failCauseSync = exports.failCause = exports.fail = exports.exit = exports.exists = exports.every = exports.eventually = exports.ensuringChildren = exports.ensuringChild = exports.ensuring = exports.either = exports.dropWhile = exports.dropUntil = exports.disconnect = exports.diffFiberRefs = exports.dieSync = exports.dieMessage = exports.die = exports.descriptorWith = exports.descriptor = exports.delay = exports.daemonChildren = exports.custom = exports.currentSpan = exports.currentParentSpan = exports.contextWithEffect = exports.contextWith = exports.context = exports.consoleWith = exports.console = exports.configProviderWith = exports.clockWith = exports.clock = exports.checkInterruptible = exports.cause = exports.catchTags = exports.catchTag = exports.catchSomeDefect = exports.catchSomeCause = exports.catchSome = exports.catchIf = exports.catchAllDefect = exports.catchAllCause = exports.catchAll = exports.catch = exports.cachedWithTTL = exports.cachedInvalidateWithTTL = exports.cachedFunction = exports.cached = exports.cacheRequestResult = exports.blocked = exports.bindTo = exports.bindAll = exports.bind = exports.awaitAllChildren = exports.asyncEffect = exports.async = exports.asVoid = exports.asSomeError = exports.asSome = exports.as = exports.ap = exports.annotateSpans = exports.annotateLogsScoped = exports.annotateLogs = exports.annotateCurrentSpan = exports.andThen = exports.allowInterrupt = exports.allWith = exports.allSuccesses = exports.all = exports.addFinalizer = exports.acquireUseRelease = exports.acquireReleaseInterruptible = exports.acquireRelease = exports.Tag = exports.Service = exports.EffectTypeId = exports.Do = void 0;
+exports.request = exports.replicateEffect = exports.replicate = exports.repeatOrElse = exports.repeatN = exports.repeat = exports.reduceWhile = exports.reduceRight = exports.reduceEffect = exports.reduce = exports.randomWith = exports.random = exports.raceWith = exports.raceFirst = exports.raceAll = exports.race = exports.provideServiceEffect = exports.provideService = exports.provide = exports.promise = exports.patchRuntimeFlags = exports.patchFiberRefs = exports.partition = exports.parallelFinalizers = exports.parallelErrors = exports.orElseSucceed = exports.orElseFail = exports.orElse = exports.orDieWith = exports.orDie = exports.optionFromOptional = exports.option = exports.once = exports.onInterrupt = exports.onExit = exports.onError = exports.none = exports.never = exports.negate = exports.metricLabels = exports.mergeAll = exports.merge = exports.matchEffect = exports.matchCauseEffect = exports.matchCause = exports.match = exports.mapInputContext = exports.mapErrorCause = exports.mapError = exports.mapBoth = exports.mapAccum = exports.map = exports.makeSpanScoped = exports.makeSpan = exports.makeSemaphore = exports.makeLatch = exports.loop = exports.logWithLevel = exports.logWarning = exports.logTrace = exports.logInfo = exports.logFatal = exports.logError = exports.logDebug = exports.logAnnotations = exports.log = exports.locallyWith = exports.locallyScopedWith = exports.locallyScoped = exports.locally = exports.linkSpans = exports.liftPredicate = exports.let = exports.labelMetricsScoped = exports.labelMetrics = exports.iterate = exports.isSuccess = exports.isFailure = exports.isEffect = exports.intoDeferred = exports.interruptibleMask = exports.interruptible = exports.interruptWith = exports.interrupt = exports.inheritFiberRefs = exports.ignoreLogged = exports.ignore = exports.if = exports.head = exports.getRuntimeFlags = exports.getFiberRefs = exports.gen = exports.functionWithSpan = exports.fromNullable = exports.fromFiberEffect = exports.fromFiber = exports.forkWithErrorHandler = exports.forkScoped = exports.forkIn = exports.forkDaemon = void 0;
+exports.withRequestCache = exports.withRequestBatching = exports.withRandomScoped = exports.withRandom = exports.withParentSpan = exports.withMetric = exports.withMaxOpsBeforeYield = exports.withLogSpan = exports.withFiberRuntime = exports.withEarlyRelease = exports.withConsoleScoped = exports.withConsole = exports.withConfigProviderScoped = exports.withConfigProvider = exports.withConcurrency = exports.withClockScoped = exports.withClock = exports.whileLoop = exports.whenRef = exports.whenFiberRef = exports.whenEffect = exports.when = exports.void = exports.validateWith = exports.validateFirst = exports.validateAll = exports.validate = exports.using = exports.useSpan = exports.updateService = exports.updateFiberRefs = exports.unsandbox = exports.unsafeMakeSemaphore = exports.unsafeMakeLatch = exports.unlessEffect = exports.unless = exports.uninterruptibleMask = exports.uninterruptible = exports.tryPromise = exports.tryMapPromise = exports.tryMap = exports.try = exports.transplant = exports.tracerWith = exports.tracer = exports.timeoutTo = exports.timeoutOption = exports.timeoutFailCause = exports.timeoutFail = exports.timeout = exports.timedWith = exports.timed = exports.tapErrorTag = exports.tapErrorCause = exports.tapError = exports.tapDefect = exports.tapBoth = exports.tap = exports.takeWhile = exports.takeUntil = exports.tagMetricsScoped = exports.tagMetrics = exports.sync = exports.suspend = exports.supervised = exports.summarized = exports.succeedSome = exports.succeedNone = exports.succeed = exports.step = exports.spanLinks = exports.spanAnnotations = exports.sleep = exports.setFiberRefs = exports.serviceOptional = exports.serviceOption = exports.serviceMembers = exports.serviceFunctions = exports.serviceFunctionEffect = exports.serviceFunction = exports.serviceConstants = exports.sequentialFinalizers = exports.scopedWith = exports.scoped = exports.scopeWith = exports.scope = exports.scheduleFrom = exports.scheduleForked = exports.schedule = exports.sandbox = exports.runtime = exports.runSyncExit = exports.runSync = exports.runRequestBlock = exports.runPromiseExit = exports.runPromise = exports.runFork = exports.runCallback = exports.retryOrElse = exports.retry = void 0;
+exports.zipWith = exports.zipRight = exports.zipLeft = exports.zip = exports.yieldNow = exports.withUnhandledErrorLogLevel = exports.withTracerTiming = exports.withTracerScoped = exports.withTracerEnabled = exports.withTracer = exports.withSpanScoped = exports.withSpan = exports.withSchedulingPriority = exports.withScheduler = exports.withRuntimeFlagsPatchScoped = exports.withRuntimeFlagsPatch = exports.withRequestCaching = void 0;
 var _Function = require("./Function.js");
+var internalCause = _interopRequireWildcard(require("./internal/cause.js"));
 var _console = _interopRequireWildcard(require("./internal/console.js"));
 var _context = require("./internal/context.js");
 var effect = _interopRequireWildcard(require("./internal/core-effect.js"));
@@ -21,6 +22,7 @@ var _runtime = _interopRequireWildcard(require("./internal/runtime.js"));
 var _schedule = _interopRequireWildcard(require("./internal/schedule.js"));
 var Request = _interopRequireWildcard(require("./Request.js"));
 var Scheduler = _interopRequireWildcard(require("./Scheduler.js"));
+var _Utils = require("./Utils.js");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 /**
@@ -47,6 +49,7 @@ const isEffect = exports.isEffect = core.isEffect;
  * be recomputed upon next evaluation.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * let i = 1
@@ -74,6 +77,7 @@ const isEffect = exports.isEffect = core.isEffect;
  * // result 1
  * // expensive task...
  * // result 2
+ * ```
  *
  * @since 2.0.0
  * @category Caching
@@ -85,6 +89,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 +120,7 @@ const cachedWithTTL = exports.cachedWithTTL = circular.cached;
  * // result 1
  * // expensive task...
  * // result 2
+ * ```
  *
  * @since 2.0.0
  * @category Caching
@@ -126,6 +132,7 @@ const cachedInvalidateWithTTL = exports.cachedInvalidateWithTTL = circular.cache
  * the logic.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * let i = 1
@@ -159,6 +166,7 @@ const cachedInvalidateWithTTL = exports.cachedInvalidateWithTTL = circular.cache
  * // expensive task...
  * // result 3
  * // result 3
+ * ```
  *
  * @since 2.0.0
  * @category Caching
@@ -170,6 +178,7 @@ const cached = exports.cached = effect.memoize;
  * recompute them.
  *
  * @example
+ * ```ts
  * import { Effect, Random } from "effect"
  *
  * const program = Effect.gen(function* () {
@@ -192,6 +201,7 @@ const cached = exports.cached = effect.memoize;
  * // memoized version:
  * // 5
  * // 5
+ * ```
  *
  * @since 2.0.0
  * @category Caching
@@ -202,6 +212,7 @@ const cachedFunction = exports.cachedFunction = circular.cachedFunction;
  * called.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * const program = Effect.gen(function* () {
@@ -217,6 +228,7 @@ const cachedFunction = exports.cachedFunction = circular.cachedFunction;
  * // task1
  * // task1
  * // task2
+ * ```
  *
  * @since 2.0.0
  * @category Caching
@@ -272,6 +284,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 +302,7 @@ const once = exports.once = effect.once;
  * // 42
  * // Hello
  * // [ 42, 'Hello' ]
+ * ```
  *
  * @example
  * // Title: Combining Effects in Iterables
@@ -437,6 +451,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 +475,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 +537,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 +558,7 @@ const filter = exports.filter = fiberRuntime.filter;
  * // task3 done
  * // task4 done
  * // [ 2, 4 ]
+ * ```
  *
  * @since 2.0.0
  * @category Filtering
@@ -577,6 +595,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 +611,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 +670,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 +686,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 +767,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 +794,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 +816,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 +833,7 @@ const validateAll = exports.validateAll = fiberRuntime.validateAll;
  * // Output:
  * // item 4
  * // 4
+ * ```
  *
  * @since 2.0.0
  * @category Error Accumulation
@@ -838,6 +864,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 +885,7 @@ const validateFirst = exports.validateFirst = fiberRuntime.validateFirst;
  * //      ┌─── Effect<Buffer, Error, never>
  * //      ▼
  * const program = readFile("example.txt")
+ * ```
  *
  * @example
  * // Title: Handling Interruption with Cleanup
@@ -948,12 +976,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 +1006,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 +1015,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 +1057,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 +1074,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 +1103,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 +1120,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 +1154,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 +1181,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 +1228,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 +1245,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 +1262,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 +1271,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 +1306,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 +1321,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 +1394,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 +1406,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 +1435,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 +1468,7 @@ const _catch = exports.catch = effect._catch;
  *     Effect.succeed(`Recovering from ${error._tag}`)
  *   )
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1444,6 +1492,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 +1510,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 +1540,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 +1565,7 @@ const catchAllCause = exports.catchAllCause = core.catchAllCause;
  * //   _tag: "Success",
  * //   value: undefined
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1531,6 +1583,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 +1618,7 @@ const catchAllDefect = exports.catchAllDefect = effect.catchAllDefect;
  *     () => Effect.succeed("Recovering from HttpError")
  *   )
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1585,6 +1639,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 +1677,7 @@ const catchIf = exports.catchIf = core.catchIf;
  *     }
  *   })
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1661,6 +1717,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 +1748,7 @@ const catchSomeCause = exports.catchSomeCause = effect.catchSomeCause;
  * //     defect: { _tag: 'RuntimeException' }
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1714,6 +1772,7 @@ const catchSomeDefect = exports.catchSomeDefect = effect.catchSomeDefect;
  * types at once.
  *
  * @example
+ * ```ts
  * // Title: Handling Errors by Tag
  * import { Effect, Random } from "effect"
  *
@@ -1747,6 +1806,7 @@ const catchSomeDefect = exports.catchSomeDefect = effect.catchSomeDefect;
  *     Effect.succeed("Recovering from HttpError")
  *   )
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1767,6 +1827,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 +1863,7 @@ const catchTag = exports.catchTag = effect.catchTag;
  *       Effect.succeed(`Recovering from ValidationError`)
  *   })
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -1819,6 +1881,7 @@ const catchTags = exports.catchTags = effect.catchTags;
  * interruptions, etc.).
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * //      ┌─── Effect<number, string, never>
@@ -1831,6 +1894,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 +1916,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 +1926,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 +1952,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 +1971,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 +1993,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 +2028,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 +2051,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 +2080,7 @@ const sandbox = exports.sandbox = effect.sandbox;
  * // failure
  * // success
  * // yay!
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -2026,6 +2098,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 +2130,7 @@ const retry = exports.retry = _schedule.retry_combined;
  * // failure
  * // orElse
  * // default value
+ * ```
  *
  * @since 2.0.0
  * @category Error handling
@@ -2113,6 +2187,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 +2200,7 @@ const tryMapPromise = exports.tryMapPromise = effect.tryMapPromise;
  * //      ┌─── Effect<Response, UnknownException, never>
  * //      ▼
  * const program = getTodo(1)
+ * ```
  *
  * @example
  * // Title: Custom Error Handling
@@ -2207,6 +2283,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 +2313,7 @@ const checkInterruptible = exports.checkInterruptible = core.checkInterruptible;
  * //   }
  * // }
  * // Heavy processing done.
+ * ```
  *
  * @since 2.0.0
  * @category Interruption
@@ -2281,6 +2359,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 +2369,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 +2382,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 +2391,7 @@ const liftPredicate = exports.liftPredicate = effect.liftPredicate;
  *
  * Effect.runPromise(program).then(console.log)
  * // Output: "new value"
+ * ```
  *
  * @since 2.0.0
  * @category Mapping
@@ -2353,6 +2435,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 +2445,7 @@ const asVoid = exports.asVoid = core.asVoid;
  * //      ┌─── Effect<string, number, never>
  * //      ▼
  * const flipped = Effect.flip(program)
+ * ```
  *
  * @since 2.0.0
  * @category Mapping
@@ -2402,6 +2486,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 +2501,7 @@ const flipWith = exports.flipWith = effect.flipWith;
  *
  * Effect.runPromise(finalAmount).then(console.log)
  * // Output: 101
+ * ```
  * @since 2.0.0
  * @category Mapping
  */
@@ -2440,6 +2526,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 +2545,7 @@ const map = exports.map = core.map;
  * // Output:
  * // 6
  * // [ 'A', 'BB', 'CCC' ]
+ * ```
  *
  * @since 2.0.0
  * @category Mapping
@@ -2476,6 +2564,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 +2577,7 @@ const mapAccum = exports.mapAccum = effect.mapAccum;
  *   onFailure: (message) => new Error(message),
  *   onSuccess: (n) => n > 0
  * })
+ * ```
  *
  * @since 2.0.0
  * @category Mapping
@@ -2507,6 +2597,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 +2610,7 @@ const mapBoth = exports.mapBoth = core.mapBoth;
  *   simulatedTask,
  *   (message) => new Error(message)
  * )
+ * ```
  *
  * @since 2.0.0
  * @category Mapping
@@ -2546,6 +2638,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 +2648,7 @@ const mapErrorCause = exports.mapErrorCause = effect.mapErrorCause;
  * //      ┌─── Effect<number | string, never, never>
  * //      ▼
  * const recovered = Effect.merge(program)
+ * ```
  *
  * @since 2.0.0
  * @category Mapping
@@ -2703,6 +2797,15 @@ const scope = exports.scope = fiberRuntime.scope;
  * @category scoping, resources & finalization
  */
 const scopeWith = exports.scopeWith = fiberRuntime.scopeWith;
+/**
+ * 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
+ */
+const scopedWith = exports.scopedWith = fiberRuntime.scopedWith;
 /**
  * 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
@@ -3026,6 +3129,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 +3155,7 @@ const timedWith = exports.timedWith = effect.timedWith;
  * //     failure: { _tag: 'TimeoutException' }
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category delays & timeouts
@@ -3076,6 +3181,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 +3205,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 +3230,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 +3263,7 @@ const timeoutOption = exports.timeoutOption = circular.timeoutOption;
  * //     failure: MyTimeoutError { _tag: 'MyTimeoutError' }
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category delays & timeouts
@@ -3178,6 +3287,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 +3312,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 +3340,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 +3368,7 @@ const timeoutFailCause = exports.timeoutFailCause = circular.timeoutFailCause;
  * //   _tag: "Left",
  * //   left: "Timed out!"
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category delays & timeouts
@@ -3322,6 +3435,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 +3467,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 +3486,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 +3514,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 +3585,7 @@ const updateService = exports.updateService = effect.updateService;
  * @see {@link let_ let}
  *
  * @example
+ * ```ts
  * import { Effect, pipe } from "effect"
  *
  * const result = pipe(
@@ -3477,6 +3595,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 +3616,7 @@ const Do = exports.Do = effect.Do;
  * @see {@link let_ let}
  *
  * @example
+ * ```ts
  * import { Effect, pipe } from "effect"
  *
  * const result = pipe(
@@ -3506,6 +3626,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 +3638,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 +3650,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 +3671,7 @@ const bindAll = exports.bindAll = circular.bindAll;
  * @see {@link let_ let}
  *
  * @example
+ * ```ts
  * import { Effect, pipe } from "effect"
  *
  * const result = pipe(
@@ -3557,6 +3681,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 +3706,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 +3739,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 +3764,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 +3800,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 +3823,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 +3855,7 @@ const either = exports.either = core.either;
  * //   _tag: "Success",
  * //   value: undefined
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Outcome Encapsulation
@@ -3741,6 +3872,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 +3896,7 @@ const exit = exports.exit = core.exit;
  * // Output:
  * // 42
  * // true
+ * ```
  *
  * @since 2.0.0
  * @category Synchronization Utilities
@@ -3805,6 +3938,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 +3959,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 +4003,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 +4029,7 @@ const unlessEffect = exports.unlessEffect = effect.unlessEffect;
  * //   _id: "Option",
  * //   _tag: "None"
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Conditional Operators
@@ -3916,6 +4053,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 +4064,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 +4115,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 +4138,7 @@ const whenRef = exports.whenRef = effect.whenRef;
  *
  * Effect.runPromise(finalAmount).then(console.log)
  * // Output: 95
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -4037,6 +4178,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 +4213,7 @@ const flatMap = exports.flatMap = core.flatMap;
  *
  * Effect.runPromise(result2).then(console.log)
  * // Output: 190
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -4151,6 +4294,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 +4322,7 @@ const summarized = exports.summarized = effect.summarized;
  * // Output:
  * // Apply a discount to: 100
  * // 95
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -4195,6 +4340,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 +4360,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 +4377,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 +4405,7 @@ const tapBoth = exports.tapBoth = effect.tapBoth;
  * // Output:
  * // defect: RuntimeException: Something went wrong
  * //   ... stack trace ...
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -4272,6 +4421,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 +4435,7 @@ const tapDefect = exports.tapDefect = effect.tapDefect;
  * Effect.runFork(tapping)
  * // Output:
  * // expected error: NetworkError
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -4300,6 +4451,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 +4476,7 @@ const tapError = exports.tapError = effect.tapError;
  * Effect.runFork(tapping)
  * // Output:
  * // expected error: 504
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -4339,6 +4492,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 +4519,7 @@ const tapErrorTag = exports.tapErrorTag = effect.tapErrorTag;
  * // Output:
  * // error cause: RuntimeException: Something went wrong
  * //   ... stack trace ...
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -4396,6 +4551,7 @@ const forever = exports.forever = effect.forever;
  * ```
  *
  * @example
+ * ```ts
  * // Title: Effectful Iteration
  * import { Effect } from "effect"
  *
@@ -4412,6 +4568,7 @@ const forever = exports.forever = effect.forever;
  *
  * Effect.runPromise(result).then(console.log)
  * // Output: 6
+ * ```
  *
  * @since 2.0.0
  * @category Looping
@@ -4444,6 +4601,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 +4621,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 +4663,7 @@ const loop = exports.loop = effect.loop;
  * an additional time.
  *
  * @example
+ * ```ts
  * // Success Example
  * import { Effect, Schedule, Console } from "effect"
  *
@@ -4512,6 +4672,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 +4708,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 +4730,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 +4760,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 +4883,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 +4909,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 +4945,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 +4973,7 @@ const matchCause = exports.matchCause = core.matchCause;
  *
  * Effect.runSync(program)
  * // Output: "Die: Uh oh!"
+ * ```
  *
  * @since 2.0.0
  * @category getters & folding
@@ -4833,6 +5002,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 +5016,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 +5045,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 +5092,7 @@ const logFatal = exports.logFatal = effect.logFatal;
  * time-sensitive processes.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -4928,6 +5102,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 +5114,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 +5125,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 +5138,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 +5153,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 +5189,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 +5206,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 +5230,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 +5250,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 +5267,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 +5283,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 +5302,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 +5324,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 +5348,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 +5366,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 +5390,7 @@ const orElseSucceed = exports.orElseSucceed = effect.orElseSucceed;
  * error.
  *
  * @example
+ * ```ts
  * import { Effect, Console } from "effect"
  *
  * interface Config {
@@ -5247,6 +5437,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 +5569,7 @@ const unsafeMakeLatch = exports.unsafeMakeLatch = circular.unsafeMakeLatch;
  * @category latch
  * @since 3.8.0
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * Effect.gen(function*() {
@@ -5394,6 +5586,7 @@ const unsafeMakeLatch = exports.unsafeMakeLatch = circular.unsafeMakeLatch;
  *   yield* latch.open
  *   yield* fiber.await
  * })
+ * ```
  */
 const makeLatch = exports.makeLatch = circular.makeLatch;
 /**
@@ -5410,6 +5603,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 +5621,7 @@ const makeLatch = exports.makeLatch = circular.makeLatch;
  * setTimeout(() => {
  *   Effect.runFork(Fiber.interrupt(fiber))
  * }, 500)
+ * ```
  *
  * @since 2.0.0
  * @category Running Effects
@@ -5452,11 +5647,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 +5684,7 @@ const runPromise = exports.runPromise = _runtime.unsafeRunPromiseEffect;
  *   a `Cause` type.
  *
  * @example
+ * ```ts
  * // Title: Handling Results as Exit
  * import { Effect } from "effect"
  *
@@ -5511,6 +5709,7 @@ const runPromise = exports.runPromise = _runtime.unsafeRunPromiseEffect;
  * //     failure: "my error"
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Running Effects
@@ -5532,6 +5731,7 @@ const runPromiseExit = exports.runPromiseExit = _runtime.unsafeRunPromiseExitEff
  * throwing an error.
  *
  * @example
+ * ```ts
  * // Title: Synchronous Logging
  * import { Effect } from "effect"
  *
@@ -5545,6 +5745,7 @@ const runPromiseExit = exports.runPromiseExit = _runtime.unsafeRunPromiseExitEff
  *
  * console.log(result)
  * // Output: 1
+ * ```
  *
  * @example
  * // Title: Incorrect Usage with Failing or Async Effects
@@ -5593,6 +5794,7 @@ const runSync = exports.runSync = _runtime.unsafeRunSyncEffect;
  * resolved synchronously.
  *
  * @example
+ * ```ts
  * // Title: Handling Results as Exit
  * import { Effect } from "effect"
  *
@@ -5615,6 +5817,7 @@ const runSync = exports.runSync = _runtime.unsafeRunSyncEffect;
  * //     failure: "my error"
  * //   }
  * // }
+ * ```
  *
  * @example
  * // Title: Asynchronous Operation Resulting in Die
@@ -5655,6 +5858,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 +5886,7 @@ const runSyncExit = exports.runSyncExit = _runtime.unsafeRunSyncExitEffect;
  * //     right: { _id: 'Cause', _tag: 'Fail', failure: 'Oh no!' }
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Error Accumulation
@@ -5710,6 +5915,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 +5939,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 +5985,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 +6004,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 +6028,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 +6047,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 +6069,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 +6094,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 +6171,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 +6179,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 +6270,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 +6280,7 @@ const withSpan = exports.withSpan = effect.withSpan;
  *     attributes: { id }
  *   })
  * })
+ * ```
  */
 const functionWithSpan = exports.functionWithSpan = effect.functionWithSpan;
 /**
@@ -6094,6 +6311,7 @@ const withParentSpan = exports.withParentSpan = effect.withParentSpan;
  * value.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * //      ┌─── Effect<number, NoSuchElementException, never>
@@ -6119,6 +6337,7 @@ const withParentSpan = exports.withParentSpan = effect.withParentSpan;
  * //     failure: { _tag: 'NoSuchElementException' }
  * //   }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category Optional Wrapping
@@ -6136,6 +6355,7 @@ const fromNullable = exports.fromNullable = effect.fromNullable;
  * unchanged.
  *
  * @example
+ * ```ts
  * import { Effect } from "effect"
  *
  * //      ┌─── Effect<number, NoSuchElementException, never>
@@ -6159,6 +6379,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 +6413,7 @@ const makeTagProxy = TagClass => {
 };
 /**
  * @example
+ * ```ts
  * import { Effect, Layer } from "effect"
  *
  * class MapTag extends Effect.Tag("MapTag")<MapTag, Map<string, string>>() {
@@ -6200,6 +6422,7 @@ const makeTagProxy = TagClass => {
  *    Effect.sync(() => new Map())
  *  )
  * }
+ * ```
  *
  * @since 2.0.0
  * @category Context
@@ -6226,6 +6449,7 @@ const Tag = id => () => {
 };
 /**
  * @example
+ * ```ts
  * import { Effect } from 'effect';
  *
  * class Prefix extends Effect.Service<Prefix>()("Prefix", {
@@ -6245,6 +6469,7 @@ const Tag = id => () => {
  *  }),
  *  dependencies: [Prefix.Default]
  * }) {}
+ * ```
  *
  * @since 3.9.0
  * @category Context
@@ -6335,5 +6560,72 @@ const Service = function () {
     return proxy === true ? makeTagProxy(TagClass) : TagClass;
   };
 };
+/**
+ * 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)
+ *   )
+ * )
+ */
 exports.Service = Service;
+const fn = (name, options) => (body, ...pipeables) => {
+  return function (...args) {
+    const limit = Error.stackTraceLimit;
+    Error.stackTraceLimit = 2;
+    const error = new Error();
+    Error.stackTraceLimit = limit;
+    let cache = false;
+    const captureStackTrace = () => {
+      if (cache !== false) {
+        return cache;
+      }
+      if (error.stack) {
+        const stack = error.stack.trim().split("\n");
+        cache = stack.slice(2).join("\n").trim();
+        return cache;
+      }
+    };
+    let effect;
+    let fnError = undefined;
+    try {
+      effect = (0, _Utils.isGeneratorFunction)(body) ? gen(() => (0, _Utils.internalCall)(() => body.apply(this, args))) : body.apply(this, args);
+    } catch (error) {
+      fnError = error;
+      effect = die(error);
+    }
+    try {
+      for (const x of pipeables) {
+        effect = x(effect);
+      }
+    } catch (error) {
+      effect = fnError ? failCause(internalCause.sequential(internalCause.die(fnError), internalCause.die(error))) : die(error);
+    }
+    const opts = options && "captureStackTrace" in options ? options : {
+      captureStackTrace,
+      ...options
+    };
+    return withSpan(effect, name, opts);
+  };
+};
+exports.fn = fn;
 //# sourceMappingURL=Effect.js.map