effect 4.0.0-beta.102 → 4.0.0-beta.103

package/dist/Cause.js

@@ -31,11 +31,11 @@ export const ReasonTypeId = core.CauseReasonTypeId;
  *
  * **Example** (Checking the runtime type)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * console.log(Cause.isCause(Cause.fail("error"))) // true
- * console.log(Cause.isCause("not a cause")) // false
+ * Cause.isCause(Cause.fail("error")) // => true
+ * Cause.isCause("not a cause") // => false
  * ```
  *
  * @category guards
@@ -47,12 +47,12 @@ export const isCause = core.isCause;
  *
  * **Example** (Checking the runtime type)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
  * const reason = Cause.fail("error").reasons[0]
- * console.log(Cause.isReason(reason)) // true
- * console.log(Cause.isReason("not a reason")) // false
+ * Cause.isReason(reason) // => true
+ * Cause.isReason("not a reason") // => false
  * ```
  *
  * @category guards
@@ -69,12 +69,12 @@ export const isReason = core.isCauseReason;
  *
  * **Example** (Filtering fail reasons)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
  * const cause = Cause.fail("error")
  * const fails = cause.reasons.filter(Cause.isFailReason)
- * console.log(fails[0].error) // "error"
+ * fails[0].error // => "error"
  * ```
  *
  * @see {@link isDieReason} — narrow to `Die`
@@ -94,12 +94,12 @@ export const isFailReason = core.isFailReason;
  *
  * **Example** (Filtering die reasons)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
  * const cause = Cause.die("defect")
  * const dies = cause.reasons.filter(Cause.isDieReason)
- * console.log(dies[0].defect) // "defect"
+ * dies[0].defect // => "defect"
  * ```
  *
  * @see {@link isFailReason} — narrow to `Fail`
@@ -119,12 +119,12 @@ export const isDieReason = core.isDieReason;
  *
  * **Example** (Filtering interrupt reasons)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
  * const cause = Cause.interrupt(123)
  * const interrupts = cause.reasons.filter(Cause.isInterruptReason)
- * console.log(interrupts[0].fiberId) // 123
+ * interrupts[0].fiberId // => 123
  * ```
  *
  * @see {@link isFailReason} — narrow to `Fail`
@@ -155,15 +155,14 @@ export const isInterruptReason = core.isInterruptReason;
  *
  * **Example** (Building a cause from reasons)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
  * const reasons = [
  *   Cause.makeFailReason("err1"),
  *   Cause.makeFailReason("err2")
  * ]
- * const cause = Cause.fromReasons(reasons)
- * console.log(cause.reasons.length) // 2
+ * Cause.fromReasons(reasons) // => Cause.combine(Cause.fail("err1"), Cause.fail("err2"))
  * ```
  *
  * @see {@link combine} — merge two existing causes
@@ -187,13 +186,10 @@ export const fromReasons = core.causeFromReasons;
  *
  * **Example** (Combining with the empty cause)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * const cause = Cause.combine(Cause.empty, Cause.fail("boom"))
- *
- * console.log(cause.reasons.length) // 1
- * console.log(Cause.hasFails(cause)) // true
+ * Cause.combine(Cause.empty, Cause.fail("boom")) // => Cause.fail("boom")
  * ```
  *
  * @see {@link combine} for merging causes where `empty` acts as the identity
@@ -212,12 +208,10 @@ export const empty = core.causeEmpty;
  *
  * **Example** (Creating a fail cause)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * const cause = Cause.fail("Something went wrong")
- * console.log(cause.reasons.length) // 1
- * console.log(Cause.isFailReason(cause.reasons[0])) // true
+ * Cause.fail("Something went wrong") // => Cause.fromReasons([Cause.makeFailReason("Something went wrong")])
  * ```
  *
  * @see {@link die} — for untyped defects
@@ -237,12 +231,10 @@ export const fail = core.causeFail;
  *
  * **Example** (Creating a die cause)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * const cause = Cause.die("Unexpected")
- * console.log(cause.reasons.length) // 1
- * console.log(Cause.isDieReason(cause.reasons[0])) // true
+ * Cause.die("Unexpected") // => Cause.fromReasons([Cause.makeDieReason("Unexpected")])
  * ```
  *
  * @see {@link fail} — for typed errors
@@ -258,12 +250,10 @@ export const die = core.causeDie;
  *
  * **Example** (Creating an interrupt cause)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * const cause = Cause.interrupt(123)
- * console.log(cause.reasons.length) // 1
- * console.log(Cause.isInterruptReason(cause.reasons[0])) // true
+ * Cause.interrupt(123) // => Cause.fromReasons([Cause.makeInterruptReason(123)])
  * ```
  *
  * @see {@link fail} — for typed errors
@@ -283,12 +273,10 @@ export const interrupt = effect.causeInterrupt;
  *
  * **Example** (Creating a Fail reason)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * const reason = Cause.makeFailReason("error")
- * console.log(reason._tag) // "Fail"
- * console.log(reason.error) // "error"
+ * Cause.makeFailReason("error") // => Cause.fail("error").reasons[0]
  * ```
  *
  * @see {@link makeDieReason} — create a `Die` reason
@@ -308,12 +296,10 @@ export const makeFailReason = error => new core.Fail(error);
  *
  * **Example** (Creating a Die reason)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * const reason = Cause.makeDieReason("bug")
- * console.log(reason._tag) // "Die"
- * console.log(reason.defect) // "bug"
+ * Cause.makeDieReason("bug") // => Cause.die("bug").reasons[0]
  * ```
  *
  * @see {@link makeFailReason} — create a `Fail` reason
@@ -334,12 +320,10 @@ export const makeDieReason = defect => new core.Die(defect);
  *
  * **Example** (Creating an Interrupt reason)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * const reason = Cause.makeInterruptReason(42)
- * console.log(reason._tag) // "Interrupt"
- * console.log(reason.fiberId) // 42
+ * Cause.makeInterruptReason(42) // => Cause.interrupt(42).reasons[0]
  * ```
  *
  * @see {@link makeFailReason} — create a `Fail` reason
@@ -359,12 +343,12 @@ export const makeInterruptReason = effect.makeInterruptReason;
  *
  * **Example** (Checking interrupt-only causes)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * console.log(Cause.hasInterruptsOnly(Cause.interrupt(123))) // true
- * console.log(Cause.hasInterruptsOnly(Cause.fail("error")))  // false
- * console.log(Cause.hasInterruptsOnly(Cause.empty))          // false
+ * Cause.hasInterruptsOnly(Cause.interrupt(123)) // => true
+ * Cause.hasInterruptsOnly(Cause.fail("error")) // => false
+ * Cause.hasInterruptsOnly(Cause.empty) // => false
  * ```
  *
  * @see {@link hasInterrupts} — `true` if the cause contains *any* interrupts
@@ -391,14 +375,14 @@ export const hasInterruptsOnly = effect.hasInterruptsOnly;
  *
  * **Example** (Mapping errors to uppercase)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
  * const cause = Cause.fail("error")
  * const mapped = Cause.map(cause, (e) => e.toUpperCase())
  * const reason = mapped.reasons[0]
  * if (Cause.isFailReason(reason)) {
- *   console.log(reason.error) // "ERROR"
+ *   reason.error // => "ERROR"
  * }
  * ```
  *
@@ -422,13 +406,11 @@ export const map = effect.causeMap;
  *
  * **Example** (Combining two causes)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * const cause1 = Cause.fail("error1")
- * const cause2 = Cause.fail("error2")
- * const combined = Cause.combine(cause1, cause2)
- * console.log(combined.reasons.length) // 2
+ * const combined = Cause.combine(Cause.fail("error1"), Cause.fail("error2"))
+ * combined // => Cause.fromReasons([Cause.makeFailReason("error1"), Cause.makeFailReason("error2")])
  * ```
  *
  * @see {@link fromReasons} — build a cause from an array of reasons
@@ -464,11 +446,11 @@ export const combine = effect.causeCombine;
  *
  * **Example** (Squashing a cause)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * console.log(Cause.squash(Cause.fail("error")))    // "error"
- * console.log(Cause.squash(Cause.die("defect")))    // "defect"
+ * Cause.squash(Cause.fail("error")) // => "error"
+ * Cause.squash(Cause.die("defect")) // => "defect"
  * ```
  *
  * @see {@link prettyErrors} — non-lossy conversion to `Array<Error>`
@@ -488,11 +470,11 @@ export const squash = effect.causeSquash;
  *
  * **Example** (Checking for typed errors)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * console.log(Cause.hasFails(Cause.fail("error"))) // true
- * console.log(Cause.hasFails(Cause.die("defect"))) // false
+ * Cause.hasFails(Cause.fail("error")) // => true
+ * Cause.hasFails(Cause.die("defect")) // => false
  * ```
  *
  * @see {@link hasDies} — check for defects
@@ -515,13 +497,10 @@ export const hasFails = effect.hasFails;
  *
  * **Example** (Extracting the first Fail reason)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause, Result } from "effect"
  *
- * const result = Cause.findFail(Cause.fail("error"))
- * if (!Result.isFailure(result)) {
- *   console.log(result.success.error) // "error"
- * }
+ * Cause.findFail(Cause.fail("error")) // => Result.succeed(Cause.makeFailReason("error"))
  * ```
  *
  * @see {@link findError} — extract the unwrapped `E` value
@@ -544,13 +523,10 @@ export const findFail = effect.findFail;
  *
  * **Example** (Extracting the first error value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause, Result } from "effect"
  *
- * const result = Cause.findError(Cause.fail("error"))
- * if (!Result.isFailure(result)) {
- *   console.log(result.success) // "error"
- * }
+ * Cause.findError(Cause.fail("error")) // => Result.succeed("error")
  * ```
  *
  * @see {@link findFail} — extract the full `Fail` reason
@@ -571,14 +547,11 @@ export const findError = effect.findError;
  *
  * **Example** (Extracting an error as Option)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause, Option } from "effect"
  *
- * const some = Cause.findErrorOption(Cause.fail("error"))
- * console.log(Option.isSome(some)) // true
- *
- * const none = Cause.findErrorOption(Cause.die("defect"))
- * console.log(Option.isNone(none)) // true
+ * Cause.findErrorOption(Cause.fail("error")) // => Option.some("error")
+ * Cause.findErrorOption(Cause.die("defect")) // => Option.none()
  * ```
  *
  * @see {@link findError} — `Result`-based variant
@@ -597,11 +570,11 @@ export const findErrorOption = effect.findErrorOption;
  *
  * **Example** (Checking for defects)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * console.log(Cause.hasDies(Cause.die("defect"))) // true
- * console.log(Cause.hasDies(Cause.fail("error"))) // false
+ * Cause.hasDies(Cause.die("defect")) // => true
+ * Cause.hasDies(Cause.fail("error")) // => false
  * ```
  *
  * @see {@link hasFails} — check for typed errors
@@ -623,13 +596,10 @@ export const hasDies = effect.hasDies;
  *
  * **Example** (Extracting the first Die reason)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause, Result } from "effect"
  *
- * const result = Cause.findDie(Cause.die("defect"))
- * if (!Result.isFailure(result)) {
- *   console.log(result.success.defect) // "defect"
- * }
+ * Cause.findDie(Cause.die("defect")) // => Result.succeed(Cause.makeDieReason("defect"))
  * ```
  *
  * @see {@link findDefect} — extract the unwrapped defect value
@@ -651,13 +621,10 @@ export const findDie = effect.findDie;
  *
  * **Example** (Extracting the first defect)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause, Result } from "effect"
  *
- * const result = Cause.findDefect(Cause.die("defect"))
- * if (!Result.isFailure(result)) {
- *   console.log(result.success) // "defect"
- * }
+ * Cause.findDefect(Cause.die("defect")) // => Result.succeed("defect")
  * ```
  *
  * @see {@link findDie} — extract the full `Die` reason
@@ -672,11 +639,11 @@ export const findDefect = effect.findDefect;
  *
  * **Example** (Checking for interruptions)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * console.log(Cause.hasInterrupts(Cause.interrupt(123))) // true
- * console.log(Cause.hasInterrupts(Cause.fail("error")))  // false
+ * Cause.hasInterrupts(Cause.interrupt(123)) // => true
+ * Cause.hasInterrupts(Cause.fail("error")) // => false
  * ```
  *
  * @see {@link hasInterruptsOnly} — `true` only when *all* reasons are interrupts
@@ -699,13 +666,10 @@ export const hasInterrupts = effect.hasInterrupts;
  *
  * **Example** (Extracting the first interrupt)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause, Result } from "effect"
  *
- * const result = Cause.findInterrupt(Cause.interrupt(42))
- * if (!Result.isFailure(result)) {
- *   console.log(result.success.fiberId) // 42
- * }
+ * Cause.findInterrupt(Cause.interrupt(42)) // => Result.succeed(Cause.makeInterruptReason(42))
  * ```
  *
  * @see {@link interruptors} — collect all interrupting fiber IDs as a `Set`
@@ -726,7 +690,7 @@ export const findInterrupt = effect.findInterrupt;
  *
  * **Example** (Collecting interruptors)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
  * const cause = Cause.combine(
@@ -734,12 +698,12 @@ export const findInterrupt = effect.findInterrupt;
  *   Cause.interrupt(2)
  * )
  *
- * console.log(Cause.interruptors(cause)) // Set(2) { 1, 2 }
+ * Cause.interruptors(cause) // => new Set([1, 2])
  * ```
  *
  * @see {@link filterInterruptors} — `Result`-based variant
  *
- * @category accessors
+ * @category getters
  * @since 2.0.0
  */
 export const interruptors = effect.causeInterruptors;
@@ -761,13 +725,10 @@ export const interruptors = effect.causeInterruptors;
  *
  * **Example** (Extracting interruptors with Result)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause, Result } from "effect"
  *
- * const result = Cause.filterInterruptors(Cause.interrupt(1))
- * if (!Result.isFailure(result)) {
- *   console.log(result.success) // Set(1) { 1 }
- * }
+ * Cause.filterInterruptors(Cause.interrupt(1)) // => Result.succeed(new Set([1]))
  * ```
  *
  * @see {@link interruptors} — always-succeeding variant
@@ -805,18 +766,16 @@ export const filterInterruptors = effect.causeFilterInterruptors;
  *
  * **Example** (Converting a cause to errors)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * const cause = Cause.fail(new Error("boom"))
- * const errors = Cause.prettyErrors(cause)
- * console.log(errors[0].message) // "boom"
+ * Cause.prettyErrors(Cause.fail(new Error("boom")))[0].message // => "boom"
  * ```
  *
  * @see {@link pretty} — renders the cause as a single string
  * @see {@link squash} — lossy collapse to a single thrown value
  *
- * @category rendering
+ * @category formatting
  * @since 3.2.0
  */
 export const prettyErrors = effect.causePrettyErrors;
@@ -852,16 +811,15 @@ export const prettyErrors = effect.causePrettyErrors;
  *
  * **Example** (Rendering a cause)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * const rendered = Cause.pretty(Cause.fail("something went wrong"))
- * console.log(rendered.includes("something went wrong")) // true
+ * Cause.pretty(Cause.fail("something went wrong")).includes("something went wrong") // => true
  * ```
  *
  * @see {@link prettyErrors} — get the individual `Error` instances
  *
- * @category rendering
+ * @category formatting
  * @since 2.0.0
  */
 export const pretty = effect.causePretty;
@@ -870,11 +828,11 @@ export const pretty = effect.causePretty;
  *
  * **Example** (Checking the runtime type)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * console.log(Cause.isNoSuchElementError(new Cause.NoSuchElementError())) // true
- * console.log(Cause.isNoSuchElementError("nope")) // false
+ * Cause.isNoSuchElementError(new Cause.NoSuchElementError()) // => true
+ * Cause.isNoSuchElementError("nope") // => false
  * ```
  *
  * @category guards
@@ -898,11 +856,10 @@ export const NoSuchElementErrorTypeId = core.NoSuchElementErrorTypeId;
  *
  * **Example** (Creating a NoSuchElementError)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * const error = new Cause.NoSuchElementError("Element not found")
- * console.log(error.message) // "Element not found"
+ * new Cause.NoSuchElementError("Element not found").message // => "Element not found"
  * ```
  *
  * @see {@link isNoSuchElementError} for checking unknown values
@@ -916,11 +873,11 @@ export const NoSuchElementError = core.NoSuchElementError;
  *
  * **Example** (Checking the runtime type)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * console.log(Cause.isDone(Cause.Done())) // true
- * console.log(Cause.isDone("not done"))   // false
+ * Cause.isDone(Cause.Done()) // => true
+ * Cause.isDone("not done") // => false
  * ```
  *
  * @category guards
@@ -957,14 +914,12 @@ export const Done = core.Done;
  *
  * **Example** (Failing with Done)
  *
- * ```ts
- * import { Cause, Effect } from "effect"
+ * ```ts import.meta.vitest
+ * import { Cause, Effect, Exit } from "effect"
  *
  * const program = Cause.done("finished")
  *
- * Effect.runPromiseExit(program).then((exit) => {
- *   console.log(exit._tag) // "Failure"
- * })
+ * await Effect.runPromiseExit(program) // => Exit.fail(Cause.Done("finished"))
  * ```
  *
  * @see {@link Done} — create the signal value without an Effect
@@ -985,11 +940,11 @@ export const TimeoutErrorTypeId = effect.TimeoutErrorTypeId;
  *
  * **Example** (Checking the runtime type)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * console.log(Cause.isTimeoutError(new Cause.TimeoutError())) // true
- * console.log(Cause.isTimeoutError("nope")) // false
+ * Cause.isTimeoutError(new Cause.TimeoutError()) // => true
+ * Cause.isTimeoutError("nope") // => false
  * ```
  *
  * @category guards
@@ -1001,11 +956,10 @@ export const isTimeoutError = effect.isTimeoutError;
  *
  * **Example** (Creating a TimeoutError)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * const error = new Cause.TimeoutError("Operation timed out")
- * console.log(error.message) // "Operation timed out"
+ * new Cause.TimeoutError("Operation timed out").message // => "Operation timed out"
  * ```
  *
  * @category constructors
@@ -1024,11 +978,11 @@ export const IllegalArgumentErrorTypeId = effect.IllegalArgumentErrorTypeId;
  *
  * **Example** (Checking the runtime type)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * console.log(Cause.isIllegalArgumentError(new Cause.IllegalArgumentError())) // true
- * console.log(Cause.isIllegalArgumentError("nope")) // false
+ * Cause.isIllegalArgumentError(new Cause.IllegalArgumentError()) // => true
+ * Cause.isIllegalArgumentError("nope") // => false
  * ```
  *
  * @category guards
@@ -1040,11 +994,10 @@ export const isIllegalArgumentError = effect.isIllegalArgumentError;
  *
  * **Example** (Creating an IllegalArgumentError)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * const error = new Cause.IllegalArgumentError("Invalid argument")
- * console.log(error.message) // "Invalid argument"
+ * new Cause.IllegalArgumentError("Invalid argument").message // => "Invalid argument"
  * ```
  *
  * @category constructors
@@ -1056,11 +1009,11 @@ export const IllegalArgumentError = effect.IllegalArgumentError;
  *
  * **Example** (Checking the runtime type)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * console.log(Cause.isExceededCapacityError(new Cause.ExceededCapacityError())) // true
- * console.log(Cause.isExceededCapacityError("nope")) // false
+ * Cause.isExceededCapacityError(new Cause.ExceededCapacityError()) // => true
+ * Cause.isExceededCapacityError("nope") // => false
  * ```
  *
  * @category guards
@@ -1083,11 +1036,10 @@ export const ExceededCapacityErrorTypeId = effect.ExceededCapacityErrorTypeId;
  *
  * **Example** (Creating an ExceededCapacityError)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * const error = new Cause.ExceededCapacityError("Queue full")
- * console.log(error.message) // "Queue full"
+ * new Cause.ExceededCapacityError("Queue full").message // => "Queue full"
  * ```
  *
  * @see {@link isExceededCapacityError} for checking unknown values
@@ -1109,15 +1061,14 @@ export const AsyncFiberErrorTypeId = effect.AsyncFiberErrorTypeId;
  *
  * **Example** (Checking the runtime type)
  *
- * ```ts
- * import { Cause } from "effect"
- * import type { Fiber } from "effect"
+ * ```ts import.meta.vitest
+ * import { Cause, Effect } from "effect"
  *
- * declare const fiber: Fiber.Fiber<unknown, unknown>
+ * const fiber = Effect.runFork(Effect.void)
  *
  * const error = new Cause.AsyncFiberError(fiber)
- * console.log(Cause.isAsyncFiberError(error)) // true
- * console.log(Cause.isAsyncFiberError("nope")) // false
+ * Cause.isAsyncFiberError(error) // => true
+ * Cause.isAsyncFiberError("nope") // => false
  * ```
  *
  * @category guards
@@ -1135,14 +1086,12 @@ export const isAsyncFiberError = effect.isAsyncFiberError;
  *
  * **Example** (Creating an AsyncFiberError)
  *
- * ```ts
- * import { Cause } from "effect"
- * import type { Fiber } from "effect"
+ * ```ts import.meta.vitest
+ * import { Cause, Effect } from "effect"
  *
- * declare const fiber: Fiber.Fiber<unknown, unknown>
+ * const fiber = Effect.runFork(Effect.void)
  *
- * const error = new Cause.AsyncFiberError(fiber)
- * console.log(error.message) // "An asynchronous Effect was executed with Effect.runSync"
+ * new Cause.AsyncFiberError(fiber).message // => "An asynchronous Effect was executed with Effect.runSync"
  * ```
  *
  * @see {@link isAsyncFiberError} for checking unknown values
@@ -1163,11 +1112,11 @@ export const UnknownErrorTypeId = effect.UnknownErrorTypeId;
  *
  * **Example** (Checking the runtime type)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * console.log(Cause.isUnknownError(new Cause.UnknownError("x"))) // true
- * console.log(Cause.isUnknownError("nope")) // false
+ * Cause.isUnknownError(new Cause.UnknownError("x")) // => true
+ * Cause.isUnknownError("nope") // => false
  * ```
  *
  * @category guards
@@ -1181,11 +1130,10 @@ export const isUnknownError = effect.isUnknownError;
  *
  * **Example** (Creating an UnknownError)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause } from "effect"
  *
- * const error = new Cause.UnknownError({ raw: true }, "Unexpected value")
- * console.log(error.message) // "Unexpected value"
+ * new Cause.UnknownError({ raw: true }, "Unexpected value").message // => "Unexpected value"
  * ```
  *
  * @category constructors
@@ -1211,15 +1159,13 @@ export const UnknownError = effect.UnknownError;
  *
  * **Example** (Annotating a cause)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause, Context } from "effect"
  *
  * class RequestId extends Context.Service<RequestId, string>()("RequestId") {}
  *
- * const cause = Cause.fail("error")
- * const annotated = Cause.annotate(cause, Context.make(RequestId, "req-1"))
- *
- * console.log(Context.getOrUndefined(Cause.annotations(annotated), RequestId)) // "req-1"
+ * const annotated = Cause.annotate(Cause.fail("error"), Context.make(RequestId, "req-1"))
+ * Context.getOrUndefined(Cause.annotations(annotated), RequestId) // => "req-1"
  * ```
  *
  * @see {@link annotations} for reading merged annotations from a cause
@@ -1239,7 +1185,7 @@ export const annotate = core.causeAnnotate;
  *
  * **Example** (Reading reason annotations)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause, Context } from "effect"
  *
  * class RequestId extends Context.Service<RequestId, string>()("RequestId") {}
@@ -1247,7 +1193,7 @@ export const annotate = core.causeAnnotate;
  * const reason = Cause.makeFailReason("error")
  * const annotated = reason.annotate(Context.make(RequestId, "req-1"))
  *
- * console.log(Context.getOrUndefined(Cause.reasonAnnotations(annotated), RequestId)) // "req-1"
+ * Context.getOrUndefined(Cause.reasonAnnotations(annotated), RequestId) // => "req-1"
  * ```
  *
  * @see {@link annotations} — merged annotations from all reasons in a cause
@@ -1270,7 +1216,7 @@ export const reasonAnnotations = effect.reasonAnnotations;
  *
  * **Example** (Reading merged annotations)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Cause, Context } from "effect"
  *
  * class RequestId extends Context.Service<RequestId, string>()("RequestId") {}
@@ -1280,7 +1226,7 @@ export const reasonAnnotations = effect.reasonAnnotations;
  *   Context.make(RequestId, "req-1")
  * )
  *
- * console.log(Context.getOrUndefined(Cause.annotations(cause), RequestId)) // "req-1"
+ * Context.getOrUndefined(Cause.annotations(cause), RequestId) // => "req-1"
  * ```
  *
  * @see {@link reasonAnnotations} — annotations from a single reason
@@ -1307,7 +1253,7 @@ export const annotations = effect.causeAnnotations;
  * @see {@link annotations} for reading merged annotations from a cause
  * @see {@link InterruptorStackTrace} for the interrupt-specific stack-frame annotation
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export class StackTrace extends /*#__PURE__*/Context.Service()("effect/Cause/StackTrace") {}
@@ -1328,7 +1274,7 @@ export class StackTrace extends /*#__PURE__*/Context.Service()("effect/Cause/Sta
  * @see {@link reasonAnnotations} for reading annotations from a single reason
  * @see {@link annotate} for attaching annotations to a cause
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export class InterruptorStackTrace extends /*#__PURE__*/Context.Service()("effect/Cause/InterruptorStackTrace") {}