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

package/dist/Option.d.ts

@@ -163,17 +163,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
      */
     type Value<T extends Option<any>> = [T] extends [Option<infer _A>] ? _A : never;
@@ -203,7 +202,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 {
@@ -224,15 +223,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.
@@ -256,15 +252,12 @@ export declare const none: <A = never>() => Option<A>;
  *
  * **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.
@@ -288,17 +281,12 @@ export declare const some: <A>(value: A) => Option<A>;
  *
  * **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
@@ -321,14 +309,11 @@ export declare const isOption: (input: unknown) => input is Option<unknown>;
  *
  * **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.
@@ -350,14 +335,11 @@ export declare const isNone: <A>(self: Option<A>) => self is None<A>;
  *
  * **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.
@@ -382,16 +364,13 @@ export declare const isSome: <A>(self: Option<A>) => self is Some<A>;
  *
  * **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
@@ -416,16 +395,13 @@ export declare 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
@@ -453,16 +429,13 @@ export declare 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
@@ -491,7 +464,7 @@ export declare const match: {
  *
  * **Example** (Converting a parser to a type guard)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * type MyData = string | number
@@ -503,11 +476,8 @@ export declare 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
@@ -532,14 +502,11 @@ export declare const toRefinement: <A, B extends A>(f: (a: A) => Option<B>) => (
  *
  * **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
@@ -563,14 +530,11 @@ export declare 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.
@@ -594,14 +558,11 @@ export declare const getSuccess: <A, E>(self: Result<A, E>) => Option<A>;
  *
  * **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.
@@ -626,14 +587,11 @@ export declare const getFailure: <A, E>(self: Result<A, E>) => Option<E>;
  *
  * **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`
@@ -660,14 +618,11 @@ export declare 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`
@@ -694,14 +649,11 @@ export declare 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`
@@ -729,14 +681,11 @@ export declare 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
@@ -762,14 +711,11 @@ export declare 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
@@ -795,14 +741,11 @@ export declare 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
@@ -828,14 +771,11 @@ export declare 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`
@@ -859,14 +799,11 @@ export declare 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`
@@ -890,14 +827,11 @@ export declare 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`
@@ -923,14 +857,13 @@ export declare 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
@@ -955,14 +888,13 @@ export declare 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
@@ -987,14 +919,13 @@ export declare 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
@@ -1019,15 +950,14 @@ export declare 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
@@ -1051,17 +981,12 @@ export declare const firstSomeOf: <T, C extends Iterable<Option<T>> = Iterable<O
  *
  * **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
@@ -1088,17 +1013,12 @@ export declare const fromNullishOr: <A>(a: A) => Option<NonNullable<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
@@ -1124,17 +1044,12 @@ export declare const fromUndefinedOr: <A>(a: A) => Option<Exclude<A, undefined>>
  *
  * **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
@@ -1159,7 +1074,7 @@ export declare const fromNullOr: <A>(a: A) => Option<Exclude<A, null>>;
  *
  * **Example** (Lifting a parser)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * const parse = (s: string): number | undefined => {
@@ -1169,11 +1084,8 @@ export declare const fromNullOr: <A>(a: A) => Option<Exclude<A, null>>;
  *
  * 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
@@ -1197,14 +1109,11 @@ export declare const liftNullishOr: <A extends ReadonlyArray<unknown>, B>(f: (..
  *
  * **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
@@ -1229,14 +1138,11 @@ export declare const getOrNull: <A>(self: Option<A>) => A | null;
  *
  * **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
@@ -1260,16 +1166,13 @@ export declare const getOrUndefined: <A>(self: Option<A>) => A | undefined;
  *
  * **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
@@ -1293,14 +1196,16 @@ export declare const liftThrowable: <A extends ReadonlyArray<unknown>, B>(f: (..
  *
  * **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
@@ -1325,14 +1230,16 @@ export declare 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
@@ -1357,14 +1264,16 @@ export declare 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
@@ -1390,14 +1299,16 @@ export declare 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
@@ -1423,14 +1334,11 @@ export declare const getOrThrow: <A>(self: Option<A>) => A;
  *
  * **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`
@@ -1456,14 +1364,11 @@ export declare 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`
@@ -1489,14 +1394,11 @@ export declare 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`
@@ -1517,14 +1419,11 @@ export declare 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`
@@ -1544,14 +1443,11 @@ export declare 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`
@@ -1571,14 +1467,11 @@ export declare 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`
@@ -1600,14 +1493,11 @@ export declare 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
@@ -1627,11 +1517,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>`
@@ -1657,7 +1546,7 @@ void_ as void };
  *
  * **Example** (Chaining optional lookups)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * interface User {
@@ -1670,12 +1559,9 @@ void_ as void };
  *   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
@@ -1703,7 +1589,7 @@ export declare const flatMap: {
      *
      * **Example** (Chaining optional lookups)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Option } from "effect"
      *
      * interface User {
@@ -1716,12 +1602,9 @@ export declare 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
@@ -1749,7 +1632,7 @@ export declare const flatMap: {
      *
      * **Example** (Chaining optional lookups)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Option } from "effect"
      *
      * interface User {
@@ -1762,12 +1645,9 @@ export declare 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
@@ -1797,20 +1677,17 @@ export declare 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
@@ -1838,20 +1715,17 @@ export declare 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
@@ -1879,20 +1753,17 @@ export declare 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
@@ -1920,20 +1791,17 @@ export declare 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
@@ -1961,20 +1829,17 @@ export declare 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
@@ -2002,20 +1867,17 @@ export declare 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
@@ -2043,20 +1905,17 @@ export declare 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
@@ -2084,20 +1943,17 @@ export declare 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
@@ -2125,20 +1981,17 @@ export declare 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
@@ -2165,7 +2018,7 @@ export declare const andThen: {
  *
  * **Example** (Navigating optional properties)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * interface Employee {
@@ -2176,12 +2029,9 @@ export declare 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`
@@ -2207,7 +2057,7 @@ export declare const flatMapNullishOr: {
      *
      * **Example** (Navigating optional properties)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Option } from "effect"
      *
      * interface Employee {
@@ -2218,12 +2068,9 @@ export declare 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`
@@ -2249,7 +2096,7 @@ export declare const flatMapNullishOr: {
      *
      * **Example** (Navigating optional properties)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Option } from "effect"
      *
      * interface Employee {
@@ -2260,12 +2107,9 @@ export declare 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`
@@ -2291,14 +2135,11 @@ export declare 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`
@@ -2322,14 +2163,11 @@ export declare const flatten: <A>(self: Option<Option<A>>) => Option<A>;
  *
  * **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
@@ -2354,14 +2192,11 @@ export declare 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
@@ -2386,14 +2221,11 @@ export declare 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
@@ -2419,14 +2251,11 @@ export declare 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
@@ -2451,14 +2280,11 @@ export declare 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
@@ -2483,14 +2309,11 @@ export declare 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
@@ -2517,7 +2340,7 @@ export declare const zipLeft: {
  *
  * **Example** (Composing parsers)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * const parse = (s: string): Option.Option<number> =>
@@ -2528,11 +2351,8 @@ export declare 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
@@ -2557,7 +2377,7 @@ export declare const composeK: {
      *
      * **Example** (Composing parsers)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Option } from "effect"
      *
      * const parse = (s: string): Option.Option<number> =>
@@ -2568,11 +2388,8 @@ export declare 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
@@ -2597,7 +2414,7 @@ export declare const composeK: {
      *
      * **Example** (Composing parsers)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Option } from "effect"
      *
      * const parse = (s: string): Option.Option<number> =>
@@ -2608,11 +2425,8 @@ export declare 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
@@ -2639,17 +2453,14 @@ export declare 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
@@ -2676,17 +2487,14 @@ export declare 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
@@ -2713,17 +2521,14 @@ export declare 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
@@ -2750,14 +2555,11 @@ export declare 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
@@ -2783,17 +2585,14 @@ export declare const product: <A, B>(self: Option<A>, that: Option<B>) => Option
  *
  * **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
@@ -2821,7 +2620,7 @@ export declare const productMany: <A>(self: Option<A>, collection: Iterable<Opti
  *
  * **Example** (Combining a tuple and a struct)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option } from "effect"
  *
  * const maybeName: Option.Option<string> = Option.some("John")
@@ -2829,17 +2628,11 @@ export declare const productMany: <A>(self: Option<A>, collection: Iterable<Opti
  *
  * //      ┌─── 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
@@ -2868,18 +2661,14 @@ export declare const all: <const I extends Iterable<Option<any>> | Record<string
  *
  * **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
@@ -2904,18 +2693,14 @@ export declare 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
@@ -2940,18 +2725,14 @@ export declare 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
@@ -2978,16 +2759,15 @@ export declare 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 declare const reduceCompact: {
@@ -3007,16 +2787,15 @@ export declare 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;
@@ -3036,16 +2815,15 @@ export declare 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;
@@ -3065,14 +2843,11 @@ export declare 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
@@ -3097,7 +2872,7 @@ export declare const toArray: <A>(self: Option<A>) => Array<A>;
  *
  * **Example** (Partitioning by Result)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option, Result } from "effect"
  *
  * const parseNumber = (s: string): Result.Result<number, string> => {
@@ -3105,14 +2880,9 @@ export declare const toArray: <A>(self: Option<A>) => Array<A>;
  *   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
@@ -3137,7 +2907,7 @@ export declare const partitionMap: {
      *
      * **Example** (Partitioning by Result)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Option, Result } from "effect"
      *
      * const parseNumber = (s: string): Result.Result<number, string> => {
@@ -3145,14 +2915,9 @@ export declare 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
@@ -3177,7 +2942,7 @@ export declare const partitionMap: {
      *
      * **Example** (Partitioning by Result)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Option, Result } from "effect"
      *
      * const parseNumber = (s: string): Result.Result<number, string> => {
@@ -3185,14 +2950,9 @@ export declare 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
@@ -3217,14 +2977,13 @@ export declare 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
@@ -3248,14 +3007,13 @@ export declare 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
@@ -3279,14 +3037,13 @@ export declare 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
@@ -3314,20 +3071,15 @@ export declare 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
@@ -3355,20 +3107,15 @@ export declare 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
@@ -3396,20 +3143,15 @@ export declare 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
@@ -3437,20 +3179,15 @@ export declare 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
@@ -3478,20 +3215,15 @@ export declare 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
@@ -3518,19 +3250,14 @@ export declare 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
@@ -3554,19 +3281,14 @@ export declare const makeEquivalence: <A>(isEquivalent: Equivalence.Equivalence<
  *
  * **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
@@ -3588,16 +3310,13 @@ export declare 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
@@ -3626,16 +3345,13 @@ export declare 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`
@@ -3663,16 +3379,13 @@ export declare const liftPredicate: {
      *
      * **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`
@@ -3699,16 +3412,13 @@ export declare const liftPredicate: {
      *
      * **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`
@@ -3735,16 +3445,13 @@ export declare const liftPredicate: {
      *
      * **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`
@@ -3771,24 +3478,19 @@ export declare const liftPredicate: {
  *
  * **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 declare const containsWith: <A>(isEquivalent: (self: A, that: A) => boolean) => {
@@ -3811,23 +3513,18 @@ export declare const containsWith: <A>(isEquivalent: (self: A, that: A) => boole
  *
  * **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 declare const contains: {
@@ -3847,23 +3544,18 @@ export declare 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;
@@ -3883,23 +3575,18 @@ export declare 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;
@@ -3920,25 +3607,20 @@ export declare 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 declare const exists: {
@@ -3958,25 +3640,20 @@ export declare 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>;
@@ -3996,25 +3673,20 @@ export declare 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;
@@ -4034,25 +3706,20 @@ export declare 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>;
@@ -4072,25 +3739,20 @@ export declare 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;
@@ -4106,24 +3768,22 @@ export declare 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 declare const bindTo: {
@@ -4138,24 +3798,22 @@ export declare 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<{
@@ -4172,24 +3830,22 @@ export declare 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<{
@@ -4215,24 +3871,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 };
@@ -4246,25 +3900,23 @@ let_ as let };
  *
  * **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 declare const bind: {
@@ -4278,25 +3930,23 @@ export declare 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<{
@@ -4312,25 +3962,23 @@ export declare 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>(self: Option<A>, name: Exclude<N, keyof A>, f: (a: NoInfer<A>) => Option<B>): Option<{
@@ -4348,25 +3996,23 @@ export declare 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 declare const Do: Option<{}>;
@@ -4387,21 +4033,17 @@ export declare const Do: Option<{}>;
  *
  * **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
@@ -4429,17 +4071,16 @@ export declare const gen: Gen.Gen<OptionTypeLambda>;
  *
  * **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 declare function makeReducer<A>(combiner: Combiner.Combiner<A>): Reducer.Reducer<Option<A>>;
@@ -4460,20 +4101,17 @@ export declare function makeReducer<A>(combiner: Combiner.Combiner<A>): 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 declare function makeCombinerFailFast<A>(combiner: Combiner.Combiner<A>): Combiner.Combiner<Option<A>>;
@@ -4494,21 +4132,18 @@ export declare function makeCombinerFailFast<A>(combiner: Combiner.Combiner<A>):
  *
  * **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 declare function makeReducerFailFast<A>(reducer: Reducer.Reducer<A>): Reducer.Reducer<Option<A>>;