effect 4.0.0 → 4.0.2

package/dist/Effect.js

@@ -14,6 +14,7 @@ import { CurrentLogAnnotations, CurrentLogSpans } from "./References.js";
 /**
  * Runtime identifier used to recognize `Effect` values.
  *
+ * @stability stable
  * @category type IDs
  * @since 4.0.0
  */
@@ -30,6 +31,7 @@ export const TypeId = core.EffectTypeId;
  * Effect.isEffect("hello") // => false
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 2.0.0
  */
@@ -143,6 +145,7 @@ export const isEffect = core.isEffect;
  * ```
  *
  * @see {@link forEach} for iterating over elements and applying an effect.
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -171,6 +174,7 @@ export const all = internal.all;
  * await Effect.runPromise(program) // => [[1, 3], ['0 is even', '2 is even']]
  * ```
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -209,6 +213,7 @@ export const partition = internal.partition;
  * output // => ["Adding 1 at index 0", "Adding 2 at index 1", "Adding 3 at index 2", 6]
  * ```
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -237,6 +242,7 @@ export const reduce = internal.reduce;
  * await Effect.runPromiseExit(program) // => Exit.fail(["0 is even", "2 is even"])
  * ```
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -259,6 +265,7 @@ export const validate = internal.validate;
  * await Effect.runPromise(program) // => Option.some(3)
  * ```
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -278,6 +285,7 @@ export const findFirst = internal.findFirst;
  *
  * @see {@link findFirst} for the simpler effectful predicate-based variant
  *
+ * @stability stable
  * @category collecting
  * @since 4.0.0
  */
@@ -343,6 +351,7 @@ export const findFirstFilter = internal.findFirstFilter;
  * ```
  *
  * @see {@link all} for combining multiple effects into one.
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -368,6 +377,7 @@ export const forEach = internal.forEach;
  * await Effect.runPromise(empty) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -393,6 +403,7 @@ export const head = internal.head;
  * output // => ["Current count: 1", "Current count: 2", "Current count: 3", "Current count: 4", "Current count: 5"]
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -437,6 +448,7 @@ export const whileLoop = internal.whileLoop;
  * ```
  *
  * @see {@link tryPromise} for a version that can handle failures.
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -508,6 +520,7 @@ export const promise = internal.promise;
  * ```
  *
  * @see {@link promise} if the effectful computation is asynchronous and does not throw errors.
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -534,6 +547,7 @@ export const tryPromise = internal.tryPromise;
  * ```
  *
  * @see {@link fail} to create an effect that represents a failure.
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -551,6 +565,7 @@ export const succeed = internal.succeed;
  * Effect.runSync(program) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -568,6 +583,7 @@ export const succeedNone = internal.succeedNone;
  * Effect.runSync(program) // => Option.some(42)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -658,6 +674,7 @@ export const succeedSome = internal.succeedSome;
  * Effect.runSync(withSuspend(6, 2)) // => 3
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -698,6 +715,7 @@ export const suspend = internal.suspend;
  * ```
  *
  * @see {@link try_ | try} for a version that can handle failures.
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -707,6 +725,7 @@ export {
 /**
  * Returns an effect that succeeds with `void`.
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -716,6 +735,7 @@ export {
 /**
  * Returns an effect that succeeds with `undefined`.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -753,6 +773,7 @@ undefined_ as undefined };
  * output // => ["callback completed"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -770,6 +791,7 @@ export const callback = internal.callback;
  * await Effect.runPromise(program) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -793,6 +815,7 @@ export const never = internal.never;
  * Effect.runSync(program) // => { x: 2, y: 3, sum: 5 }
  * ```
  *
+ * @stability stable
  * @category do notation
  * @since 2.0.0
  */
@@ -809,6 +832,7 @@ export const Do = internal.Do;
  * @see {@link Do} for starting from an empty accumulated record
  * @see {@link bind} for adding fields produced by effects
  *
+ * @stability stable
  * @category do notation
  * @since 2.0.0
  */
@@ -834,6 +858,7 @@ export {
  * @see {@link Do} for starting from an empty accumulated record
  * @see {@link gen} for sequencing without accumulating a record
  *
+ * @stability stable
  * @category do notation
  * @since 2.0.0
  */
@@ -862,6 +887,7 @@ let_ as let };
  * @see {@link bindTo} for naming the success value of an existing effect
  * @see {@link gen} for generator-based sequencing without accumulating a record
  *
+ * @stability stable
  * @category do notation
  * @since 2.0.0
  */
@@ -915,6 +941,7 @@ export const bind = internal.bind;
  * await Effect.runPromise(program) // => "Final amount to charge: 96"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -947,6 +974,7 @@ export const gen = internal.gen;
  * ```
  *
  * @see {@link succeed} to create an effect that represents a successful value.
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -974,6 +1002,7 @@ export const fail = internal.fail;
  * Effect.runSync(Effect.flip(program)).operation // => "sync"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1004,6 +1033,7 @@ export const failSync = internal.failSync;
  * Effect.runSync(Effect.flip(program)) // => "Network error"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1031,6 +1061,7 @@ export const failCause = internal.failCause;
  * Effect.runSync(Effect.flip(program)) // => "Error computed at runtime"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1070,6 +1101,7 @@ export const failCauseSync = internal.failCauseSync;
  * Effect.runSyncExit(program) // => Exit.die(defect)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1136,6 +1168,7 @@ export {
  *
  * @see {@link sync} if the effectful computation is synchronous and does not
  * throw errors.
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1159,6 +1192,7 @@ try_ as try };
  * output // => ["Before yield", "After yield"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1182,6 +1216,7 @@ export const yieldNow = internal.yieldNow;
  * output // => ["High priority task", "Continued after yield"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1199,6 +1234,7 @@ export const yieldNowWith = internal.yieldNowWith;
  * Effect.runSync(program) // => "number"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1216,6 +1252,7 @@ export const withFiber = core.withFiber;
  * Effect.runSync(program) // => "number"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1243,6 +1280,7 @@ export const withFiberSucceed = core.withFiberSucceed;
  * output // => [42, "Something went wrong"]
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 4.0.0
  */
@@ -1281,6 +1319,7 @@ export const fromResult = internal.fromResult;
  * output // => [42, "NoSuchElementError", "missing"]
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 4.0.0
  */
@@ -1313,6 +1352,7 @@ export const fromOption = internal.fromOption;
  * Effect.runSync(program) // => Option.some(42)
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 3.13.0
  */
@@ -1339,6 +1379,7 @@ export const transposeOption = internal.transposeOption;
  * output // => ["missing", "hello"]
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 4.0.0
  */
@@ -1416,6 +1457,7 @@ export const fromNullishOr = internal.fromNullishOr;
  * ```
  *
  * @see {@link tap} for a version that ignores the result of the effect.
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1440,6 +1482,7 @@ export const flatMap = internal.flatMap;
  * output // => ["hello"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1522,6 +1565,7 @@ export const flatten = internal.flatten;
  * await Effect.runPromise(result2) // => 190
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1574,6 +1618,7 @@ export const andThen = internal.andThen;
  * output // => ["Apply a discount to: 100", 95]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1626,6 +1671,7 @@ export const tap = internal.tap;
  * @see {@link option} for a version that uses `Option` instead.
  * @see {@link exit} for a version that encapsulates both recoverable errors and defects in an `Exit`.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -1668,6 +1714,7 @@ export const result = internal.result;
  * @see {@link result} for a version that uses `Result` instead.
  * @see {@link exit} for a version that encapsulates both recoverable errors and defects in an `Exit`.
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -1709,6 +1756,7 @@ export const option = internal.option;
  * @see {@link option} for a version that uses `Option` instead.
  * @see {@link result} for a version that uses `Result` instead.
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -1772,6 +1820,7 @@ export const exit = internal.exit;
  * @see {@link mapError} for a version that operates on the error channel.
  * @see {@link mapBoth} for a version that operates on both channels.
  * @see {@link flatMap} or {@link andThen} for a version that can return a new effect.
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -1803,6 +1852,7 @@ export const map = internal.map;
  * @see {@link map} for deriving the replacement value from the success value
  * @see {@link asVoid} for replacing the success value with `void`
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -1820,6 +1870,7 @@ export const as = internal.as;
  * Effect.runSync(program) // => Option.some(42)
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -1837,6 +1888,7 @@ export const asSome = internal.asSome;
  * Effect.runSync(program) // => undefined
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -1867,6 +1919,7 @@ export const asVoid = internal.asVoid;
  * Effect.runSync(flipped) // => "Oh uh!"
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -1925,6 +1978,7 @@ export const flip = internal.flip;
  * @see {@link zipWith} for a version that combines the results with a custom function.
  * @see {@link all} for collecting a larger structure of effects.
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -1963,6 +2017,7 @@ export const zip = internal.zip;
  * Effect.runSync(task3) // => 6
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -1994,6 +2049,7 @@ export {
  *
  * @see {@link catchCause} for a version that can recover from both recoverable and unrecoverable errors.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2042,6 +2098,7 @@ catch_ as catch };
  * @see {@link catchTags} for handling multiple tagged errors in one call
  * @see {@link catchIf} for recovering from errors that match a predicate
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -2090,6 +2147,7 @@ export const catchTag = internal.catchTag;
  * Effect.runSync(handled) // => "Network error: 503"
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -2140,6 +2198,7 @@ export const catchTags = internal.catchTags;
  *
  * @see {@link catchReasons} for handling several nested reason tags
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2180,6 +2239,7 @@ export const catchReason = internal.catchReason;
  * Effect.runSync(handled) // => "Quota exceeded: 100"
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2215,6 +2275,7 @@ export const catchReasons = internal.catchReasons;
  * Effect.runSync(Effect.flip(unwrapped))._tag // => "RateLimitError"
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2260,6 +2321,7 @@ export const unwrapReason = internal.unwrapReason;
  * output // => ["Caught defect", "Recovered from defect"]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2304,6 +2366,7 @@ export const catchCause = internal.catchCause;
  * output // => ["Caught defect: Unexpected error", "Recovered from defect"]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2349,6 +2412,7 @@ export const catchDefect = internal.catchDefect;
  * Effect.runSync(Effect.all([recovered, recovered2])) // => ['missing:user-1', 'missing:user-1']
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -2374,6 +2438,7 @@ export const catchIf = internal.catchIf;
  * @see {@link catchTags} for recovering from several tagged errors
  * @see {@link catchCauseFilter} for filtering full causes instead of typed errors
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2409,6 +2474,7 @@ export const catchFilter = internal.catchFilter;
  * @see {@link fromNullishOr} for converting nullish values into `NoSuchElementError`
  * @see {@link option} for converting any failure into `Option.none`
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2453,6 +2519,7 @@ export const catchNoSuchElement = internal.catchNoSuchElement;
  * @see {@link catchCauseFilter} for selecting full causes with a `Filter`
  * @see {@link catchIf} for predicate-based recovery from typed errors
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2476,6 +2543,7 @@ export const catchCauseIf = internal.catchCauseIf;
  * @see {@link catchFilter} for filtering typed error values instead of full causes
  * @see {@link catchCause} for recovering from every cause without filtering
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2516,6 +2584,7 @@ export const catchCauseFilter = internal.catchCauseFilter;
  * @see {@link map} for a version that operates on the success channel.
  * @see {@link mapBoth} for a version that operates on both channels.
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -2558,6 +2627,7 @@ export const mapError = internal.mapError;
  * @see {@link map} for a version that operates on the success channel.
  * @see {@link mapError} for a version that operates on the error channel.
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -2590,6 +2660,7 @@ export const mapBoth = internal.mapBoth;
  * Effect.runSyncExit(program) // => Exit.die(new DivideByZeroError())
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -2623,6 +2694,7 @@ export const orDie = internal.orDie;
  * output // => ["expected error: NetworkError", Exit.fail("NetworkError")]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -2661,6 +2733,7 @@ export const tapError = internal.tapError;
  * output // => ["expected error: 504", Exit.fail(new NetworkError({ statusCode: 504 }))]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -2697,6 +2770,7 @@ export const tapErrorTag = internal.tapErrorTag;
  * output // => ["Logging cause: Something went wrong", Exit.fail("Something went wrong")]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2729,6 +2803,7 @@ export const tapCause = internal.tapCause;
  * output // => ["Logging failure cause: Network timeout", Exit.fail("Network timeout")]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2752,6 +2827,7 @@ export const tapCauseIf = internal.tapCauseIf;
  * @see {@link tapCause} for observing every failure cause
  * @see {@link catchCauseFilter} for recovering from selected causes instead of only observing them
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -2787,6 +2863,7 @@ export const tapCauseFilter = internal.tapCauseFilter;
  * output // => ["defect: Something went wrong", Exit.die("Something went wrong")]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -2821,6 +2898,7 @@ export const tapDefect = internal.tapDefect;
  * output // => ["Attempt 1", "Attempt 2", "Attempt 3", "Ready"]
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -2873,6 +2951,7 @@ export const eventually = internal.eventually;
  *
  * @see {@link retryOrElse} for a version that allows you to run a fallback.
  * @see {@link repeat} if your retry condition is based on successful outcomes rather than errors.
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -2927,6 +3006,7 @@ export const retry = internalSchedule.retry;
  * ```
  *
  * @see {@link retry} for a version that does not run a fallback effect.
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -2956,6 +3036,7 @@ export const retryOrElse = internalSchedule.retryOrElse;
  * Effect.runSync(program) // => "Caught cause: Something went wrong"
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -2999,6 +3080,7 @@ export const sandbox = internal.sandbox;
  * Effect.runSync(program) // => undefined
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -3027,6 +3109,7 @@ export const ignore = internal.ignore;
  * Effect.runSync(program) // => undefined
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3103,6 +3186,7 @@ export const ignoreCause = internal.ignoreCause;
  * events // => ["AttemptStart:0", "AttemptFailure:0", "AttemptStart:1", "AttemptSuccess:1"]
  * ```
  *
+ * @stability unstable
  * @category error handling
  * @since 3.16.0
  */
@@ -3115,6 +3199,7 @@ export const withExecutionPlan = internalExecutionPlan.withExecutionPlan;
  * If the `defectsOnly` option is set to `true`, only defects (unrecoverable
  * errors) will be reported, while regular failures will be ignored.
  *
+ * @stability unstable
  * @category error handling
  * @since 4.0.0
  */
@@ -3154,6 +3239,7 @@ export const withErrorReporting = internal.withErrorReporting;
  * Effect.runSyncExit(program) // => Exit.succeed(0)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -3198,6 +3284,7 @@ export const orElseSucceed = internal.orElseSucceed;
  * Effect.runSync(program) // => "secondary result"
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -3239,6 +3326,7 @@ export const firstSuccessOf = internal.firstSuccessOf;
  * @see {@link timeoutOption} for returning `Option.none` on timeout.
  * @see {@link timeoutOrElse} for a version that allows specifying both success and timeout handlers.
  *
+ * @stability stable
  * @category delays & timeouts
  * @since 2.0.0
  */
@@ -3270,6 +3358,7 @@ export const timeout = internal.timeout;
  * @see {@link timeout} for a version that raises a `TimeoutError`.
  * @see {@link timeoutOrElse} for a version that allows specifying both success and timeout handlers.
  *
+ * @stability stable
  * @category delays & timeouts
  * @since 3.1.0
  */
@@ -3298,6 +3387,7 @@ export const timeoutOption = internal.timeoutOption;
  * @see {@link timeout} for failing with a `TimeoutError`.
  * @see {@link timeoutOption} for returning `Option.none` on timeout.
  *
+ * @stability stable
  * @category delays & timeouts
  * @since 4.0.0
  */
@@ -3318,6 +3408,7 @@ export const timeoutOrElse = internal.timeoutOrElse;
  * output // => ["Delayed message"]
  * ```
  *
+ * @stability stable
  * @category delays & timeouts
  * @since 2.0.0
  */
@@ -3342,6 +3433,7 @@ export const delay = internal.delay;
  * output // => ["Start", "End"]
  * ```
  *
+ * @stability stable
  * @category delays & timeouts
  * @since 2.0.0
  */
@@ -3367,6 +3459,7 @@ export const sleep = internal.sleep;
  * Effect.runSync(program) // => "ok"
  * ```
  *
+ * @stability stable
  * @category delays & timeouts
  * @since 2.0.0
  */
@@ -3402,6 +3495,7 @@ export const timed = internal.timed;
  * ```
  *
  * @see {@link race} for a version that handles only two effects.
+ * @stability stable
  * @category racing
  * @since 2.0.0
  */
@@ -3428,6 +3522,7 @@ export const raceAll = internal.raceAll;
  * await Effect.runPromise(Effect.flip(raced)) // => "First failed"
  * ```
  *
+ * @stability stable
  * @category racing
  * @since 4.0.0
  */
@@ -3458,6 +3553,7 @@ export const raceAllFirst = internal.raceAllFirst;
  * output // => ["winner: slow-success"]
  * ```
  *
+ * @stability stable
  * @category racing
  * @since 2.0.0
  */
@@ -3496,6 +3592,7 @@ export const race = internal.race;
  * output // => ["failed: fast-fail"]
  * ```
  *
+ * @stability stable
  * @category racing
  * @since 2.0.0
  */
@@ -3524,6 +3621,7 @@ export const raceFirst = internal.raceFirst;
  * output // => [[2, 4], [2, 3]]
  * ```
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -3544,6 +3642,7 @@ export const filter = internal.filter;
  * @see {@link filter} for keeping original elements with a boolean predicate, refinement, or effectful predicate
  * @see {@link filterMapEffect} for using an effectful `Filter`
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -3569,6 +3668,7 @@ export const filterMap = internal.filterMap;
  * @see {@link filterMap} for using a synchronous `Filter`
  * @see {@link filter} for keeping original elements with a predicate
  *
+ * @stability stable
  * @category collecting
  * @since 4.0.0
  */
@@ -3606,6 +3706,7 @@ export const filterMapEffect = internal.filterMapEffect;
  * Effect.runSync(filtered) // => "Number 5 is odd"
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -3627,6 +3728,7 @@ export const filterOrElse = internal.filterOrElse;
  * @see {@link filterOrElse} for using a predicate and fallback effect
  * @see {@link filterMapOrFail} for failing the effect when the filter fails
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -3658,6 +3760,7 @@ export const filterMapOrElse = internal.filterMapOrElse;
  * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -3679,6 +3782,7 @@ export const filterOrFail = internal.filterOrFail;
  * @see {@link filterOrFail} for validating with a predicate instead of a `Filter`
  * @see {@link filterMap} for filtering and mapping iterable elements
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -3719,6 +3823,7 @@ export const filterMapOrFail = internal.filterMapOrFail;
  * output // => ["Condition is true!", Option.some(undefined)]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -3773,6 +3878,7 @@ export const when = internal.when;
  * ```
  *
  * @see {@link matchEffect} if you need to perform side effects in the handlers.
+ * @stability stable
  * @category pattern matching
  * @since 2.0.0
  */
@@ -3813,6 +3919,7 @@ export const match = internal.match;
  *
  * @see {@link match} for the non-eager version.
  * @see {@link matchEffect} if you need to perform side effects in the handlers.
+ * @stability stable
  * @category pattern matching
  * @since 4.0.0
  */
@@ -3848,6 +3955,7 @@ export const matchEager = internal.matchEager;
  * @see {@link matchCauseEffect} if you need to perform side effects in the
  * handlers.
  * @see {@link match} if you don't need to handle the cause of the failure.
+ * @stability stable
  * @category pattern matching
  * @since 2.0.0
  */
@@ -3878,6 +3986,7 @@ export const matchCause = internal.matchCause;
  * Effect.runSync(handleResult) // => "Success: 42"
  * ```
  *
+ * @stability stable
  * @category pattern matching
  * @since 4.0.0
  */
@@ -3899,6 +4008,7 @@ export const matchCauseEager = internal.matchCauseEager;
  * @see {@link matchCauseEager} for eager cause matching with pure handlers
  * @see {@link matchEffect} for effectful matching on typed failures instead of full causes
  *
+ * @stability stable
  * @category pattern matching
  * @since 4.0.0
  */
@@ -3958,6 +4068,7 @@ export const matchCauseEffectEager = internal.matchCauseEffectEager;
  * @see {@link matchCause} if you don't need side effects and only want to handle the result or failure.
  * @see {@link matchEffect} if you don't need to handle the cause of the failure.
  *
+ * @stability stable
  * @category pattern matching
  * @since 2.0.0
  */
@@ -4009,6 +4120,7 @@ export const matchCauseEffect = internal.matchCauseEffect;
  *
  * @see {@link match} if you don't need side effects and only want to handle the
  * result or failure.
+ * @stability stable
  * @category pattern matching
  * @since 2.0.0
  */
@@ -4038,6 +4150,7 @@ export const matchEffect = internal.matchEffect;
  * output // => [true]
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -4067,6 +4180,7 @@ export const isFailure = internal.isFailure;
  * output // => ["ok: true", "failed: false"]
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -4122,6 +4236,7 @@ export const isSuccess = internal.isSuccess;
  * @see {@link contextWith} for deriving an effect from the complete context
  * @see {@link service} for reading one service from the context
  *
+ * @stability stable
  * @category accessors
  * @since 2.0.0
  */
@@ -4180,6 +4295,7 @@ export const context = internal.context;
  * @see {@link context} for reading the complete context as a value
  * @see {@link service} for reading one service from the context
  *
+ * @stability stable
  * @category accessors
  * @since 2.0.0
  */
@@ -4214,6 +4330,7 @@ export const contextWith = internal.contextWith;
  * await Effect.runPromise(provided) // => "Result for: SELECT * FROM users"
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -4258,6 +4375,7 @@ export const provide = internalLayer.provide;
  * output // => ["Querying database", "result"]
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -4300,6 +4418,7 @@ export const provideContext = internal.provideContext;
  * @see {@link provideContext} for partially satisfying an effect's context requirements.
  * @see {@link updateContext} for deriving the required context from the current one.
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -4329,6 +4448,7 @@ export const setContext = internal.setContext;
  * Effect.runSync(runnable) // => "Result for: SELECT * FROM users"
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 4.0.0
  */
@@ -4374,6 +4494,7 @@ export const service = internal.service;
  * output // => ["Service not available"]
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 2.0.0
  */
@@ -4417,6 +4538,7 @@ export const serviceOption = internal.serviceOption;
  * Effect.runSync(result) // => "Hello World!"
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -4453,6 +4575,7 @@ export const updateContext = internal.updateContext;
  * output // => ["Updated count: 1", 1]
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -4513,6 +4636,7 @@ export const updateService = internal.updateService;
  *
  * @see {@link updateService} for updating a service only within a wrapped effect
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -4561,6 +4685,7 @@ export const updateServiceScoped = internal.updateServiceScoped;
  * @see {@link provide} for providing multiple layers to an effect.
  * @see {@link provideServiceEffect} for acquiring the service implementation effectfully.
  * @see {@link provideContext} for providing a complete context.
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -4617,6 +4742,7 @@ export const provideService = internal.provideService;
  * output // => ["Establishing database connection...", "Database connected!", "Result for: SELECT * FROM users"]
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -4650,6 +4776,7 @@ export const provideServiceEffect = internal.provideServiceEffect;
  * output // => ["Got scope for resource management", "Acquiring resource", "Releasing resource", "resource"]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -4689,6 +4816,7 @@ export const scope = internal.scope;
  * output // => ["Acquiring resource", "Using resource", "Releasing resource"]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -4730,6 +4858,7 @@ export const scoped = internal.scoped;
  * output // => ["Inside scoped context", "Acquiring resource", "Releasing resource", "Manual finalizer", "resource"]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 3.11.0
  */
@@ -4796,6 +4925,7 @@ export const scopedWith = internal.scopedWith;
  * @see {@link acquireDisposable} for resources that implement JavaScript disposal protocols
  * @see {@link acquireUseRelease} for bracketing acquire, use, and release in one effect
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -4845,6 +4975,7 @@ export const acquireRelease = internal.acquireRelease;
  *
  * @see {@link acquireRelease} for resources that need an explicit finalizer
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -4920,6 +5051,7 @@ export const acquireDisposable = internal.acquireDisposable;
  *
  * @see {@link acquireRelease} for scoped resources whose use happens later
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -4967,6 +5099,7 @@ export const acquireUseRelease = internal.acquireUseRelease;
  * @see {@link acquireRelease} for resource acquisition with a release finalizer
  * @see {@link ensuring} for attaching a finalizer to one effect
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -5006,6 +5139,7 @@ export const addFinalizer = internal.addFinalizer;
  * output // => ["Task started", "Task completed", "Cleanup: This always runs!", 42]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -5034,6 +5168,7 @@ export const ensuring = internal.ensuring;
  * output // => ["Cleanup on error: TaskError: Something went wrong", Exit.fail(error)]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -5063,6 +5198,7 @@ export const onError = internal.onError;
  * output // => ["Cause: boom", Exit.fail("boom")]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -5080,6 +5216,7 @@ export const onErrorIf = internal.onErrorIf;
  * @see {@link onErrorIf} for selecting failures with a boolean predicate
  * @see {@link onExitFilter} for selecting from every exit instead of only failures
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -5102,6 +5239,7 @@ export const onErrorFilter = internal.onErrorFilter;
  *
  * @see {@link onExit} for ordinary exit-aware cleanup whose finalizer always returns an effect
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -5133,6 +5271,7 @@ export const onExitPrimitive = internal.onExitPrimitive;
  * output // => ["Task succeeded with: 42", 42]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -5160,6 +5299,7 @@ export const onExit = internal.onExit;
  * output // => ["Succeeded with: 42", 42]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -5182,6 +5322,7 @@ export const onExitIf = internal.onExitIf;
  * @see {@link onExitIf} for selecting exits with a boolean predicate
  * @see {@link onErrorFilter} for selecting only failure causes
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -5205,6 +5346,11 @@ export const onExitFilter = internal.onExitFilter;
  * evaluations of the same effect will return the cached result without
  * re-executing the logic.
  *
+ * Concurrent callers share the pending computation, which is interrupted only
+ * once every caller waiting on it has been interrupted. Interrupted
+ * computations are never cached, so the next evaluation starts a fresh
+ * computation.
+ *
  * **Example** (Memoizing an effect until invalidated)
  *
  * ```ts import.meta.vitest
@@ -5236,6 +5382,7 @@ export const onExitFilter = internal.onExitFilter;
  * time-to-live duration for the cached value.
  * @see {@link cachedInvalidateWithTTL} for a similar function that includes an
  * additional effect for manually invalidating the cached value.
+ * @stability stable
  * @category caching
  * @since 2.0.0
  */
@@ -5265,11 +5412,12 @@ export const cached = internal.cached;
  * `Duration.Input`. The function runs once after each fresh computation,
  * including failures, so successes and failures can have different TTLs. It
  * does not run when the cache is created or when a cached result is reused.
- * The callback also receives interruption exits, which are cached for the
- * returned duration.
+ * Interrupted computations are never cached and do not call the function.
  *
  * The TTL starts when the computation completes. Concurrent callers share the
- * pending computation. A zero TTL expires immediately, and an infinite TTL
+ * pending computation, which is interrupted only once every caller waiting on
+ * it has been interrupted. The next evaluation then starts a fresh
+ * computation. A zero TTL expires immediately, and an infinite TTL
  * keeps the result indefinitely.
  *
  * **Example** (Memoizing an effect with TTL)
@@ -5320,13 +5468,14 @@ export const cached = internal.cached;
  * indefinitely.
  * @see {@link cachedInvalidateWithTTL} for a similar function that includes an
  * additional effect for manually invalidating the cached value.
+ * @stability stable
  * @category caching
  * @since 2.0.0
  */
 export const cachedWithTTL = internal.cachedWithTTL;
 /**
- * Creates a cached effect result for a specified duration and allows manual
- * invalidation before expiration.
+ * Creates a cached effect result for a fixed duration or a duration computed
+ * from its `Exit` and allows manual invalidation before expiration.
  *
  * **When to use**
  *
@@ -5379,6 +5528,7 @@ export const cachedWithTTL = internal.cachedWithTTL;
  * indefinitely.
  * @see {@link cachedWithTTL} for a similar function that caches the result for
  * a specified duration but does not include an effect for manual invalidation.
+ * @stability stable
  * @category caching
  * @since 2.0.0
  */
@@ -5402,6 +5552,7 @@ export const cachedInvalidateWithTTL = internal.cachedInvalidateWithTTL;
  * Effect.runSyncExit(program)._tag // => "Failure"
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -5420,6 +5571,7 @@ export const interrupt = internal.interrupt;
  * await Effect.runPromise(program) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -5445,6 +5597,7 @@ export const interruptible = internal.interruptible;
  * output // => ["Task was interrupted, cleaning up..."]
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -5469,6 +5622,7 @@ export const onInterrupt = internal.onInterrupt;
  * output // => ["Starting critical section...", "Critical section completed"]
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -5501,6 +5655,7 @@ export const uninterruptible = internal.uninterruptible;
  * output // => ["Uninterruptible phase...", "Interruptible phase...", "Back to uninterruptible"]
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -5533,6 +5688,7 @@ export const uninterruptibleMask = internal.uninterruptibleMask;
  * output // => ["Interruptible phase...", "Uninterruptible phase...", "Back to interruptible"]
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -5558,6 +5714,7 @@ export const interruptibleMask = internal.interruptibleMask;
  *
  * @see {@link scoped} for binding resource lifetime to a scope
  *
+ * @stability stable
  * @category interruption
  * @since 4.0.0
  */
@@ -5574,6 +5731,7 @@ export const abortSignal = internal.abortSignal;
  * await Effect.runPromise(program) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -5655,6 +5813,7 @@ export const forever = internal.forever;
  * @see {@link retry} for failure-based repetition
  * @see {@link repeatOrElse} for fallback handling when repetition fails
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -5707,6 +5866,7 @@ export const repeat = internalSchedule.repeat;
  * output // => ["Attempt 1 failed", "Final failure: Error 1, after 0 attempts", 0]
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -5726,6 +5886,7 @@ export const repeatOrElse = internalSchedule.repeatOrElse;
  * @see {@link all} for running the returned effects and collecting results
  * @see {@link replicateEffect} for repeating an effect and collecting results in one step with concurrency and discard options
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -5757,6 +5918,7 @@ export const replicate = internal.replicate;
  * output // => [[1, 1, 1]]
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -5798,6 +5960,7 @@ export const replicateEffect = internal.replicateEffect;
  * @see {@link scheduleFrom} for a variant that allows the schedule's decision
  * to depend on the result of this effect.
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -5837,6 +6000,7 @@ export const schedule = /*#__PURE__*/dual(2, (self, schedule) => scheduleFrom(se
  * output // => ["Processing: 0", "Processing: 0", 2]
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -5860,6 +6024,7 @@ export const scheduleFrom = internalSchedule.scheduleFrom;
  * Effect.runSync(program) // => "function"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -5880,6 +6045,7 @@ export const tracer = internal.tracer;
  * Effect.runSync(program) // => "completed"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -5905,6 +6071,7 @@ export const withTracer = internal.withTracer;
  * Effect.runSync(program) // => 42
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -5925,6 +6092,7 @@ export const withTracerEnabled = internal.withTracerEnabled;
  * Effect.runSync(program) // => 42
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -5952,6 +6120,7 @@ export const withTracerTiming = internal.withTracerTiming;
  * Effect.runSync(Effect.all([annotated1, annotated2])) // => ['result', 'result']
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -5976,6 +6145,7 @@ export const annotateSpans = internal.annotateSpans;
  * Effect.runSync(traced) // => "success"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -6002,6 +6172,7 @@ export const annotateCurrentSpan = internal.annotateCurrentSpan;
  * Effect.runSync(traced) // => "my-span"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -6031,6 +6202,7 @@ export const currentSpan = internal.currentSpan;
  * Effect.runSync(traced) // => "Span"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -6056,6 +6228,7 @@ export const currentParentSpan = internal.currentParentSpan;
  * Effect.runSync(program) // => { userId: '123', operation: 'data-processing' }
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -6082,6 +6255,7 @@ export const spanAnnotations = internal.spanAnnotations;
  * Effect.runSync(program).length // => 0
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -6130,6 +6304,7 @@ export const spanLinks = internal.spanLinks;
  * Effect.runSync(program).length // => 2
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -6156,6 +6331,7 @@ export const linkSpans = internal.linkSpans;
  * Effect.runSync(program) // => "my-operation"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -6185,6 +6361,7 @@ export const makeSpan = internal.makeSpan;
  * Effect.runSync(program) // => "scoped-operation"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -6210,6 +6387,7 @@ export const makeSpanScoped = internal.makeSpanScoped;
  * Effect.runSync(program) // => "user-operation: success"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -6230,6 +6408,7 @@ export const useSpan = internal.useSpan;
  * Effect.runSync(traced) // => "result"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -6256,6 +6435,7 @@ export const withSpan = internal.withSpan;
  * Effect.runSync(program) // => "completed"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -6277,6 +6457,7 @@ export const withSpanScoped = internal.withSpanScoped;
  * Effect.runSync(program) // => "completed"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -6322,6 +6503,7 @@ export const withParentSpan = internal.withParentSpan;
  *
  * @see {@link requestUnsafe} for the low-level entry point when you already have a `Context` and need to enqueue outside an `Effect`
  *
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -6340,6 +6522,7 @@ export const request = internalRequest.request;
  *
  * @see {@link request} for the `Effect`-returning API used for normal request execution
  *
+ * @stability stable
  * @category unsafe
  * @since 4.0.0
  */
@@ -6386,6 +6569,7 @@ export const requestUnsafe = internalRequest.requestUnsafe;
  * await Effect.runPromise(program) // => "result"
  * ```
  *
+ * @stability stable
  * @category forking
  * @since 4.0.0
  */
@@ -6413,6 +6597,7 @@ export const forkChild = internal.forkChild;
  * await Effect.runPromise(program) // => "done"
  * ```
  *
+ * @stability stable
  * @category forking
  * @since 2.0.0
  */
@@ -6439,6 +6624,7 @@ export const forkIn = internal.forkIn;
  * await Effect.runPromise(program) // => "scope completed"
  * ```
  *
+ * @stability stable
  * @category forking
  * @since 2.0.0
  */
@@ -6463,6 +6649,7 @@ export const forkScoped = internal.forkScoped;
  * await Effect.runPromise(program) // => "daemon result"
  * ```
  *
+ * @stability stable
  * @category forking
  * @since 4.0.0
  */
@@ -6490,6 +6677,7 @@ export const forkDetach = internal.forkDetach;
  * @see {@link forkIn} for forking into an explicit scope
  * @see {@link forkScoped} for forking fibers tied to the current scope
  *
+ * @stability stable
  * @category forking
  * @since 2.0.0
  */
@@ -6512,6 +6700,7 @@ export const awaitAllChildren = internal.awaitAllChildren;
  * output // => ["number"]
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 4.0.0
  */
@@ -6528,6 +6717,7 @@ export const fiber = internal.fiber;
  * Effect.runSync(program) // => "number"
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 2.0.0
  */
@@ -6558,6 +6748,7 @@ export const fiberId = internal.fiberId;
  * output // => ["running...", "done"]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -6597,6 +6788,7 @@ export const runFork = internal.runFork;
  * output // => ["Hello from service!", "done"]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -6646,6 +6838,7 @@ export const runForkWith = internal.runForkWith;
  * output // => ["Started", "Success"]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -6687,6 +6880,7 @@ export const runCallbackWith = internal.runCallbackWith;
  * output // => ["working", "success: done"]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -6725,6 +6919,7 @@ export const runCallback = internal.runCallback;
  * ```
  *
  * @see {@link runPromiseExit} for a version that returns an `Exit` type instead of rejecting.
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -6760,6 +6955,7 @@ export const runPromise = internal.runPromise;
  * await Effect.runPromiseWith(context)(program) // => "Connecting to https://api.example.com"
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -6793,6 +6989,7 @@ export const runPromiseWith = internal.runPromiseWith;
  *
  * @see {@link runPromise} for a version that rejects on failure.
  *
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -6833,6 +7030,7 @@ export const runPromiseExit = internal.runPromiseExit;
  * output // => ["Success: Result for: SELECT * FROM users"]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -6890,6 +7088,7 @@ export const runPromiseExitWith = internal.runPromiseExitWith;
  *
  * @see {@link runSyncExit} for a version that returns an `Exit` type instead of
  * throwing an error.
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -6926,6 +7125,7 @@ export const runSync = internal.runSync;
  * result // => 5
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -6974,6 +7174,7 @@ export const runSyncWith = internal.runSyncWith;
  *
  * @see {@link runSync} for a version that throws on failure.
  *
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -7018,6 +7219,7 @@ export const runSyncExit = internal.runSyncExit;
  * output // => ["[LOG] Computing result...", "Success: 42"]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -7113,6 +7315,7 @@ export const runSyncExitWith = internal.runSyncExitWith;
  * Effect.runSync(program) // => "hello"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 3.12.0
  */
@@ -7236,6 +7439,7 @@ export const fnUntraced = internal.fnUntraced;
  * Effect.runSync(program) // => "hello"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 3.11.0
  */
@@ -7261,6 +7465,7 @@ export const fn = internal.fn;
  * Effect.runSync(program) // => "Clock is available"
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 2.0.0
  */
@@ -7298,6 +7503,7 @@ export const clockWith = internal.clockWith;
  * output // => ["Warn: Cache miss"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -7325,6 +7531,7 @@ export const logWithLevel = internal.logWithLevel;
  * output // => ["Info: Result: 4", 4]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -7350,6 +7557,7 @@ export const log = /*#__PURE__*/internal.logWithLevel();
  * output // => ["Fatal: Critical system failure"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -7374,6 +7582,7 @@ export const logFatal = /*#__PURE__*/internal.logWithLevel("Fatal");
  * output // => ["Warn: API rate limit approaching"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -7398,6 +7607,7 @@ export const logWarning = /*#__PURE__*/internal.logWithLevel("Warn");
  * output // => ["Error: Database connection failed"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -7422,6 +7632,7 @@ export const logError = /*#__PURE__*/internal.logWithLevel("Error");
  * output // => ["Info: Application starting up"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -7450,6 +7661,7 @@ export const logInfo = /*#__PURE__*/internal.logWithLevel("Info");
  * output // => ["Debug: Debug mode enabled"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -7478,6 +7690,7 @@ export const logDebug = /*#__PURE__*/internal.logWithLevel("Debug");
  * output // => ["Trace: Entering function processData"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -7508,6 +7721,7 @@ export const logTrace = /*#__PURE__*/internal.logWithLevel("Trace");
  * output // => ["[CUSTOM]: This will go to both default and custom logger"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 4.0.0
  */
@@ -7544,6 +7758,7 @@ export const withLogger = /*#__PURE__*/dual(2, (effect, logger) => internal.upda
  * output // => ["Starting operation", "Starting operation"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -7597,6 +7812,7 @@ export const annotateLogs = /*#__PURE__*/dual(args => isEffect(args[0]), (effect
  *
  * @see {@link annotateLogs} for annotating one effect
  *
+ * @stability stable
  * @category logging
  * @since 3.1.0
  */
@@ -7633,6 +7849,7 @@ export const annotateLogsScoped = internal.annotateLogsScoped;
  * output // => ["Making HTTP request", "Connecting to database", "Executing query", "Processing results", "Sending response", "data"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -7686,6 +7903,7 @@ export const withLogSpan = /*#__PURE__*/dual(2, (effect, label) => internal.flat
  * Effect.runSync(Metric.value(exitTracker)).occurrences.get("success") // => 1
  * ```
  *
+ * @stability stable
  * @category metrics
  * @since 4.0.0
  */
@@ -7735,6 +7953,7 @@ export const track = /*#__PURE__*/dual(args => isEffect(args[0]), (self, metric,
  * Effect.runSync(Metric.value(requestSizeGauge)).value // => 12
  * ```
  *
+ * @stability stable
  * @category metrics
  * @since 4.0.0
  */
@@ -7786,6 +8005,7 @@ export const trackSuccesses = /*#__PURE__*/dual(args => isEffect(args[0]), (self
  * Effect.runSync(Metric.value(errorTypeFrequency)).occurrences.get("ConnectionFailedError") // => 1
  * ```
  *
+ * @stability stable
  * @category metrics
  * @since 4.0.0
  */
@@ -7838,6 +8058,7 @@ export const trackErrors = /*#__PURE__*/dual(args => isEffect(args[0]), (self, m
  * Effect.runSync(Metric.value(defectTypeFrequency)).occurrences.get("Error") // => 1
  * ```
  *
+ * @stability stable
  * @category metrics
  * @since 4.0.0
  */
@@ -7886,6 +8107,7 @@ export const trackDefects = /*#__PURE__*/dual(args => isEffect(args[0]), (self,
  * Effect.runSync(Metric.value(durationGauge)).value // => 1
  * ```
  *
+ * @stability stable
  * @category metrics
  * @since 4.0.0
  */
@@ -7928,6 +8150,7 @@ export const trackDuration = /*#__PURE__*/dual(args => isEffect(args[0]), (self,
  * Effect.runSync(runnable) // => "Transaction complete"
  * ```
  *
+ * @stability stable
  * @category transactions
  * @since 4.0.0
  */
@@ -7975,12 +8198,13 @@ export class Transaction extends /*#__PURE__*/Context.Service()("effect/Effect/T
  * output // => ["Transaction sum: 30", "Final ref1: 10", "Final ref2: 20"]
  * ```
  *
+ * @stability stable
  * @category transactions
  * @since 4.0.0
  */
 export const tx = effect => withFiber(fiber => {
   let state = Context.getOrUndefined(fiber.context, Transaction);
-  if (state) {
+  if (state && !completedTransactions.has(state)) {
     return effect;
   }
   // Create transaction state only at the outermost boundary
@@ -7991,8 +8215,11 @@ export const tx = effect => withFiber(fiber => {
   let result;
   return uninterruptibleMask(restore => flatMap(whileLoop({
     while: () => !result,
-    body: constant(restore(effect).pipe(provideService(Transaction, state), tapCause(() => {
+    body: constant(restore(effect).pipe(provideService(Transaction, state), tapCause(cause => {
       if (!state.retry) return void_;
+      // txRetry interrupts the body; any other reason in the cause is a real failure.
+      // Roll back now so the step below fails instead of waiting or rerunning.
+      if (!internal.hasInterruptsOnly(cause)) return sync(() => clearTransaction(state));
       return restore(awaitPendingTransaction(state));
     }), exit)),
     step(exit) {
@@ -8001,13 +8228,16 @@ export const tx = effect => withFiber(fiber => {
       }
       if (Exit.isSuccess(exit)) {
         commitTransaction(fiber, state);
-      } else {
-        clearTransaction(state);
       }
+      clearTransaction(state);
+      completedTransactions.add(state);
       result = exit;
     }
   }), () => result));
 });
+// Child fibers inherit the boundary's state, so mark it completed once the
+// boundary finishes and let later `tx` calls start a fresh boundary.
+const completedTransactions = /*#__PURE__*/new WeakSet();
 const isTransactionConsistent = state => {
   for (const [ref, {
     version
@@ -8094,6 +8324,7 @@ function clearTransaction(state) {
  * await Effect.runPromise(program) // => 1
  * ```
  *
+ * @stability stable
  * @category transactions
  * @since 4.0.0
  */
@@ -8150,6 +8381,7 @@ export const txRetry = /*#__PURE__*/flatMap(Transaction, state => {
  * error.message // => "Failed to process hello: unavailable"
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 4.0.0
  */
@@ -8157,7 +8389,7 @@ export const effectify = (fn, onError, onSyncError) => (...args) => callback(res
   try {
     fn(...args, (err, result) => {
       if (err) {
-        resume(fail(onError ? onError(err, args) : err));
+        resume(onError ? suspend(() => fail(onError(err, args))) : fail(err));
       } else {
         resume(succeed(result));
       }
@@ -8195,6 +8427,7 @@ export const effectify = (fn, onError, onSyncError) => (...args) => callback(res
  * // Type 'string' is not assignable to type 'number'
  * ```
  *
+ * @stability stable
  * @category utility types
  * @since 4.0.0
  */
@@ -8227,6 +8460,7 @@ export const satisfiesSuccessType = () => effect => effect;
  * // Type 'string' is not assignable to type 'ValidationError'
  * ```
  *
+ * @stability stable
  * @category utility types
  * @since 4.0.0
  */
@@ -8256,6 +8490,7 @@ export const satisfiesErrorType = () => effect => effect;
  * // const constrainedInvalid = satisfiesStringServices(invalidEffect)
  * ```
  *
+ * @stability stable
  * @category utility types
  * @since 4.0.0
  */
@@ -8289,6 +8524,7 @@ export const satisfiesServicesType = () => effect => effect;
  * await Effect.runPromise(Effect.all([mapped, mappedPending])) // => [10, 10]
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 4.0.0
  */
@@ -8332,6 +8568,7 @@ export const mapEager = internal.mapEager;
  * output // => [['mapped: original error', 'mapped: error']]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -8374,6 +8611,7 @@ export const mapErrorEager = internal.mapErrorEager;
  * output // => [10, "Failed: error"]
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 4.0.0
  */
@@ -8411,6 +8649,7 @@ export const mapBothEager = internal.mapBothEager;
  * await Effect.runPromise(Effect.all([flatMapped, flatMappedPending])) // => [10, 10]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -8464,6 +8703,7 @@ export const flatMapEager = internal.flatMapEager;
  * output // => [['recovered from: original error', 42, 'recovered from: error']]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -8491,6 +8731,7 @@ export const catchEager = internal.catchEager;
  * Effect.runSync(effect) // => "computed eagerly"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */