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

package/src/Option.ts

@@ -178,17 +178,16 @@ export declare namespace Option {
    *
    * **Example** (Extracting the value type)
    *
-   * ```ts
-   * import type { Option } from "effect"
-   *
-   * declare const myOption: Option.Option<string>
+   * ```ts import.meta.vitest
+   * import { Option } from "effect"
    *
-   * //      ┌─── string
-   * //      ▼
+   * const myOption: Option.Option<string> = Option.some("value")
    * type MyType = Option.Option.Value<typeof myOption>
+   *
+   * const witness: MyType = "value"
    * ```
    *
-   * @category Type-level Utils
+   * @category utility types
    * @since 2.0.0
    */
   export type Value<T extends Option<any>> = [T] extends [Option<infer _A>] ? _A : never
@@ -219,7 +218,7 @@ export interface OptionUnifyIgnore {}
  * Use when defining higher-kinded abstractions that must accept optional-value
  * types as one of their type-lambda inputs.
  *
- * @category type lambdas
+ * @category utility types
  * @since 2.0.0
  */
 export interface OptionTypeLambda extends TypeLambda {
@@ -241,15 +240,12 @@ export interface OptionTypeLambda extends TypeLambda {
  *
  * **Example** (Creating an empty Option)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * //      ┌─── Option<never>
  * //      ▼
- * const noValue = Option.none()
- *
- * console.log(noValue)
- * // Output: { _id: 'Option', _tag: 'None' }
+ * const noValue = Option.none() // => Option.none()
  * ```
  *
  * @see {@link some} for the opposite operation.
@@ -274,15 +270,12 @@ export const none = <A = never>(): Option<A> => option.none
  *
  * **Example** (Wrapping a value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * //      ┌─── Option<number>
  * //      ▼
- * const value = Option.some(1)
- *
- * console.log(value)
- * // Output: { _id: 'Option', _tag: 'Some', value: 1 }
+ * const value = Option.some(1) // => Option.some(1)
  * ```
  *
  * @see {@link none} for the opposite operation.
@@ -307,17 +300,12 @@ export const some: <A>(value: A) => Option<A> = option.some
  *
  * **Example** (Checking if a value is an Option)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.isOption(Option.some(1)))
- * // Output: true
- *
- * console.log(Option.isOption(Option.none()))
- * // Output: true
- *
- * console.log(Option.isOption({}))
- * // Output: false
+ * Option.isOption(Option.some(1)) // => true
+ * Option.isOption(Option.none()) // => true
+ * Option.isOption({}) // => false
  * ```
  *
  * @see {@link isNone} to check for `None` specifically
@@ -341,14 +329,11 @@ export const isOption: (input: unknown) => input is Option<unknown> = option.isO
  *
  * **Example** (Checking for None)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.isNone(Option.some(1)))
- * // Output: false
- *
- * console.log(Option.isNone(Option.none()))
- * // Output: true
+ * Option.isNone(Option.some(1)) // => false
+ * Option.isNone(Option.none()) // => true
  * ```
  *
  * @see {@link isSome} for the opposite check.
@@ -371,14 +356,11 @@ export const isNone: <A>(self: Option<A>) => self is None<A> = option.isNone
  *
  * **Example** (Checking for Some)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.isSome(Option.some(1)))
- * // Output: true
- *
- * console.log(Option.isSome(Option.none()))
- * // Output: false
+ * Option.isSome(Option.some(1)) // => true
+ * Option.isSome(Option.none()) // => false
  * ```
  *
  * @see {@link isNone} for the opposite check.
@@ -404,16 +386,13 @@ export const isSome: <A>(self: Option<A>) => self is Some<A> = option.isSome
  *
  * **Example** (Matching on an Option)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * const message = Option.match(Option.some(1), {
+ * Option.match(Option.some(1), {
  *   onNone: () => "Option is empty",
  *   onSome: (value) => `Option has a value: ${value}`
- * })
- *
- * console.log(message)
- * // Output: "Option has a value: 1"
+ * }) // => "Option has a value: 1"
  * ```
  *
  * @see {@link getOrElse} for unwrapping with a default
@@ -438,16 +417,13 @@ export const match: {
    *
    * **Example** (Matching on an Option)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * const message = Option.match(Option.some(1), {
+   * Option.match(Option.some(1), {
    *   onNone: () => "Option is empty",
    *   onSome: (value) => `Option has a value: ${value}`
-   * })
-   *
-   * console.log(message)
-   * // Output: "Option has a value: 1"
+   * }) // => "Option has a value: 1"
    * ```
    *
    * @see {@link getOrElse} for unwrapping with a default
@@ -477,16 +453,13 @@ export const match: {
    *
    * **Example** (Matching on an Option)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * const message = Option.match(Option.some(1), {
+   * Option.match(Option.some(1), {
    *   onNone: () => "Option is empty",
    *   onSome: (value) => `Option has a value: ${value}`
-   * })
-   *
-   * console.log(message)
-   * // Output: "Option has a value: 1"
+   * }) // => "Option has a value: 1"
    * ```
    *
    * @see {@link getOrElse} for unwrapping with a default
@@ -525,7 +498,7 @@ export const match: {
  *
  * **Example** (Converting a parser to a type guard)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * type MyData = string | number
@@ -537,11 +510,8 @@ export const match: {
  * //      ▼
  * const isString = Option.toRefinement(parseString)
  *
- * console.log(isString("a"))
- * // Output: true
- *
- * console.log(isString(1))
- * // Output: false
+ * isString("a") // => true
+ * isString(1) // => false
  * ```
  *
  * @see {@link liftPredicate} for the reverse direction
@@ -567,14 +537,11 @@ export const toRefinement = <A, B extends A>(f: (a: A) => Option<B>): (a: A) =>
  *
  * **Example** (Getting the first element)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.fromIterable([1, 2, 3]))
- * // Output: { _id: 'Option', _tag: 'Some', value: 1 }
- *
- * console.log(Option.fromIterable([]))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * Option.fromIterable([1, 2, 3]) // => Option.some(1)
+ * Option.fromIterable([]) // => Option.none()
  * ```
  *
  * @see {@link toArray} for the inverse direction
@@ -604,14 +571,11 @@ export const fromIterable = <A>(collection: Iterable<A>): Option<A> => {
  *
  * **Example** (Extracting the success side)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option, Result } from "effect"
  *
- * console.log(Option.getSuccess(Result.succeed("ok")))
- * // Output: { _id: 'Option', _tag: 'Some', value: 'ok' }
- *
- * console.log(Option.getSuccess(Result.fail("err")))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * Option.getSuccess(Result.succeed("ok")) // => Option.some("ok")
+ * Option.getSuccess(Result.fail("err")) // => Option.none()
  * ```
  *
  * @see {@link getFailure} for the opposite operation.
@@ -636,14 +600,11 @@ export const getSuccess: <A, E>(self: Result<A, E>) => Option<A> = result.getSuc
  *
  * **Example** (Extracting the failure side)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option, Result } from "effect"
  *
- * console.log(Option.getFailure(Result.succeed("ok")))
- * // Output: { _id: 'Option', _tag: 'None' }
- *
- * console.log(Option.getFailure(Result.fail("err")))
- * // Output: { _id: 'Option', _tag: 'Some', value: 'err' }
+ * Option.getFailure(Result.succeed("ok")) // => Option.none()
+ * Option.getFailure(Result.fail("err")) // => Option.some("err")
  * ```
  *
  * @see {@link getSuccess} for the opposite operation.
@@ -669,14 +630,11 @@ export const getFailure: <A, E>(self: Result<A, E>) => Option<E> = result.getFai
  *
  * **Example** (Unwrapping with a fallback)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.some(1).pipe(Option.getOrElse(() => 0)))
- * // Output: 1
- *
- * console.log(Option.none().pipe(Option.getOrElse(() => 0)))
- * // Output: 0
+ * Option.some(1).pipe(Option.getOrElse(() => 0)) // => 1
+ * Option.none().pipe(Option.getOrElse(() => 0)) // => 0
  * ```
  *
  * @see {@link getOrNull} to fall back to `null`
@@ -703,14 +661,11 @@ export const getOrElse: {
    *
    * **Example** (Unwrapping with a fallback)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * console.log(Option.some(1).pipe(Option.getOrElse(() => 0)))
-   * // Output: 1
-   *
-   * console.log(Option.none().pipe(Option.getOrElse(() => 0)))
-   * // Output: 0
+   * Option.some(1).pipe(Option.getOrElse(() => 0)) // => 1
+   * Option.none().pipe(Option.getOrElse(() => 0)) // => 0
    * ```
    *
    * @see {@link getOrNull} to fall back to `null`
@@ -737,14 +692,11 @@ export const getOrElse: {
    *
    * **Example** (Unwrapping with a fallback)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * console.log(Option.some(1).pipe(Option.getOrElse(() => 0)))
-   * // Output: 1
-   *
-   * console.log(Option.none().pipe(Option.getOrElse(() => 0)))
-   * // Output: 0
+   * Option.some(1).pipe(Option.getOrElse(() => 0)) // => 1
+   * Option.none().pipe(Option.getOrElse(() => 0)) // => 0
    * ```
    *
    * @see {@link getOrNull} to fall back to `null`
@@ -776,14 +728,11 @@ export const getOrElse: {
  *
  * **Example** (Providing a fallback Option)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.none().pipe(Option.orElse(() => Option.some("b"))))
- * // Output: { _id: 'Option', _tag: 'Some', value: 'b' }
- *
- * console.log(Option.some("a").pipe(Option.orElse(() => Option.some("b"))))
- * // Output: { _id: 'Option', _tag: 'Some', value: 'a' }
+ * Option.none().pipe(Option.orElse(() => Option.some("b"))) // => Option.some("b")
+ * Option.some("a").pipe(Option.orElse(() => Option.some("b"))) // => Option.some("a")
  * ```
  *
  * @see {@link orElseSome} to wrap the fallback value in `Some` automatically
@@ -809,14 +758,11 @@ export const orElse: {
    *
    * **Example** (Providing a fallback Option)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * console.log(Option.none().pipe(Option.orElse(() => Option.some("b"))))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'b' }
-   *
-   * console.log(Option.some("a").pipe(Option.orElse(() => Option.some("b"))))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'a' }
+   * Option.none().pipe(Option.orElse(() => Option.some("b"))) // => Option.some("b")
+   * Option.some("a").pipe(Option.orElse(() => Option.some("b"))) // => Option.some("a")
    * ```
    *
    * @see {@link orElseSome} to wrap the fallback value in `Some` automatically
@@ -842,14 +788,11 @@ export const orElse: {
    *
    * **Example** (Providing a fallback Option)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * console.log(Option.none().pipe(Option.orElse(() => Option.some("b"))))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'b' }
-   *
-   * console.log(Option.some("a").pipe(Option.orElse(() => Option.some("b"))))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'a' }
+   * Option.none().pipe(Option.orElse(() => Option.some("b"))) // => Option.some("b")
+   * Option.some("a").pipe(Option.orElse(() => Option.some("b"))) // => Option.some("a")
    * ```
    *
    * @see {@link orElseSome} to wrap the fallback value in `Some` automatically
@@ -879,14 +822,11 @@ export const orElse: {
  *
  * **Example** (Providing a fallback value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.none().pipe(Option.orElseSome(() => "b")))
- * // Output: { _id: 'Option', _tag: 'Some', value: 'b' }
- *
- * console.log(Option.some("a").pipe(Option.orElseSome(() => "b")))
- * // Output: { _id: 'Option', _tag: 'Some', value: 'a' }
+ * Option.none().pipe(Option.orElseSome(() => "b")) // => Option.some("b")
+ * Option.some("a").pipe(Option.orElseSome(() => "b")) // => Option.some("a")
  * ```
  *
  * @see {@link orElse} when the fallback is itself an `Option`
@@ -910,14 +850,11 @@ export const orElseSome: {
    *
    * **Example** (Providing a fallback value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * console.log(Option.none().pipe(Option.orElseSome(() => "b")))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'b' }
-   *
-   * console.log(Option.some("a").pipe(Option.orElseSome(() => "b")))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'a' }
+   * Option.none().pipe(Option.orElseSome(() => "b")) // => Option.some("b")
+   * Option.some("a").pipe(Option.orElseSome(() => "b")) // => Option.some("a")
    * ```
    *
    * @see {@link orElse} when the fallback is itself an `Option`
@@ -941,14 +878,11 @@ export const orElseSome: {
    *
    * **Example** (Providing a fallback value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * console.log(Option.none().pipe(Option.orElseSome(() => "b")))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'b' }
-   *
-   * console.log(Option.some("a").pipe(Option.orElseSome(() => "b")))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'a' }
+   * Option.none().pipe(Option.orElseSome(() => "b")) // => Option.some("b")
+   * Option.some("a").pipe(Option.orElseSome(() => "b")) // => Option.some("a")
    * ```
    *
    * @see {@link orElse} when the fallback is itself an `Option`
@@ -978,14 +912,13 @@ export const orElseSome: {
  *
  * **Example** (Tracking value source)
  *
- * ```ts
- * import { Option } from "effect"
+ * ```ts import.meta.vitest
+ * import { Option, Result } from "effect"
  *
- * console.log(Option.orElseResult(Option.some("primary"), () => Option.some("fallback")))
- * // Output: { _id: 'Option', _tag: 'Some', value: { _tag: 'Failure', value: 'primary' } }
+ * const fallback = () => Option.some("fallback")
  *
- * console.log(Option.orElseResult(Option.none(), () => Option.some("fallback")))
- * // Output: { _id: 'Option', _tag: 'Some', value: { _tag: 'Success', value: 'fallback' } }
+ * Option.orElseResult(Option.some("primary"), fallback) // => Option.some(Result.fail("primary"))
+ * Option.orElseResult(Option.none(), fallback) // => Option.some(Result.succeed("fallback"))
  * ```
  *
  * @see {@link orElse} for the simpler variant without source tracking
@@ -1010,14 +943,13 @@ export const orElseResult: {
    *
    * **Example** (Tracking value source)
    *
-   * ```ts
-   * import { Option } from "effect"
+   * ```ts import.meta.vitest
+   * import { Option, Result } from "effect"
    *
-   * console.log(Option.orElseResult(Option.some("primary"), () => Option.some("fallback")))
-   * // Output: { _id: 'Option', _tag: 'Some', value: { _tag: 'Failure', value: 'primary' } }
+   * const fallback = () => Option.some("fallback")
    *
-   * console.log(Option.orElseResult(Option.none(), () => Option.some("fallback")))
-   * // Output: { _id: 'Option', _tag: 'Some', value: { _tag: 'Success', value: 'fallback' } }
+   * Option.orElseResult(Option.some("primary"), fallback) // => Option.some(Result.fail("primary"))
+   * Option.orElseResult(Option.none(), fallback) // => Option.some(Result.succeed("fallback"))
    * ```
    *
    * @see {@link orElse} for the simpler variant without source tracking
@@ -1042,14 +974,13 @@ export const orElseResult: {
    *
    * **Example** (Tracking value source)
    *
-   * ```ts
-   * import { Option } from "effect"
+   * ```ts import.meta.vitest
+   * import { Option, Result } from "effect"
    *
-   * console.log(Option.orElseResult(Option.some("primary"), () => Option.some("fallback")))
-   * // Output: { _id: 'Option', _tag: 'Some', value: { _tag: 'Failure', value: 'primary' } }
+   * const fallback = () => Option.some("fallback")
    *
-   * console.log(Option.orElseResult(Option.none(), () => Option.some("fallback")))
-   * // Output: { _id: 'Option', _tag: 'Some', value: { _tag: 'Success', value: 'fallback' } }
+   * Option.orElseResult(Option.some("primary"), fallback) // => Option.some(Result.fail("primary"))
+   * Option.orElseResult(Option.none(), fallback) // => Option.some(Result.succeed("fallback"))
    * ```
    *
    * @see {@link orElse} for the simpler variant without source tracking
@@ -1079,15 +1010,14 @@ export const orElseResult: {
  *
  * **Example** (Finding the first Some)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.firstSomeOf([
+ * Option.firstSomeOf([
  *   Option.none(),
  *   Option.some(1),
  *   Option.some(2)
- * ]))
- * // Output: { _id: 'Option', _tag: 'Some', value: 1 }
+ * ]) // => Option.some(1)
  * ```
  *
  * @see {@link orElse} for a two-option fallback
@@ -1122,17 +1052,12 @@ export const firstSomeOf = <T, C extends Iterable<Option<T>> = Iterable<Option<T
  *
  * **Example** (Converting nullable values to an Option)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.fromNullishOr(undefined))
- * // Output: { _id: 'Option', _tag: 'None' }
- *
- * console.log(Option.fromNullishOr(null))
- * // Output: { _id: 'Option', _tag: 'None' }
- *
- * console.log(Option.fromNullishOr(1))
- * // Output: { _id: 'Option', _tag: 'Some', value: 1 }
+ * Option.fromNullishOr(undefined) // => Option.none()
+ * Option.fromNullishOr(null) // => Option.none()
+ * Option.fromNullishOr(1) // => Option.some(1)
  * ```
  *
  * @see {@link fromNullOr} to only treat `null` as absent
@@ -1162,17 +1087,12 @@ export const fromNullishOr = <A>(
  *
  * **Example** (Converting possibly undefined values to an Option)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.fromUndefinedOr(undefined))
- * // Output: { _id: 'Option', _tag: 'None' }
- *
- * console.log(Option.fromUndefinedOr(null))
- * // Output: { _id: 'Option', _tag: 'Some', value: null }
- *
- * console.log(Option.fromUndefinedOr(42))
- * // Output: { _id: 'Option', _tag: 'Some', value: 42 }
+ * Option.fromUndefinedOr(undefined) // => Option.none()
+ * Option.fromUndefinedOr(null) // => Option.some(null)
+ * Option.fromUndefinedOr(42) // => Option.some(42)
  * ```
  *
  * @see {@link fromNullishOr} to treat both `null` and `undefined` as absent
@@ -1201,17 +1121,12 @@ export const fromUndefinedOr = <A>(
  *
  * **Example** (Converting possibly null values to an Option)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.fromNullOr(null))
- * // Output: { _id: 'Option', _tag: 'None' }
- *
- * console.log(Option.fromNullOr(undefined))
- * // Output: { _id: 'Option', _tag: 'Some', value: undefined }
- *
- * console.log(Option.fromNullOr(42))
- * // Output: { _id: 'Option', _tag: 'Some', value: 42 }
+ * Option.fromNullOr(null) // => Option.none()
+ * Option.fromNullOr(undefined) // => Option.some(undefined)
+ * Option.fromNullOr(42) // => Option.some(42)
  * ```
  *
  * @see {@link fromNullishOr} to treat both `null` and `undefined` as absent
@@ -1239,7 +1154,7 @@ export const fromNullOr = <A>(
  *
  * **Example** (Lifting a parser)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * const parse = (s: string): number | undefined => {
@@ -1249,11 +1164,8 @@ export const fromNullOr = <A>(
  *
  * const parseOption = Option.liftNullishOr(parse)
  *
- * console.log(parseOption("1"))
- * // Output: { _id: 'Option', _tag: 'Some', value: 1 }
- *
- * console.log(parseOption("not a number"))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * parseOption("1") // => Option.some(1)
+ * parseOption("not a number") // => Option.none()
  * ```
  *
  * @see {@link fromNullishOr} for converting a single value
@@ -1281,14 +1193,11 @@ export const liftNullishOr = <A extends ReadonlyArray<unknown>, B>(
  *
  * **Example** (Unwrapping to null)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.getOrNull(Option.some(1)))
- * // Output: 1
- *
- * console.log(Option.getOrNull(Option.none()))
- * // Output: null
+ * Option.getOrNull(Option.some(1)) // => 1
+ * Option.getOrNull(Option.none()) // => null
  * ```
  *
  * @see {@link getOrUndefined} to return `undefined` instead
@@ -1314,14 +1223,11 @@ export const getOrNull: <A>(self: Option<A>) => A | null = getOrElse(constNull)
  *
  * **Example** (Unwrapping to undefined)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.getOrUndefined(Option.some(1)))
- * // Output: 1
- *
- * console.log(Option.getOrUndefined(Option.none()))
- * // Output: undefined
+ * Option.getOrUndefined(Option.some(1)) // => 1
+ * Option.getOrUndefined(Option.none()) // => undefined
  * ```
  *
  * @see {@link getOrNull} to return `null` instead
@@ -1346,16 +1252,13 @@ export const getOrUndefined: <A>(self: Option<A>) => A | undefined = getOrElse(c
  *
  * **Example** (Lifting JSON.parse)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * const parse = Option.liftThrowable(JSON.parse)
  *
- * console.log(parse("1"))
- * // Output: { _id: 'Option', _tag: 'Some', value: 1 }
- *
- * console.log(parse(""))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * parse("1") // => Option.some(1)
+ * parse("") // => Option.none()
  * ```
  *
  * @see {@link liftNullishOr} for nullable-returning functions
@@ -1389,14 +1292,16 @@ export const liftThrowable = <A extends ReadonlyArray<unknown>, B>(
  *
  * **Example** (Throwing a custom error)
  *
- * ```ts
- * import { Option } from "effect"
+ * ```ts import.meta.vitest
+ * import { Option, Result } from "effect"
  *
- * console.log(Option.getOrThrowWith(Option.some(1), () => new Error("missing")))
- * // Output: 1
+ * Option.getOrThrowWith(Option.some(1), () => new Error("missing")) // => 1
  *
- * Option.getOrThrowWith(Option.none(), () => new Error("missing"))
- * // throws Error: missing
+ * const failure = Result.try({
+ *   try: () => Option.getOrThrowWith(Option.none(), () => new Error("missing")),
+ *   catch: (error) => (error as Error).message
+ * })
+ * Result.getFailure(failure).pipe(Option.getOrElse(() => "no error")) // => "missing"
  * ```
  *
  * @see {@link getOrThrow} for a version with a default error
@@ -1421,14 +1326,16 @@ export const getOrThrowWith: {
    *
    * **Example** (Throwing a custom error)
    *
-   * ```ts
-   * import { Option } from "effect"
+   * ```ts import.meta.vitest
+   * import { Option, Result } from "effect"
    *
-   * console.log(Option.getOrThrowWith(Option.some(1), () => new Error("missing")))
-   * // Output: 1
+   * Option.getOrThrowWith(Option.some(1), () => new Error("missing")) // => 1
    *
-   * Option.getOrThrowWith(Option.none(), () => new Error("missing"))
-   * // throws Error: missing
+   * const failure = Result.try({
+   *   try: () => Option.getOrThrowWith(Option.none(), () => new Error("missing")),
+   *   catch: (error) => (error as Error).message
+   * })
+   * Result.getFailure(failure).pipe(Option.getOrElse(() => "no error")) // => "missing"
    * ```
    *
    * @see {@link getOrThrow} for a version with a default error
@@ -1453,14 +1360,16 @@ export const getOrThrowWith: {
    *
    * **Example** (Throwing a custom error)
    *
-   * ```ts
-   * import { Option } from "effect"
+   * ```ts import.meta.vitest
+   * import { Option, Result } from "effect"
    *
-   * console.log(Option.getOrThrowWith(Option.some(1), () => new Error("missing")))
-   * // Output: 1
+   * Option.getOrThrowWith(Option.some(1), () => new Error("missing")) // => 1
    *
-   * Option.getOrThrowWith(Option.none(), () => new Error("missing"))
-   * // throws Error: missing
+   * const failure = Result.try({
+   *   try: () => Option.getOrThrowWith(Option.none(), () => new Error("missing")),
+   *   catch: (error) => (error as Error).message
+   * })
+   * Result.getFailure(failure).pipe(Option.getOrElse(() => "no error")) // => "missing"
    * ```
    *
    * @see {@link getOrThrow} for a version with a default error
@@ -1492,14 +1401,16 @@ export const getOrThrowWith: {
  *
  * **Example** (Throwing a default error)
  *
- * ```ts
- * import { Option } from "effect"
+ * ```ts import.meta.vitest
+ * import { Option, Result } from "effect"
  *
- * console.log(Option.getOrThrow(Option.some(1)))
- * // Output: 1
+ * Option.getOrThrow(Option.some(1)) // => 1
  *
- * Option.getOrThrow(Option.none())
- * // throws Error: getOrThrow called on a None
+ * const failure = Result.try({
+ *   try: () => Option.getOrThrow(Option.none()),
+ *   catch: (error) => (error as Error).message
+ * })
+ * Result.getFailure(failure).pipe(Option.getOrElse(() => "no error")) // => "getOrThrow called on a None"
  * ```
  *
  * @see {@link getOrThrowWith} for a custom error
@@ -1526,14 +1437,11 @@ export const getOrThrow: <A>(self: Option<A>) => A = getOrThrowWith(() => new Er
  *
  * **Example** (Mapping over an Option)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.map(Option.some(2), (n) => n * 2))
- * // Output: { _id: 'Option', _tag: 'Some', value: 4 }
- *
- * console.log(Option.map(Option.none(), (n: number) => n * 2))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * Option.map(Option.some(2), (n) => n * 2) // => Option.some(4)
+ * Option.map(Option.none(), (n: number) => n * 2) // => Option.none()
  * ```
  *
  * @see {@link flatMap} when `f` returns an `Option`
@@ -1559,14 +1467,11 @@ export const map: {
    *
    * **Example** (Mapping over an Option)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * console.log(Option.map(Option.some(2), (n) => n * 2))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 4 }
-   *
-   * console.log(Option.map(Option.none(), (n: number) => n * 2))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * Option.map(Option.some(2), (n) => n * 2) // => Option.some(4)
+   * Option.map(Option.none(), (n: number) => n * 2) // => Option.none()
    * ```
    *
    * @see {@link flatMap} when `f` returns an `Option`
@@ -1592,14 +1497,11 @@ export const map: {
    *
    * **Example** (Mapping over an Option)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * console.log(Option.map(Option.some(2), (n) => n * 2))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 4 }
-   *
-   * console.log(Option.map(Option.none(), (n: number) => n * 2))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * Option.map(Option.some(2), (n) => n * 2) // => Option.some(4)
+   * Option.map(Option.none(), (n: number) => n * 2) // => Option.none()
    * ```
    *
    * @see {@link flatMap} when `f` returns an `Option`
@@ -1624,14 +1526,11 @@ export const map: {
  *
  * **Example** (Replacing a value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.as(Option.some(42), "new value"))
- * // Output: { _id: 'Option', _tag: 'Some', value: 'new value' }
- *
- * console.log(Option.as(Option.none(), "new value"))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * Option.as(Option.some(42), "new value") // => Option.some("new value")
+ * Option.as(Option.none(), "new value") // => Option.none()
  * ```
  *
  * @see {@link asVoid} to replace with `undefined`
@@ -1651,14 +1550,11 @@ export const as: {
    *
    * **Example** (Replacing a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * console.log(Option.as(Option.some(42), "new value"))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'new value' }
-   *
-   * console.log(Option.as(Option.none(), "new value"))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * Option.as(Option.some(42), "new value") // => Option.some("new value")
+   * Option.as(Option.none(), "new value") // => Option.none()
    * ```
    *
    * @see {@link asVoid} to replace with `undefined`
@@ -1678,14 +1574,11 @@ export const as: {
    *
    * **Example** (Replacing a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * console.log(Option.as(Option.some(42), "new value"))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'new value' }
-   *
-   * console.log(Option.as(Option.none(), "new value"))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * Option.as(Option.some(42), "new value") // => Option.some("new value")
+   * Option.as(Option.none(), "new value") // => Option.none()
    * ```
    *
    * @see {@link asVoid} to replace with `undefined`
@@ -1708,14 +1601,11 @@ export const as: {
  *
  * **Example** (Voiding the value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.asVoid(Option.some(42)))
- * // Output: { _id: 'Option', _tag: 'Some', value: undefined }
- *
- * console.log(Option.asVoid(Option.none()))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * Option.asVoid(Option.some(42)) // => Option.some(undefined)
+ * Option.asVoid(Option.none()) // => Option.none()
  * ```
  *
  * @see {@link as} to replace with a specific constant
@@ -1736,11 +1626,10 @@ export {
    *
    * **Example** (Referencing Option.void)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * console.log(Option.void)
-   * // Output: { _id: 'Option', _tag: 'Some', value: undefined }
+   * Option.void // => Option.some(undefined)
    * ```
    *
    * @see {@link asVoid} to convert an existing `Option` to `Option<void>`
@@ -1768,7 +1657,7 @@ export {
  *
  * **Example** (Chaining optional lookups)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * interface User {
@@ -1781,12 +1670,9 @@ export {
  *   address: Option.some({ street: Option.some("123 Main St") })
  * }
  *
- * const street = user.address.pipe(
+ * user.address.pipe(
  *   Option.flatMap((addr) => addr.street)
- * )
- *
- * console.log(street)
- * // Output: { _id: 'Option', _tag: 'Some', value: '123 Main St' }
+ * ) // => Option.some("123 Main St")
  * ```
  *
  * @see {@link map} when `f` returns a plain value
@@ -1814,7 +1700,7 @@ export const flatMap: {
    *
    * **Example** (Chaining optional lookups)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * interface User {
@@ -1827,12 +1713,9 @@ export const flatMap: {
    *   address: Option.some({ street: Option.some("123 Main St") })
    * }
    *
-   * const street = user.address.pipe(
+   * user.address.pipe(
    *   Option.flatMap((addr) => addr.street)
-   * )
-   *
-   * console.log(street)
-   * // Output: { _id: 'Option', _tag: 'Some', value: '123 Main St' }
+   * ) // => Option.some("123 Main St")
    * ```
    *
    * @see {@link map} when `f` returns a plain value
@@ -1860,7 +1743,7 @@ export const flatMap: {
    *
    * **Example** (Chaining optional lookups)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * interface User {
@@ -1873,12 +1756,9 @@ export const flatMap: {
    *   address: Option.some({ street: Option.some("123 Main St") })
    * }
    *
-   * const street = user.address.pipe(
+   * user.address.pipe(
    *   Option.flatMap((addr) => addr.street)
-   * )
-   *
-   * console.log(street)
-   * // Output: { _id: 'Option', _tag: 'Some', value: '123 Main St' }
+   * ) // => Option.some("123 Main St")
    * ```
    *
    * @see {@link map} when `f` returns a plain value
@@ -1912,20 +1792,17 @@ export const flatMap: {
  *
  * **Example** (Chaining with andThen)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * // Chain with a function returning Option
- * console.log(Option.andThen(Option.some(5), (x) => Option.some(x * 2)))
- * // Output: { _id: 'Option', _tag: 'Some', value: 10 }
+ * Option.andThen(Option.some(5), (x) => Option.some(x * 2)) // => Option.some(10)
  *
  * // Chain with a static value
- * console.log(Option.andThen(Option.some(5), "hello"))
- * // Output: { _id: 'Option', _tag: 'Some', value: "hello" }
+ * Option.andThen(Option.some(5), "hello") // => Option.some("hello")
  *
  * // Chain with None - skips
- * console.log(Option.andThen(Option.none(), (x) => Option.some(x * 2)))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * Option.andThen(Option.none(), (x) => Option.some(x * 2)) // => Option.none()
  * ```
  *
  * @see {@link flatMap} for the standard monadic bind
@@ -1953,20 +1830,17 @@ export const andThen: {
    *
    * **Example** (Chaining with andThen)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * // Chain with a function returning Option
-   * console.log(Option.andThen(Option.some(5), (x) => Option.some(x * 2)))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 10 }
+   * Option.andThen(Option.some(5), (x) => Option.some(x * 2)) // => Option.some(10)
    *
    * // Chain with a static value
-   * console.log(Option.andThen(Option.some(5), "hello"))
-   * // Output: { _id: 'Option', _tag: 'Some', value: "hello" }
+   * Option.andThen(Option.some(5), "hello") // => Option.some("hello")
    *
    * // Chain with None - skips
-   * console.log(Option.andThen(Option.none(), (x) => Option.some(x * 2)))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * Option.andThen(Option.none(), (x) => Option.some(x * 2)) // => Option.none()
    * ```
    *
    * @see {@link flatMap} for the standard monadic bind
@@ -1994,20 +1868,17 @@ export const andThen: {
    *
    * **Example** (Chaining with andThen)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * // Chain with a function returning Option
-   * console.log(Option.andThen(Option.some(5), (x) => Option.some(x * 2)))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 10 }
+   * Option.andThen(Option.some(5), (x) => Option.some(x * 2)) // => Option.some(10)
    *
    * // Chain with a static value
-   * console.log(Option.andThen(Option.some(5), "hello"))
-   * // Output: { _id: 'Option', _tag: 'Some', value: "hello" }
+   * Option.andThen(Option.some(5), "hello") // => Option.some("hello")
    *
    * // Chain with None - skips
-   * console.log(Option.andThen(Option.none(), (x) => Option.some(x * 2)))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * Option.andThen(Option.none(), (x) => Option.some(x * 2)) // => Option.none()
    * ```
    *
    * @see {@link flatMap} for the standard monadic bind
@@ -2035,20 +1906,17 @@ export const andThen: {
    *
    * **Example** (Chaining with andThen)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * // Chain with a function returning Option
-   * console.log(Option.andThen(Option.some(5), (x) => Option.some(x * 2)))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 10 }
+   * Option.andThen(Option.some(5), (x) => Option.some(x * 2)) // => Option.some(10)
    *
    * // Chain with a static value
-   * console.log(Option.andThen(Option.some(5), "hello"))
-   * // Output: { _id: 'Option', _tag: 'Some', value: "hello" }
+   * Option.andThen(Option.some(5), "hello") // => Option.some("hello")
    *
    * // Chain with None - skips
-   * console.log(Option.andThen(Option.none(), (x) => Option.some(x * 2)))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * Option.andThen(Option.none(), (x) => Option.some(x * 2)) // => Option.none()
    * ```
    *
    * @see {@link flatMap} for the standard monadic bind
@@ -2076,20 +1944,17 @@ export const andThen: {
    *
    * **Example** (Chaining with andThen)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * // Chain with a function returning Option
-   * console.log(Option.andThen(Option.some(5), (x) => Option.some(x * 2)))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 10 }
+   * Option.andThen(Option.some(5), (x) => Option.some(x * 2)) // => Option.some(10)
    *
    * // Chain with a static value
-   * console.log(Option.andThen(Option.some(5), "hello"))
-   * // Output: { _id: 'Option', _tag: 'Some', value: "hello" }
+   * Option.andThen(Option.some(5), "hello") // => Option.some("hello")
    *
    * // Chain with None - skips
-   * console.log(Option.andThen(Option.none(), (x) => Option.some(x * 2)))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * Option.andThen(Option.none(), (x) => Option.some(x * 2)) // => Option.none()
    * ```
    *
    * @see {@link flatMap} for the standard monadic bind
@@ -2117,20 +1982,17 @@ export const andThen: {
    *
    * **Example** (Chaining with andThen)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * // Chain with a function returning Option
-   * console.log(Option.andThen(Option.some(5), (x) => Option.some(x * 2)))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 10 }
+   * Option.andThen(Option.some(5), (x) => Option.some(x * 2)) // => Option.some(10)
    *
    * // Chain with a static value
-   * console.log(Option.andThen(Option.some(5), "hello"))
-   * // Output: { _id: 'Option', _tag: 'Some', value: "hello" }
+   * Option.andThen(Option.some(5), "hello") // => Option.some("hello")
    *
    * // Chain with None - skips
-   * console.log(Option.andThen(Option.none(), (x) => Option.some(x * 2)))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * Option.andThen(Option.none(), (x) => Option.some(x * 2)) // => Option.none()
    * ```
    *
    * @see {@link flatMap} for the standard monadic bind
@@ -2158,20 +2020,17 @@ export const andThen: {
    *
    * **Example** (Chaining with andThen)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * // Chain with a function returning Option
-   * console.log(Option.andThen(Option.some(5), (x) => Option.some(x * 2)))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 10 }
+   * Option.andThen(Option.some(5), (x) => Option.some(x * 2)) // => Option.some(10)
    *
    * // Chain with a static value
-   * console.log(Option.andThen(Option.some(5), "hello"))
-   * // Output: { _id: 'Option', _tag: 'Some', value: "hello" }
+   * Option.andThen(Option.some(5), "hello") // => Option.some("hello")
    *
    * // Chain with None - skips
-   * console.log(Option.andThen(Option.none(), (x) => Option.some(x * 2)))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * Option.andThen(Option.none(), (x) => Option.some(x * 2)) // => Option.none()
    * ```
    *
    * @see {@link flatMap} for the standard monadic bind
@@ -2199,20 +2058,17 @@ export const andThen: {
    *
    * **Example** (Chaining with andThen)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * // Chain with a function returning Option
-   * console.log(Option.andThen(Option.some(5), (x) => Option.some(x * 2)))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 10 }
+   * Option.andThen(Option.some(5), (x) => Option.some(x * 2)) // => Option.some(10)
    *
    * // Chain with a static value
-   * console.log(Option.andThen(Option.some(5), "hello"))
-   * // Output: { _id: 'Option', _tag: 'Some', value: "hello" }
+   * Option.andThen(Option.some(5), "hello") // => Option.some("hello")
    *
    * // Chain with None - skips
-   * console.log(Option.andThen(Option.none(), (x) => Option.some(x * 2)))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * Option.andThen(Option.none(), (x) => Option.some(x * 2)) // => Option.none()
    * ```
    *
    * @see {@link flatMap} for the standard monadic bind
@@ -2240,20 +2096,17 @@ export const andThen: {
    *
    * **Example** (Chaining with andThen)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * // Chain with a function returning Option
-   * console.log(Option.andThen(Option.some(5), (x) => Option.some(x * 2)))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 10 }
+   * Option.andThen(Option.some(5), (x) => Option.some(x * 2)) // => Option.some(10)
    *
    * // Chain with a static value
-   * console.log(Option.andThen(Option.some(5), "hello"))
-   * // Output: { _id: 'Option', _tag: 'Some', value: "hello" }
+   * Option.andThen(Option.some(5), "hello") // => Option.some("hello")
    *
    * // Chain with None - skips
-   * console.log(Option.andThen(Option.none(), (x) => Option.some(x * 2)))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * Option.andThen(Option.none(), (x) => Option.some(x * 2)) // => Option.none()
    * ```
    *
    * @see {@link flatMap} for the standard monadic bind
@@ -2288,7 +2141,7 @@ export const andThen: {
  *
  * **Example** (Navigating optional properties)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * interface Employee {
@@ -2299,12 +2152,9 @@ export const andThen: {
  *   company: { address: { street: { name: "high street" } } }
  * }
  *
- * console.log(
- *   Option.some(emp).pipe(
- *     Option.flatMapNullishOr((e) => e.company?.address?.street?.name)
- *   )
- * )
- * // Output: { _id: 'Option', _tag: 'Some', value: 'high street' }
+ * Option.some(emp).pipe(
+ *   Option.flatMapNullishOr((e) => e.company?.address?.street?.name)
+ * ) // => Option.some("high street")
  * ```
  *
  * @see {@link flatMap} when the function already returns `Option`
@@ -2330,7 +2180,7 @@ export const flatMapNullishOr: {
    *
    * **Example** (Navigating optional properties)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * interface Employee {
@@ -2341,12 +2191,9 @@ export const flatMapNullishOr: {
    *   company: { address: { street: { name: "high street" } } }
    * }
    *
-   * console.log(
-   *   Option.some(emp).pipe(
-   *     Option.flatMapNullishOr((e) => e.company?.address?.street?.name)
-   *   )
-   * )
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'high street' }
+   * Option.some(emp).pipe(
+   *   Option.flatMapNullishOr((e) => e.company?.address?.street?.name)
+   * ) // => Option.some("high street")
    * ```
    *
    * @see {@link flatMap} when the function already returns `Option`
@@ -2372,7 +2219,7 @@ export const flatMapNullishOr: {
    *
    * **Example** (Navigating optional properties)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * interface Employee {
@@ -2383,12 +2230,9 @@ export const flatMapNullishOr: {
    *   company: { address: { street: { name: "high street" } } }
    * }
    *
-   * console.log(
-   *   Option.some(emp).pipe(
-   *     Option.flatMapNullishOr((e) => e.company?.address?.street?.name)
-   *   )
-   * )
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'high street' }
+   * Option.some(emp).pipe(
+   *   Option.flatMapNullishOr((e) => e.company?.address?.street?.name)
+   * ) // => Option.some("high street")
    * ```
    *
    * @see {@link flatMap} when the function already returns `Option`
@@ -2419,14 +2263,11 @@ export const flatMapNullishOr: {
  *
  * **Example** (Flattening nested Options)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.flatten(Option.some(Option.some("value"))))
- * // Output: { _id: 'Option', _tag: 'Some', value: 'value' }
- *
- * console.log(Option.flatten(Option.some(Option.none())))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * Option.flatten(Option.some(Option.some("value"))) // => Option.some("value")
+ * Option.flatten(Option.some(Option.none())) // => Option.none()
  * ```
  *
  * @see {@link flatMap} which is `map` + `flatten`
@@ -2451,14 +2292,11 @@ export const flatten: <A>(self: Option<Option<A>>) => Option<A> = flatMap(identi
  *
  * **Example** (Keeping the second value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.zipRight(Option.some(1), Option.some("hello")))
- * // Output: { _id: 'Option', _tag: 'Some', value: 'hello' }
- *
- * console.log(Option.zipRight(Option.none(), Option.some("hello")))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * Option.zipRight(Option.some(1), Option.some("hello")) // => Option.some("hello")
+ * Option.zipRight(Option.none(), Option.some("hello")) // => Option.none()
  * ```
  *
  * @see {@link zipLeft} to keep the first value instead
@@ -2483,14 +2321,11 @@ export const zipRight: {
    *
    * **Example** (Keeping the second value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * console.log(Option.zipRight(Option.some(1), Option.some("hello")))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'hello' }
-   *
-   * console.log(Option.zipRight(Option.none(), Option.some("hello")))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * Option.zipRight(Option.some(1), Option.some("hello")) // => Option.some("hello")
+   * Option.zipRight(Option.none(), Option.some("hello")) // => Option.none()
    * ```
    *
    * @see {@link zipLeft} to keep the first value instead
@@ -2515,14 +2350,11 @@ export const zipRight: {
    *
    * **Example** (Keeping the second value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * console.log(Option.zipRight(Option.some(1), Option.some("hello")))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'hello' }
-   *
-   * console.log(Option.zipRight(Option.none(), Option.some("hello")))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * Option.zipRight(Option.some(1), Option.some("hello")) // => Option.some("hello")
+   * Option.zipRight(Option.none(), Option.some("hello")) // => Option.none()
    * ```
    *
    * @see {@link zipLeft} to keep the first value instead
@@ -2549,14 +2381,11 @@ export const zipRight: {
  *
  * **Example** (Keeping the first value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.zipLeft(Option.some("hello"), Option.some(1)))
- * // Output: { _id: 'Option', _tag: 'Some', value: 'hello' }
- *
- * console.log(Option.zipLeft(Option.some("hello"), Option.none()))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * Option.zipLeft(Option.some("hello"), Option.some(1)) // => Option.some("hello")
+ * Option.zipLeft(Option.some("hello"), Option.none()) // => Option.none()
  * ```
  *
  * @see {@link zipRight} to keep the second value instead
@@ -2581,14 +2410,11 @@ export const zipLeft: {
    *
    * **Example** (Keeping the first value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * console.log(Option.zipLeft(Option.some("hello"), Option.some(1)))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'hello' }
-   *
-   * console.log(Option.zipLeft(Option.some("hello"), Option.none()))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * Option.zipLeft(Option.some("hello"), Option.some(1)) // => Option.some("hello")
+   * Option.zipLeft(Option.some("hello"), Option.none()) // => Option.none()
    * ```
    *
    * @see {@link zipRight} to keep the second value instead
@@ -2613,14 +2439,11 @@ export const zipLeft: {
    *
    * **Example** (Keeping the first value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * console.log(Option.zipLeft(Option.some("hello"), Option.some(1)))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'hello' }
-   *
-   * console.log(Option.zipLeft(Option.some("hello"), Option.none()))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * Option.zipLeft(Option.some("hello"), Option.some(1)) // => Option.some("hello")
+   * Option.zipLeft(Option.some("hello"), Option.none()) // => Option.none()
    * ```
    *
    * @see {@link zipRight} to keep the second value instead
@@ -2648,7 +2471,7 @@ export const zipLeft: {
  *
  * **Example** (Composing parsers)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * const parse = (s: string): Option.Option<number> =>
@@ -2659,11 +2482,8 @@ export const zipLeft: {
  *
  * const parseAndDouble = Option.composeK(parse, double)
  *
- * console.log(parseAndDouble("42"))
- * // Output: { _id: 'Option', _tag: 'Some', value: 84 }
- *
- * console.log(parseAndDouble("not a number"))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * parseAndDouble("42") // => Option.some(84)
+ * parseAndDouble("not a number") // => Option.none()
  * ```
  *
  * @see {@link flatMap} for single-step chaining
@@ -2688,7 +2508,7 @@ export const composeK: {
    *
    * **Example** (Composing parsers)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * const parse = (s: string): Option.Option<number> =>
@@ -2699,11 +2519,8 @@ export const composeK: {
    *
    * const parseAndDouble = Option.composeK(parse, double)
    *
-   * console.log(parseAndDouble("42"))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 84 }
-   *
-   * console.log(parseAndDouble("not a number"))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * parseAndDouble("42") // => Option.some(84)
+   * parseAndDouble("not a number") // => Option.none()
    * ```
    *
    * @see {@link flatMap} for single-step chaining
@@ -2728,7 +2545,7 @@ export const composeK: {
    *
    * **Example** (Composing parsers)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * const parse = (s: string): Option.Option<number> =>
@@ -2739,11 +2556,8 @@ export const composeK: {
    *
    * const parseAndDouble = Option.composeK(parse, double)
    *
-   * console.log(parseAndDouble("42"))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 84 }
-   *
-   * console.log(parseAndDouble("not a number"))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * parseAndDouble("42") // => Option.some(84)
+   * parseAndDouble("not a number") // => Option.none()
    * ```
    *
    * @see {@link flatMap} for single-step chaining
@@ -2771,17 +2585,14 @@ export const composeK: {
  *
  * **Example** (Validating without transforming)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * const getInteger = (n: number) =>
  *   Number.isInteger(n) ? Option.some(n) : Option.none()
  *
- * console.log(Option.tap(Option.some(1), getInteger))
- * // Output: { _id: 'Option', _tag: 'Some', value: 1 }
- *
- * console.log(Option.tap(Option.some(1.14), getInteger))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * Option.tap(Option.some(1), getInteger) // => Option.some(1)
+ * Option.tap(Option.some(1.14), getInteger) // => Option.none()
  * ```
  *
  * @see {@link flatMap} when you want to transform the value
@@ -2808,17 +2619,14 @@ export const tap: {
    *
    * **Example** (Validating without transforming)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * const getInteger = (n: number) =>
    *   Number.isInteger(n) ? Option.some(n) : Option.none()
    *
-   * console.log(Option.tap(Option.some(1), getInteger))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 1 }
-   *
-   * console.log(Option.tap(Option.some(1.14), getInteger))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * Option.tap(Option.some(1), getInteger) // => Option.some(1)
+   * Option.tap(Option.some(1.14), getInteger) // => Option.none()
    * ```
    *
    * @see {@link flatMap} when you want to transform the value
@@ -2845,17 +2653,14 @@ export const tap: {
    *
    * **Example** (Validating without transforming)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * const getInteger = (n: number) =>
    *   Number.isInteger(n) ? Option.some(n) : Option.none()
    *
-   * console.log(Option.tap(Option.some(1), getInteger))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 1 }
-   *
-   * console.log(Option.tap(Option.some(1.14), getInteger))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * Option.tap(Option.some(1), getInteger) // => Option.some(1)
+   * Option.tap(Option.some(1.14), getInteger) // => Option.none()
    * ```
    *
    * @see {@link flatMap} when you want to transform the value
@@ -2883,14 +2688,11 @@ export const tap: {
  *
  * **Example** (Pairing two Options)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.product(Option.some("hello"), Option.some(42)))
- * // Output: { _id: 'Option', _tag: 'Some', value: ['hello', 42] }
- *
- * console.log(Option.product(Option.none(), Option.some(42)))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * Option.product(Option.some("hello"), Option.some(42)) // => Option.some(["hello", 42])
+ * Option.product(Option.none(), Option.some(42)) // => Option.none()
  * ```
  *
  * @see {@link zipWith} to combine with a function instead of a tuple
@@ -2918,17 +2720,14 @@ export const product = <A, B>(self: Option<A>, that: Option<B>): Option<[A, B]>
  *
  * **Example** (Combining many Options)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * const first = Option.some(1)
  * const rest = [Option.some(2), Option.some(3)]
  *
- * console.log(Option.productMany(first, rest))
- * // Output: { _id: 'Option', _tag: 'Some', value: [1, 2, 3] }
- *
- * console.log(Option.productMany(first, [Option.some(2), Option.none()]))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * Option.productMany(first, rest) // => Option.some([1, 2, 3])
+ * Option.productMany(first, [Option.some(2), Option.none()]) // => Option.none()
  * ```
  *
  * @see {@link product} for combining exactly two
@@ -2972,7 +2771,7 @@ export const productMany = <A>(
  *
  * **Example** (Combining a tuple and a struct)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * const maybeName: Option.Option<string> = Option.some("John")
@@ -2980,17 +2779,11 @@ export const productMany = <A>(
  *
  * //      ┌─── Option<[string, number]>
  * //      ▼
- * const tuple = Option.all([maybeName, maybeAge])
- * console.log(tuple)
- * // Output:
- * // { _id: 'Option', _tag: 'Some', value: [ 'John', 25 ] }
+ * const tuple = Option.all([maybeName, maybeAge]) // => Option.some(["John", 25])
  *
  * //      ┌─── Option<{ name: string; age: number; }>
  * //      ▼
- * const struct = Option.all({ name: maybeName, age: maybeAge })
- * console.log(struct)
- * // Output:
- * // { _id: 'Option', _tag: 'Some', value: { name: 'John', age: 25 } }
+ * const struct = Option.all({ name: maybeName, age: maybeAge }) // => Option.some({ name: "John", age: 25 })
  * ```
  *
  * @see {@link product} for combining exactly two
@@ -3046,18 +2839,14 @@ export const all: <const I extends Iterable<Option<any>> | Record<string, Option
  *
  * **Example** (Combining with a function)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * const person = Option.zipWith(
+ * Option.zipWith(
  *   Option.some("John"),
  *   Option.some(25),
  *   (name, age) => ({ name: name.toUpperCase(), age })
- * )
- *
- * console.log(person)
- * // Output:
- * // { _id: 'Option', _tag: 'Some', value: { name: 'JOHN', age: 25 } }
+ * ) // => Option.some({ name: "JOHN", age: 25 })
  * ```
  *
  * @see {@link product} to combine into a tuple instead
@@ -3082,18 +2871,14 @@ export const zipWith: {
    *
    * **Example** (Combining with a function)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * const person = Option.zipWith(
+   * Option.zipWith(
    *   Option.some("John"),
    *   Option.some(25),
    *   (name, age) => ({ name: name.toUpperCase(), age })
-   * )
-   *
-   * console.log(person)
-   * // Output:
-   * // { _id: 'Option', _tag: 'Some', value: { name: 'JOHN', age: 25 } }
+   * ) // => Option.some({ name: "JOHN", age: 25 })
    * ```
    *
    * @see {@link product} to combine into a tuple instead
@@ -3118,18 +2903,14 @@ export const zipWith: {
    *
    * **Example** (Combining with a function)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * const person = Option.zipWith(
+   * Option.zipWith(
    *   Option.some("John"),
    *   Option.some(25),
    *   (name, age) => ({ name: name.toUpperCase(), age })
-   * )
-   *
-   * console.log(person)
-   * // Output:
-   * // { _id: 'Option', _tag: 'Some', value: { name: 'JOHN', age: 25 } }
+   * ) // => Option.some({ name: "JOHN", age: 25 })
    * ```
    *
    * @see {@link product} to combine into a tuple instead
@@ -3161,16 +2942,15 @@ export const zipWith: {
  *
  * **Example** (Summing present values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option, pipe } from "effect"
  *
  * const items = [Option.some(1), Option.none(), Option.some(2), Option.none()]
  *
- * console.log(pipe(items, Option.reduceCompact(0, (b, a) => b + a)))
- * // Output: 3
+ * pipe(items, Option.reduceCompact(0, (b, a) => b + a)) // => 3
  * ```
  *
- * @category reducing
+ * @category folding
  * @since 2.0.0
  */
 export const reduceCompact: {
@@ -3190,16 +2970,15 @@ export const reduceCompact: {
    *
    * **Example** (Summing present values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option, pipe } from "effect"
    *
    * const items = [Option.some(1), Option.none(), Option.some(2), Option.none()]
    *
-   * console.log(pipe(items, Option.reduceCompact(0, (b, a) => b + a)))
-   * // Output: 3
+   * pipe(items, Option.reduceCompact(0, (b, a) => b + a)) // => 3
    * ```
    *
-   * @category reducing
+   * @category folding
    * @since 2.0.0
    */
   <B, A>(b: B, f: (b: B, a: A) => B): (self: Iterable<Option<A>>) => B
@@ -3219,16 +2998,15 @@ export const reduceCompact: {
    *
    * **Example** (Summing present values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option, pipe } from "effect"
    *
    * const items = [Option.some(1), Option.none(), Option.some(2), Option.none()]
    *
-   * console.log(pipe(items, Option.reduceCompact(0, (b, a) => b + a)))
-   * // Output: 3
+   * pipe(items, Option.reduceCompact(0, (b, a) => b + a)) // => 3
    * ```
    *
-   * @category reducing
+   * @category folding
    * @since 2.0.0
    */
   <A, B>(self: Iterable<Option<A>>, b: B, f: (b: B, a: A) => B): B
@@ -3260,14 +3038,11 @@ export const reduceCompact: {
  *
  * **Example** (Converting to an array)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.toArray(Option.some(1)))
- * // Output: [1]
- *
- * console.log(Option.toArray(Option.none()))
- * // Output: []
+ * Option.toArray(Option.some(1)) // => [1]
+ * Option.toArray(Option.none()) // => []
  * ```
  *
  * @see {@link fromIterable} for the inverse direction
@@ -3293,7 +3068,7 @@ export const toArray = <A>(self: Option<A>): Array<A> => isNone(self) ? [] : [se
  *
  * **Example** (Partitioning by Result)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option, Result } from "effect"
  *
  * const parseNumber = (s: string): Result.Result<number, string> => {
@@ -3301,14 +3076,9 @@ export const toArray = <A>(self: Option<A>): Array<A> => isNone(self) ? [] : [se
  *   return isNaN(n) ? Result.fail("Not a number") : Result.succeed(n)
  * }
  *
- * console.log(Option.partitionMap(Option.some("42"), parseNumber))
- * // Output: [{ _id: 'Option', _tag: 'None' }, { _id: 'Option', _tag: 'Some', value: 42 }]
- *
- * console.log(Option.partitionMap(Option.some("abc"), parseNumber))
- * // Output: [{ _id: 'Option', _tag: 'Some', value: 'Not a number' }, { _id: 'Option', _tag: 'None' }]
- *
- * console.log(Option.partitionMap(Option.none(), parseNumber))
- * // Output: [{ _id: 'Option', _tag: 'None' }, { _id: 'Option', _tag: 'None' }]
+ * Option.partitionMap(Option.some("42"), parseNumber) // => [Option.none(), Option.some(42)]
+ * Option.partitionMap(Option.some("abc"), parseNumber) // => [Option.some("Not a number"), Option.none()]
+ * Option.partitionMap(Option.none(), parseNumber) // => [Option.none(), Option.none()]
  * ```
  *
  * @see {@link filter} for simple predicate-based filtering
@@ -3333,7 +3103,7 @@ export const partitionMap: {
    *
    * **Example** (Partitioning by Result)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option, Result } from "effect"
    *
    * const parseNumber = (s: string): Result.Result<number, string> => {
@@ -3341,14 +3111,9 @@ export const partitionMap: {
    *   return isNaN(n) ? Result.fail("Not a number") : Result.succeed(n)
    * }
    *
-   * console.log(Option.partitionMap(Option.some("42"), parseNumber))
-   * // Output: [{ _id: 'Option', _tag: 'None' }, { _id: 'Option', _tag: 'Some', value: 42 }]
-   *
-   * console.log(Option.partitionMap(Option.some("abc"), parseNumber))
-   * // Output: [{ _id: 'Option', _tag: 'Some', value: 'Not a number' }, { _id: 'Option', _tag: 'None' }]
-   *
-   * console.log(Option.partitionMap(Option.none(), parseNumber))
-   * // Output: [{ _id: 'Option', _tag: 'None' }, { _id: 'Option', _tag: 'None' }]
+   * Option.partitionMap(Option.some("42"), parseNumber) // => [Option.none(), Option.some(42)]
+   * Option.partitionMap(Option.some("abc"), parseNumber) // => [Option.some("Not a number"), Option.none()]
+   * Option.partitionMap(Option.none(), parseNumber) // => [Option.none(), Option.none()]
    * ```
    *
    * @see {@link filter} for simple predicate-based filtering
@@ -3373,7 +3138,7 @@ export const partitionMap: {
    *
    * **Example** (Partitioning by Result)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option, Result } from "effect"
    *
    * const parseNumber = (s: string): Result.Result<number, string> => {
@@ -3381,14 +3146,9 @@ export const partitionMap: {
    *   return isNaN(n) ? Result.fail("Not a number") : Result.succeed(n)
    * }
    *
-   * console.log(Option.partitionMap(Option.some("42"), parseNumber))
-   * // Output: [{ _id: 'Option', _tag: 'None' }, { _id: 'Option', _tag: 'Some', value: 42 }]
-   *
-   * console.log(Option.partitionMap(Option.some("abc"), parseNumber))
-   * // Output: [{ _id: 'Option', _tag: 'Some', value: 'Not a number' }, { _id: 'Option', _tag: 'None' }]
-   *
-   * console.log(Option.partitionMap(Option.none(), parseNumber))
-   * // Output: [{ _id: 'Option', _tag: 'None' }, { _id: 'Option', _tag: 'None' }]
+   * Option.partitionMap(Option.some("42"), parseNumber) // => [Option.none(), Option.some(42)]
+   * Option.partitionMap(Option.some("abc"), parseNumber) // => [Option.some("Not a number"), Option.none()]
+   * Option.partitionMap(Option.none(), parseNumber) // => [Option.none(), Option.none()]
    * ```
    *
    * @see {@link filter} for simple predicate-based filtering
@@ -3423,14 +3183,13 @@ export const partitionMap: {
  *
  * **Example** (Filtering and transforming)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option, Result } from "effect"
  *
- * console.log(Option.filterMap(
+ * Option.filterMap(
  *   Option.some(2),
  *   (n) => (n % 2 === 0 ? Result.succeed(`Even: ${n}`) : Result.failVoid)
- * ))
- * // Output: { _id: 'Option', _tag: 'Some', value: 'Even: 2' }
+ * ) // => Option.some("Even: 2")
  * ```
  *
  * @see {@link filter} for predicate-based filtering
@@ -3454,14 +3213,13 @@ export const filterMap: {
    *
    * **Example** (Filtering and transforming)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option, Result } from "effect"
    *
-   * console.log(Option.filterMap(
+   * Option.filterMap(
    *   Option.some(2),
    *   (n) => (n % 2 === 0 ? Result.succeed(`Even: ${n}`) : Result.failVoid)
-   * ))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'Even: 2' }
+   * ) // => Option.some("Even: 2")
    * ```
    *
    * @see {@link filter} for predicate-based filtering
@@ -3485,14 +3243,13 @@ export const filterMap: {
    *
    * **Example** (Filtering and transforming)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option, Result } from "effect"
    *
-   * console.log(Option.filterMap(
+   * Option.filterMap(
    *   Option.some(2),
    *   (n) => (n % 2 === 0 ? Result.succeed(`Even: ${n}`) : Result.failVoid)
-   * ))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'Even: 2' }
+   * ) // => Option.some("Even: 2")
    * ```
    *
    * @see {@link filter} for predicate-based filtering
@@ -3527,20 +3284,15 @@ export const filterMap: {
  *
  * **Example** (Filtering with a predicate)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * const removeEmpty = (input: Option.Option<string>) =>
  *   Option.filter(input, (value) => value !== "")
  *
- * console.log(removeEmpty(Option.some("hello")))
- * // Output: { _id: 'Option', _tag: 'Some', value: 'hello' }
- *
- * console.log(removeEmpty(Option.some("")))
- * // Output: { _id: 'Option', _tag: 'None' }
- *
- * console.log(removeEmpty(Option.none()))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * removeEmpty(Option.some("hello")) // => Option.some("hello")
+ * removeEmpty(Option.some("")) // => Option.none()
+ * removeEmpty(Option.none()) // => Option.none()
  * ```
  *
  * @see {@link filterMap} to transform and filter simultaneously
@@ -3568,20 +3320,15 @@ export const filter: {
    *
    * **Example** (Filtering with a predicate)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * const removeEmpty = (input: Option.Option<string>) =>
    *   Option.filter(input, (value) => value !== "")
    *
-   * console.log(removeEmpty(Option.some("hello")))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'hello' }
-   *
-   * console.log(removeEmpty(Option.some("")))
-   * // Output: { _id: 'Option', _tag: 'None' }
-   *
-   * console.log(removeEmpty(Option.none()))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * removeEmpty(Option.some("hello")) // => Option.some("hello")
+   * removeEmpty(Option.some("")) // => Option.none()
+   * removeEmpty(Option.none()) // => Option.none()
    * ```
    *
    * @see {@link filterMap} to transform and filter simultaneously
@@ -3609,20 +3356,15 @@ export const filter: {
    *
    * **Example** (Filtering with a predicate)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * const removeEmpty = (input: Option.Option<string>) =>
    *   Option.filter(input, (value) => value !== "")
    *
-   * console.log(removeEmpty(Option.some("hello")))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'hello' }
-   *
-   * console.log(removeEmpty(Option.some("")))
-   * // Output: { _id: 'Option', _tag: 'None' }
-   *
-   * console.log(removeEmpty(Option.none()))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * removeEmpty(Option.some("hello")) // => Option.some("hello")
+   * removeEmpty(Option.some("")) // => Option.none()
+   * removeEmpty(Option.none()) // => Option.none()
    * ```
    *
    * @see {@link filterMap} to transform and filter simultaneously
@@ -3650,20 +3392,15 @@ export const filter: {
    *
    * **Example** (Filtering with a predicate)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * const removeEmpty = (input: Option.Option<string>) =>
    *   Option.filter(input, (value) => value !== "")
    *
-   * console.log(removeEmpty(Option.some("hello")))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'hello' }
-   *
-   * console.log(removeEmpty(Option.some("")))
-   * // Output: { _id: 'Option', _tag: 'None' }
-   *
-   * console.log(removeEmpty(Option.none()))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * removeEmpty(Option.some("hello")) // => Option.some("hello")
+   * removeEmpty(Option.some("")) // => Option.none()
+   * removeEmpty(Option.none()) // => Option.none()
    * ```
    *
    * @see {@link filterMap} to transform and filter simultaneously
@@ -3691,20 +3428,15 @@ export const filter: {
    *
    * **Example** (Filtering with a predicate)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * const removeEmpty = (input: Option.Option<string>) =>
    *   Option.filter(input, (value) => value !== "")
    *
-   * console.log(removeEmpty(Option.some("hello")))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 'hello' }
-   *
-   * console.log(removeEmpty(Option.some("")))
-   * // Output: { _id: 'Option', _tag: 'None' }
-   *
-   * console.log(removeEmpty(Option.none()))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * removeEmpty(Option.some("hello")) // => Option.some("hello")
+   * removeEmpty(Option.some("")) // => Option.none()
+   * removeEmpty(Option.none()) // => Option.none()
    * ```
    *
    * @see {@link filterMap} to transform and filter simultaneously
@@ -3736,19 +3468,14 @@ export const filter: {
  *
  * **Example** (Comparing Options)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Equivalence, Option } from "effect"
  *
  * const eq = Option.makeEquivalence(Equivalence.strictEqual<number>())
  *
- * console.log(eq(Option.some(1), Option.some(1)))
- * // Output: true
- *
- * console.log(eq(Option.some(1), Option.some(2)))
- * // Output: false
- *
- * console.log(eq(Option.none(), Option.none()))
- * // Output: true
+ * eq(Option.some(1), Option.some(1)) // => true
+ * eq(Option.some(1), Option.some(2)) // => false
+ * eq(Option.none(), Option.none()) // => true
  * ```
  *
  * @category instances
@@ -3774,19 +3501,14 @@ export const makeEquivalence = <A>(isEquivalent: Equivalence.Equivalence<A>): Eq
  *
  * **Example** (Ordering Options)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number as N, Option } from "effect"
  *
  * const ord = Option.makeOrder(N.Order)
  *
- * console.log(ord(Option.none(), Option.some(1)))
- * // Output: -1
- *
- * console.log(ord(Option.some(1), Option.none()))
- * // Output: 1
- *
- * console.log(ord(Option.some(1), Option.some(2)))
- * // Output: -1
+ * ord(Option.none(), Option.some(1)) // => -1
+ * ord(Option.some(1), Option.none()) // => 1
+ * ord(Option.some(1), Option.some(2)) // => -1
  * ```
  *
  * @category sorting
@@ -3810,16 +3532,13 @@ export const makeOrder = <A>(O: Order<A>): Order<Option<A>> =>
  *
  * **Example** (Lifting addition)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * const addOptions = Option.lift2((a: number, b: number) => a + b)
  *
- * console.log(addOptions(Option.some(2), Option.some(3)))
- * // Output: { _id: 'Option', _tag: 'Some', value: 5 }
- *
- * console.log(addOptions(Option.some(2), Option.none()))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * addOptions(Option.some(2), Option.some(3)) // => Option.some(5)
+ * addOptions(Option.some(2), Option.none()) // => Option.none()
  * ```
  *
  * @see {@link zipWith} for a non-lifted variant
@@ -3849,16 +3568,13 @@ export const lift2 = <A, B, C>(f: (a: A, b: B) => C): {
  *
  * **Example** (Validating positive numbers)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * const parsePositive = Option.liftPredicate((n: number) => n > 0)
  *
- * console.log(parsePositive(1))
- * // Output: { _id: 'Option', _tag: 'Some', value: 1 }
- *
- * console.log(parsePositive(-1))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * parsePositive(1) // => Option.some(1)
+ * parsePositive(-1) // => Option.none()
  * ```
  *
  * @see {@link filter} to apply a predicate to an existing `Option`
@@ -3886,16 +3602,13 @@ export const liftPredicate: { // Note: I intentionally avoid using the NoInfer p
    *
    * **Example** (Validating positive numbers)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * const parsePositive = Option.liftPredicate((n: number) => n > 0)
    *
-   * console.log(parsePositive(1))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 1 }
-   *
-   * console.log(parsePositive(-1))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * parsePositive(1) // => Option.some(1)
+   * parsePositive(-1) // => Option.none()
    * ```
    *
    * @see {@link filter} to apply a predicate to an existing `Option`
@@ -3922,16 +3635,13 @@ export const liftPredicate: { // Note: I intentionally avoid using the NoInfer p
    *
    * **Example** (Validating positive numbers)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * const parsePositive = Option.liftPredicate((n: number) => n > 0)
    *
-   * console.log(parsePositive(1))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 1 }
-   *
-   * console.log(parsePositive(-1))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * parsePositive(1) // => Option.some(1)
+   * parsePositive(-1) // => Option.none()
    * ```
    *
    * @see {@link filter} to apply a predicate to an existing `Option`
@@ -3958,16 +3668,13 @@ export const liftPredicate: { // Note: I intentionally avoid using the NoInfer p
    *
    * **Example** (Validating positive numbers)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * const parsePositive = Option.liftPredicate((n: number) => n > 0)
    *
-   * console.log(parsePositive(1))
-   * // Output: { _id: 'Option', _tag: 'Some', value: 1 }
-   *
-   * console.log(parsePositive(-1))
-   * // Output: { _id: 'Option', _tag: 'None' }
+   * parsePositive(1) // => Option.some(1)
+   * parsePositive(-1) // => Option.none()
    * ```
    *
    * @see {@link filter} to apply a predicate to an existing `Option`
@@ -3998,24 +3705,19 @@ export const liftPredicate: { // Note: I intentionally avoid using the NoInfer p
  *
  * **Example** (Checking with custom equivalence)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Equivalence, Option } from "effect"
  *
  * const check = Option.containsWith(Equivalence.strictEqual<number>())
  *
- * console.log(Option.some(2).pipe(check(2)))
- * // Output: true
- *
- * console.log(Option.some(1).pipe(check(2)))
- * // Output: false
- *
- * console.log(Option.none().pipe(check(2)))
- * // Output: false
+ * Option.some(2).pipe(check(2)) // => true
+ * Option.some(1).pipe(check(2)) // => false
+ * Option.none().pipe(check(2)) // => false
  * ```
  *
  * @see {@link contains} for a version using default equality
  *
- * @category elements
+ * @category predicates
  * @since 2.0.0
  */
 export const containsWith = <A>(isEquivalent: (self: A, that: A) => boolean): {
@@ -4039,23 +3741,18 @@ export const containsWith = <A>(isEquivalent: (self: A, that: A) => boolean): {
  *
  * **Example** (Checking containment)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
- * console.log(Option.some(2).pipe(Option.contains(2)))
- * // Output: true
- *
- * console.log(Option.some(1).pipe(Option.contains(2)))
- * // Output: false
- *
- * console.log(Option.none().pipe(Option.contains(2)))
- * // Output: false
+ * Option.some(2).pipe(Option.contains(2)) // => true
+ * Option.some(1).pipe(Option.contains(2)) // => false
+ * Option.none().pipe(Option.contains(2)) // => false
  * ```
  *
  * @see {@link containsWith} for custom equality
  * @see {@link exists} to test with a predicate
  *
- * @category elements
+ * @category predicates
  * @since 2.0.0
  */
 export const contains: {
@@ -4075,23 +3772,18 @@ export const contains: {
    *
    * **Example** (Checking containment)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * console.log(Option.some(2).pipe(Option.contains(2)))
-   * // Output: true
-   *
-   * console.log(Option.some(1).pipe(Option.contains(2)))
-   * // Output: false
-   *
-   * console.log(Option.none().pipe(Option.contains(2)))
-   * // Output: false
+   * Option.some(2).pipe(Option.contains(2)) // => true
+   * Option.some(1).pipe(Option.contains(2)) // => false
+   * Option.none().pipe(Option.contains(2)) // => false
    * ```
    *
    * @see {@link containsWith} for custom equality
    * @see {@link exists} to test with a predicate
    *
-   * @category elements
+   * @category predicates
    * @since 2.0.0
    */
   <A>(a: A): (self: Option<A>) => boolean
@@ -4111,23 +3803,18 @@ export const contains: {
    *
    * **Example** (Checking containment)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
-   * console.log(Option.some(2).pipe(Option.contains(2)))
-   * // Output: true
-   *
-   * console.log(Option.some(1).pipe(Option.contains(2)))
-   * // Output: false
-   *
-   * console.log(Option.none().pipe(Option.contains(2)))
-   * // Output: false
+   * Option.some(2).pipe(Option.contains(2)) // => true
+   * Option.some(1).pipe(Option.contains(2)) // => false
+   * Option.none().pipe(Option.contains(2)) // => false
    * ```
    *
    * @see {@link containsWith} for custom equality
    * @see {@link exists} to test with a predicate
    *
-   * @category elements
+   * @category predicates
    * @since 2.0.0
    */
   <A>(self: Option<A>, a: A): boolean
@@ -4149,25 +3836,20 @@ export const contains: {
  *
  * **Example** (Testing a condition)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * const isEven = (n: number) => n % 2 === 0
  *
- * console.log(Option.some(2).pipe(Option.exists(isEven)))
- * // Output: true
- *
- * console.log(Option.some(1).pipe(Option.exists(isEven)))
- * // Output: false
- *
- * console.log(Option.none().pipe(Option.exists(isEven)))
- * // Output: false
+ * Option.some(2).pipe(Option.exists(isEven)) // => true
+ * Option.some(1).pipe(Option.exists(isEven)) // => false
+ * Option.none().pipe(Option.exists(isEven)) // => false
  * ```
  *
  * @see {@link filter} to keep or discard based on a predicate
  * @see {@link contains} to test for a specific value
  *
- * @category elements
+ * @category predicates
  * @since 2.0.0
  */
 export const exists: {
@@ -4187,25 +3869,20 @@ export const exists: {
    *
    * **Example** (Testing a condition)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * const isEven = (n: number) => n % 2 === 0
    *
-   * console.log(Option.some(2).pipe(Option.exists(isEven)))
-   * // Output: true
-   *
-   * console.log(Option.some(1).pipe(Option.exists(isEven)))
-   * // Output: false
-   *
-   * console.log(Option.none().pipe(Option.exists(isEven)))
-   * // Output: false
+   * Option.some(2).pipe(Option.exists(isEven)) // => true
+   * Option.some(1).pipe(Option.exists(isEven)) // => false
+   * Option.none().pipe(Option.exists(isEven)) // => false
    * ```
    *
    * @see {@link filter} to keep or discard based on a predicate
    * @see {@link contains} to test for a specific value
    *
-   * @category elements
+   * @category predicates
    * @since 2.0.0
    */
   <A, B extends A>(refinement: Refinement<NoInfer<A>, B>): (self: Option<A>) => self is Option<B>
@@ -4225,25 +3902,20 @@ export const exists: {
    *
    * **Example** (Testing a condition)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * const isEven = (n: number) => n % 2 === 0
    *
-   * console.log(Option.some(2).pipe(Option.exists(isEven)))
-   * // Output: true
-   *
-   * console.log(Option.some(1).pipe(Option.exists(isEven)))
-   * // Output: false
-   *
-   * console.log(Option.none().pipe(Option.exists(isEven)))
-   * // Output: false
+   * Option.some(2).pipe(Option.exists(isEven)) // => true
+   * Option.some(1).pipe(Option.exists(isEven)) // => false
+   * Option.none().pipe(Option.exists(isEven)) // => false
    * ```
    *
    * @see {@link filter} to keep or discard based on a predicate
    * @see {@link contains} to test for a specific value
    *
-   * @category elements
+   * @category predicates
    * @since 2.0.0
    */
   <A>(predicate: Predicate<NoInfer<A>>): (self: Option<A>) => boolean
@@ -4263,25 +3935,20 @@ export const exists: {
    *
    * **Example** (Testing a condition)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * const isEven = (n: number) => n % 2 === 0
    *
-   * console.log(Option.some(2).pipe(Option.exists(isEven)))
-   * // Output: true
-   *
-   * console.log(Option.some(1).pipe(Option.exists(isEven)))
-   * // Output: false
-   *
-   * console.log(Option.none().pipe(Option.exists(isEven)))
-   * // Output: false
+   * Option.some(2).pipe(Option.exists(isEven)) // => true
+   * Option.some(1).pipe(Option.exists(isEven)) // => false
+   * Option.none().pipe(Option.exists(isEven)) // => false
    * ```
    *
    * @see {@link filter} to keep or discard based on a predicate
    * @see {@link contains} to test for a specific value
    *
-   * @category elements
+   * @category predicates
    * @since 2.0.0
    */
   <A, B extends A>(self: Option<A>, refinement: Refinement<A, B>): self is Option<B>
@@ -4301,25 +3968,20 @@ export const exists: {
    *
    * **Example** (Testing a condition)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option } from "effect"
    *
    * const isEven = (n: number) => n % 2 === 0
    *
-   * console.log(Option.some(2).pipe(Option.exists(isEven)))
-   * // Output: true
-   *
-   * console.log(Option.some(1).pipe(Option.exists(isEven)))
-   * // Output: false
-   *
-   * console.log(Option.none().pipe(Option.exists(isEven)))
-   * // Output: false
+   * Option.some(2).pipe(Option.exists(isEven)) // => true
+   * Option.some(1).pipe(Option.exists(isEven)) // => false
+   * Option.none().pipe(Option.exists(isEven)) // => false
    * ```
    *
    * @see {@link filter} to keep or discard based on a predicate
    * @see {@link contains} to test for a specific value
    *
-   * @category elements
+   * @category predicates
    * @since 2.0.0
    */
   <A>(self: Option<A>, predicate: Predicate<A>): boolean
@@ -4344,24 +4006,22 @@ export const exists: {
  *
  * **Example** (Starting do notation)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option, pipe } from "effect"
- * import * as assert from "node:assert"
  *
- * const result = pipe(
+ * pipe(
  *   Option.some(2),
  *   Option.bindTo("x"),
  *   Option.bind("y", () => Option.some(3)),
  *   Option.let("sum", ({ x, y }) => x + y)
- * )
- * assert.deepStrictEqual(result, Option.some({ x: 2, y: 3, sum: 5 }))
+ * ) // => Option.some({ x: 2, y: 3, sum: 5 })
  * ```
  *
  * @see {@link Do} for starting with an empty record
  * @see {@link bind} to add `Option` values
  * @see {@link let_ let} to add plain values
  *
- * @category do notation
+ * @category mapping
  * @since 2.0.0
  */
 export const bindTo: {
@@ -4380,24 +4040,22 @@ export const bindTo: {
    *
    * **Example** (Starting do notation)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option, pipe } from "effect"
-   * import * as assert from "node:assert"
    *
-   * const result = pipe(
+   * pipe(
    *   Option.some(2),
    *   Option.bindTo("x"),
    *   Option.bind("y", () => Option.some(3)),
    *   Option.let("sum", ({ x, y }) => x + y)
-   * )
-   * assert.deepStrictEqual(result, Option.some({ x: 2, y: 3, sum: 5 }))
+   * ) // => Option.some({ x: 2, y: 3, sum: 5 })
    * ```
    *
    * @see {@link Do} for starting with an empty record
    * @see {@link bind} to add `Option` values
    * @see {@link let_ let} to add plain values
    *
-   * @category do notation
+   * @category mapping
    * @since 2.0.0
    */
   <N extends string>(name: N): <A>(self: Option<A>) => Option<{ [K in N]: A }>
@@ -4416,24 +4074,22 @@ export const bindTo: {
    *
    * **Example** (Starting do notation)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option, pipe } from "effect"
-   * import * as assert from "node:assert"
    *
-   * const result = pipe(
+   * pipe(
    *   Option.some(2),
    *   Option.bindTo("x"),
    *   Option.bind("y", () => Option.some(3)),
    *   Option.let("sum", ({ x, y }) => x + y)
-   * )
-   * assert.deepStrictEqual(result, Option.some({ x: 2, y: 3, sum: 5 }))
+   * ) // => Option.some({ x: 2, y: 3, sum: 5 })
    * ```
    *
    * @see {@link Do} for starting with an empty record
    * @see {@link bind} to add `Option` values
    * @see {@link let_ let} to add plain values
    *
-   * @category do notation
+   * @category mapping
    * @since 2.0.0
    */
   <A, N extends string>(self: Option<A>, name: N): Option<{ [K in N]: A }>
@@ -4462,24 +4118,22 @@ export {
    *
    * **Example** (Adding a computed value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option, pipe } from "effect"
-   * import * as assert from "node:assert"
    *
-   * const result = pipe(
+   * pipe(
    *   Option.Do,
    *   Option.bind("x", () => Option.some(2)),
    *   Option.bind("y", () => Option.some(3)),
    *   Option.let("sum", ({ x, y }) => x + y)
-   * )
-   * assert.deepStrictEqual(result, Option.some({ x: 2, y: 3, sum: 5 }))
+   * ) // => Option.some({ x: 2, y: 3, sum: 5 })
    * ```
    *
    * @see {@link Do} for starting the chain
    * @see {@link bind} to add `Option` values
    * @see {@link bindTo} to start by naming an existing `Option`
    *
-   * @category do notation
+   * @category mapping
    * @since 2.0.0
    */
   let_ as let
@@ -4495,25 +4149,23 @@ export {
  *
  * **Example** (Binding Option values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option, pipe } from "effect"
- * import * as assert from "node:assert"
  *
- * const result = pipe(
+ * pipe(
  *   Option.Do,
  *   Option.bind("x", () => Option.some(2)),
  *   Option.bind("y", () => Option.some(3)),
  *   Option.let("sum", ({ x, y }) => x + y),
  *   Option.filter(({ x, y }) => x * y > 5)
- * )
- * assert.deepStrictEqual(result, Option.some({ x: 2, y: 3, sum: 5 }))
+ * ) // => Option.some({ x: 2, y: 3, sum: 5 })
  * ```
  *
  * @see {@link Do} for starting the chain
  * @see {@link let_ let} to add plain values
  * @see {@link bindTo} to start by naming an existing `Option`
  *
- * @category do notation
+ * @category sequencing
  * @since 2.0.0
  */
 export const bind: {
@@ -4527,25 +4179,23 @@ export const bind: {
    *
    * **Example** (Binding Option values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option, pipe } from "effect"
-   * import * as assert from "node:assert"
    *
-   * const result = pipe(
+   * pipe(
    *   Option.Do,
    *   Option.bind("x", () => Option.some(2)),
    *   Option.bind("y", () => Option.some(3)),
    *   Option.let("sum", ({ x, y }) => x + y),
    *   Option.filter(({ x, y }) => x * y > 5)
-   * )
-   * assert.deepStrictEqual(result, Option.some({ x: 2, y: 3, sum: 5 }))
+   * ) // => Option.some({ x: 2, y: 3, sum: 5 })
    * ```
    *
    * @see {@link Do} for starting the chain
    * @see {@link let_ let} to add plain values
    * @see {@link bindTo} to start by naming an existing `Option`
    *
-   * @category do notation
+   * @category sequencing
    * @since 2.0.0
    */
   <N extends string, A extends object, B>(name: Exclude<N, keyof A>, f: (a: NoInfer<A>) => Option<B>): (self: Option<A>) => Option<{ [K in N | keyof A]: K extends keyof A ? A[K] : B }>
@@ -4559,25 +4209,23 @@ export const bind: {
    *
    * **Example** (Binding Option values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Option, pipe } from "effect"
-   * import * as assert from "node:assert"
    *
-   * const result = pipe(
+   * pipe(
    *   Option.Do,
    *   Option.bind("x", () => Option.some(2)),
    *   Option.bind("y", () => Option.some(3)),
    *   Option.let("sum", ({ x, y }) => x + y),
    *   Option.filter(({ x, y }) => x * y > 5)
-   * )
-   * assert.deepStrictEqual(result, Option.some({ x: 2, y: 3, sum: 5 }))
+   * ) // => Option.some({ x: 2, y: 3, sum: 5 })
    * ```
    *
    * @see {@link Do} for starting the chain
    * @see {@link let_ let} to add plain values
    * @see {@link bindTo} to start by naming an existing `Option`
    *
-   * @category do notation
+   * @category sequencing
    * @since 2.0.0
    */
   <A extends object, N extends string, B>(
@@ -4598,25 +4246,23 @@ export const bind: {
  *
  * **Example** (Building Option pipelines with do notation)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option, pipe } from "effect"
- * import * as assert from "node:assert"
  *
- * const result = pipe(
+ * pipe(
  *   Option.Do,
  *   Option.bind("x", () => Option.some(2)),
  *   Option.bind("y", () => Option.some(3)),
  *   Option.let("sum", ({ x, y }) => x + y),
  *   Option.filter(({ x, y }) => x * y > 5)
- * )
- * assert.deepStrictEqual(result, Option.some({ x: 2, y: 3, sum: 5 }))
+ * ) // => Option.some({ x: 2, y: 3, sum: 5 })
  * ```
  *
  * @see {@link bind} to add `Option` values
  * @see {@link let_ let} to add plain values
  * @see {@link bindTo} to start by naming an existing `Option`
  *
- * @category do notation
+ * @category constructors
  * @since 2.0.0
  */
 export const Do: Option<{}> = some({})
@@ -4638,21 +4284,17 @@ export const Do: Option<{}> = some({})
  *
  * **Example** (Sequencing Option computations with generator syntax)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * const maybeName: Option.Option<string> = Option.some("John")
  * const maybeAge: Option.Option<number> = Option.some(25)
  *
- * const person = Option.gen(function*() {
+ * Option.gen(function*() {
  *   const name = (yield* maybeName).toUpperCase()
  *   const age = yield* maybeAge
  *   return { name, age }
- * })
- *
- * console.log(person)
- * // Output:
- * // { _id: 'Option', _tag: 'Some', value: { name: 'JOHN', age: 25 } }
+ * }) // => Option.some({ name: "JOHN", age: 25 })
  * ```
  *
  * @see {@link Do} / {@link bind} for the do notation alternative
@@ -4693,17 +4335,16 @@ export const gen: Gen.Gen<OptionTypeLambda> = (...args) => {
  *
  * **Example** (Reducing with first-wins semantics)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number, Option } from "effect"
  *
  * const reducer = Option.makeReducer(Number.ReducerSum)
- * console.log(reducer.combineAll([Option.some(1), Option.none(), Option.some(2)]))
- * // Output: { _id: 'Option', _tag: 'Some', value: 3 }
+ * reducer.combineAll([Option.some(1), Option.none(), Option.some(2)]) // => Option.some(3)
  * ```
  *
  * @see {@link makeReducerFailFast} for fail-fast semantics
  *
- * @category Reducer
+ * @category constructors
  * @since 4.0.0
  */
 export function makeReducer<A>(combiner: Combiner.Combiner<A>): Reducer.Reducer<Option<A>> {
@@ -4731,20 +4372,17 @@ export function makeReducer<A>(combiner: Combiner.Combiner<A>): Reducer.Reducer<
  *
  * **Example** (Fail-fast combining)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number, Option } from "effect"
  *
  * const combiner = Option.makeCombinerFailFast(Number.ReducerSum)
- * console.log(combiner.combine(Option.some(1), Option.some(2)))
- * // Output: { _id: 'Option', _tag: 'Some', value: 3 }
- *
- * console.log(combiner.combine(Option.some(1), Option.none()))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * combiner.combine(Option.some(1), Option.some(2)) // => Option.some(3)
+ * combiner.combine(Option.some(1), Option.none()) // => Option.none()
  * ```
  *
  * @see {@link makeReducerFailFast} to get a full `Reducer`
  *
- * @category Combiner
+ * @category constructors
  * @since 4.0.0
  */
 export function makeCombinerFailFast<A>(combiner: Combiner.Combiner<A>): Combiner.Combiner<Option<A>> {
@@ -4771,21 +4409,18 @@ export function makeCombinerFailFast<A>(combiner: Combiner.Combiner<A>): Combine
  *
  * **Example** (Fail-fast reducing)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number, Option } from "effect"
  *
  * const reducer = Option.makeReducerFailFast(Number.ReducerSum)
- * console.log(reducer.combineAll([Option.some(1), Option.some(2)]))
- * // Output: { _id: 'Option', _tag: 'Some', value: 3 }
- *
- * console.log(reducer.combineAll([Option.some(1), Option.none()]))
- * // Output: { _id: 'Option', _tag: 'None' }
+ * reducer.combineAll([Option.some(1), Option.some(2)]) // => Option.some(3)
+ * reducer.combineAll([Option.some(1), Option.none()]) // => Option.none()
  * ```
  *
  * @see {@link makeCombinerFailFast} for just the combiner
  * @see {@link makeReducer} for non-fail-fast semantics
  *
- * @category Reducer
+ * @category constructors
  * @since 4.0.0
  */
 export function makeReducerFailFast<A>(reducer: Reducer.Reducer<A>): Reducer.Reducer<Option<A>> {