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

package/src/SubscriptionRef.ts

@@ -129,7 +129,7 @@ export const make = <A>(value: A): Effect.Effect<SubscriptionRef<A>> =>
  *
  * **Example** (Streaming changes)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Deferred, Effect, Fiber, Stream, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -148,13 +148,13 @@ export const make = <A>(value: A): Effect.Effect<SubscriptionRef<A>> =>
  *   yield* SubscriptionRef.set(ref, 2)
  *
  *   const values = yield* Fiber.join(fiber)
- *   console.log(values) // [ 0, 1, 2 ]
+ *   return Array.from(values)
  * })
  *
- * Effect.runPromise(program)
+ * await Effect.runPromise(program) // => [0, 1, 2]
  * ```
  *
- * @category changes
+ * @category subscriptions
  * @since 4.0.0
  */
 export const changes = <A>(self: SubscriptionRef<A>): Stream.Stream<A> => Stream.fromPubSub(self.pubsub)
@@ -175,15 +175,16 @@ export const changes = <A>(self: SubscriptionRef<A>): Stream.Stream<A> => Stream
  *
  * **Example** (Reading the current value unsafely)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const ref = yield* SubscriptionRef.make(42)
  *
- *   const value = SubscriptionRef.getUnsafe(ref)
- *   console.log(value)
+ *   return SubscriptionRef.getUnsafe(ref)
  * })
+ *
+ * await Effect.runPromise(program) // => 42
  * ```
  *
  * @category getters
@@ -196,15 +197,16 @@ export const getUnsafe = <A>(self: SubscriptionRef<A>): A => self.value
  *
  * **Example** (Reading the current value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const ref = yield* SubscriptionRef.make(42)
  *
- *   const value = yield* SubscriptionRef.get(ref)
- *   console.log(value)
+ *   return yield* SubscriptionRef.get(ref)
  * })
+ *
+ * await Effect.runPromise(program) // => 42
  * ```
  *
  * @category getters
@@ -218,18 +220,18 @@ export const get = <A>(self: SubscriptionRef<A>): Effect.Effect<A> => Effect.syn
  *
  * **Example** (Getting and setting a value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const ref = yield* SubscriptionRef.make(10)
  *
  *   const oldValue = yield* SubscriptionRef.getAndSet(ref, 20)
- *   console.log("Old value:", oldValue)
- *
  *   const newValue = yield* SubscriptionRef.get(ref)
- *   console.log("New value:", newValue)
+ *   return [oldValue, newValue]
  * })
+ *
+ * await Effect.runPromise(program) // => [10, 20]
  * ```
  *
  * @category getters
@@ -242,18 +244,18 @@ export const getAndSet: {
    *
    * **Example** (Getting and setting a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
    *   const ref = yield* SubscriptionRef.make(10)
    *
    *   const oldValue = yield* SubscriptionRef.getAndSet(ref, 20)
-   *   console.log("Old value:", oldValue)
-   *
    *   const newValue = yield* SubscriptionRef.get(ref)
-   *   console.log("New value:", newValue)
+   *   return [oldValue, newValue]
    * })
+   *
+   * await Effect.runPromise(program) // => [10, 20]
    * ```
    *
    * @category getters
@@ -266,18 +268,18 @@ export const getAndSet: {
    *
    * **Example** (Getting and setting a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
    *   const ref = yield* SubscriptionRef.make(10)
    *
    *   const oldValue = yield* SubscriptionRef.getAndSet(ref, 20)
-   *   console.log("Old value:", oldValue)
-   *
    *   const newValue = yield* SubscriptionRef.get(ref)
-   *   console.log("New value:", newValue)
+   *   return [oldValue, newValue]
    * })
+   *
+   * await Effect.runPromise(program) // => [10, 20]
    * ```
    *
    * @category getters
@@ -302,18 +304,18 @@ const setUnsafe = <A>(self: SubscriptionRef<A>, value: A) => {
  *
  * **Example** (Getting and updating a value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const ref = yield* SubscriptionRef.make(10)
  *
  *   const oldValue = yield* SubscriptionRef.getAndUpdate(ref, (n) => n * 2)
- *   console.log("Old value:", oldValue)
- *
  *   const newValue = yield* SubscriptionRef.get(ref)
- *   console.log("New value:", newValue)
+ *   return [oldValue, newValue]
  * })
+ *
+ * await Effect.runPromise(program) // => [10, 20]
  * ```
  *
  * @category getters
@@ -326,18 +328,18 @@ export const getAndUpdate: {
    *
    * **Example** (Getting and updating a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
    *   const ref = yield* SubscriptionRef.make(10)
    *
    *   const oldValue = yield* SubscriptionRef.getAndUpdate(ref, (n) => n * 2)
-   *   console.log("Old value:", oldValue)
-   *
    *   const newValue = yield* SubscriptionRef.get(ref)
-   *   console.log("New value:", newValue)
+   *   return [oldValue, newValue]
    * })
+   *
+   * await Effect.runPromise(program) // => [10, 20]
    * ```
    *
    * @category getters
@@ -350,18 +352,18 @@ export const getAndUpdate: {
    *
    * **Example** (Getting and updating a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
    *   const ref = yield* SubscriptionRef.make(10)
    *
    *   const oldValue = yield* SubscriptionRef.getAndUpdate(ref, (n) => n * 2)
-   *   console.log("Old value:", oldValue)
-   *
    *   const newValue = yield* SubscriptionRef.get(ref)
-   *   console.log("New value:", newValue)
+   *   return [oldValue, newValue]
    * })
+   *
+   * await Effect.runPromise(program) // => [10, 20]
    * ```
    *
    * @category getters
@@ -382,7 +384,7 @@ export const getAndUpdate: {
  *
  * **Example** (Getting and updating with an effect)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -392,11 +394,11 @@ export const getAndUpdate: {
  *     ref,
  *     (n) => Effect.succeed(n + 5)
  *   )
- *   console.log("Old value:", oldValue)
- *
  *   const newValue = yield* SubscriptionRef.get(ref)
- *   console.log("New value:", newValue)
+ *   return [oldValue, newValue]
  * })
+ *
+ * await Effect.runPromise(program) // => [10, 15]
  * ```
  *
  * @category getters
@@ -409,7 +411,7 @@ export const getAndUpdateEffect: {
    *
    * **Example** (Getting and updating with an effect)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -419,11 +421,11 @@ export const getAndUpdateEffect: {
    *     ref,
    *     (n) => Effect.succeed(n + 5)
    *   )
-   *   console.log("Old value:", oldValue)
-   *
    *   const newValue = yield* SubscriptionRef.get(ref)
-   *   console.log("New value:", newValue)
+   *   return [oldValue, newValue]
    * })
+   *
+   * await Effect.runPromise(program) // => [10, 15]
    * ```
    *
    * @category getters
@@ -436,7 +438,7 @@ export const getAndUpdateEffect: {
    *
    * **Example** (Getting and updating with an effect)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -446,11 +448,11 @@ export const getAndUpdateEffect: {
    *     ref,
    *     (n) => Effect.succeed(n + 5)
    *   )
-   *   console.log("Old value:", oldValue)
-   *
    *   const newValue = yield* SubscriptionRef.get(ref)
-   *   console.log("New value:", newValue)
+   *   return [oldValue, newValue]
    * })
+   *
+   * await Effect.runPromise(program) // => [10, 15]
    * ```
    *
    * @category getters
@@ -461,7 +463,7 @@ export const getAndUpdateEffect: {
   self: SubscriptionRef<A>,
   update: (a: A) => Effect.Effect<A, E, R>
 ) =>
-  self.semaphore.withPermit(Effect.sync(() => {
+  self.semaphore.withPermit(Effect.suspend(() => {
     const current = self.value
     return Effect.map(update(current), (newValue) => {
       setUnsafe(self, newValue)
@@ -485,7 +487,7 @@ export const getAndUpdateEffect: {
  *
  * **Example** (Getting and conditionally updating a value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Option, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -495,11 +497,11 @@ export const getAndUpdateEffect: {
  *     ref,
  *     (n) => n > 5 ? Option.some(n * 2) : Option.none()
  *   )
- *   console.log("Old value:", oldValue)
- *
  *   const newValue = yield* SubscriptionRef.get(ref)
- *   console.log("New value:", newValue)
+ *   return [oldValue, newValue]
  * })
+ *
+ * await Effect.runPromise(program) // => [10, 20]
  * ```
  *
  * @category getters
@@ -522,7 +524,7 @@ export const getAndUpdateSome: {
    *
    * **Example** (Getting and conditionally updating a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, Option, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -532,11 +534,11 @@ export const getAndUpdateSome: {
    *     ref,
    *     (n) => n > 5 ? Option.some(n * 2) : Option.none()
    *   )
-   *   console.log("Old value:", oldValue)
-   *
    *   const newValue = yield* SubscriptionRef.get(ref)
-   *   console.log("New value:", newValue)
+   *   return [oldValue, newValue]
    * })
+   *
+   * await Effect.runPromise(program) // => [10, 20]
    * ```
    *
    * @category getters
@@ -559,7 +561,7 @@ export const getAndUpdateSome: {
    *
    * **Example** (Getting and conditionally updating a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, Option, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -569,11 +571,11 @@ export const getAndUpdateSome: {
    *     ref,
    *     (n) => n > 5 ? Option.some(n * 2) : Option.none()
    *   )
-   *   console.log("Old value:", oldValue)
-   *
    *   const newValue = yield* SubscriptionRef.get(ref)
-   *   console.log("New value:", newValue)
+   *   return [oldValue, newValue]
    * })
+   *
+   * await Effect.runPromise(program) // => [10, 20]
    * ```
    *
    * @category getters
@@ -588,7 +590,7 @@ export const getAndUpdateSome: {
     const current = self.value
     const option = update(current)
     if (Option.isNone(option)) {
-      return Effect.succeed(current)
+      return current
     }
     setUnsafe(self, option.value)
     return current
@@ -610,7 +612,7 @@ export const getAndUpdateSome: {
  *
  * **Example** (Getting and conditionally updating with an effect)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Option, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -620,11 +622,11 @@ export const getAndUpdateSome: {
  *     ref,
  *     (n) => Effect.succeed(n > 5 ? Option.some(n + 3) : Option.none())
  *   )
- *   console.log("Old value:", oldValue)
- *
  *   const newValue = yield* SubscriptionRef.get(ref)
- *   console.log("New value:", newValue)
+ *   return [oldValue, newValue]
  * })
+ *
+ * await Effect.runPromise(program) // => [10, 13]
  * ```
  *
  * @category getters
@@ -647,7 +649,7 @@ export const getAndUpdateSomeEffect: {
    *
    * **Example** (Getting and conditionally updating with an effect)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, Option, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -657,11 +659,11 @@ export const getAndUpdateSomeEffect: {
    *     ref,
    *     (n) => Effect.succeed(n > 5 ? Option.some(n + 3) : Option.none())
    *   )
-   *   console.log("Old value:", oldValue)
-   *
    *   const newValue = yield* SubscriptionRef.get(ref)
-   *   console.log("New value:", newValue)
+   *   return [oldValue, newValue]
    * })
+   *
+   * await Effect.runPromise(program) // => [10, 13]
    * ```
    *
    * @category getters
@@ -684,7 +686,7 @@ export const getAndUpdateSomeEffect: {
    *
    * **Example** (Getting and conditionally updating with an effect)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, Option, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -694,11 +696,11 @@ export const getAndUpdateSomeEffect: {
    *     ref,
    *     (n) => Effect.succeed(n > 5 ? Option.some(n + 3) : Option.none())
    *   )
-   *   console.log("Old value:", oldValue)
-   *
    *   const newValue = yield* SubscriptionRef.get(ref)
-   *   console.log("New value:", newValue)
+   *   return [oldValue, newValue]
    * })
+   *
+   * await Effect.runPromise(program) // => [10, 13]
    * ```
    *
    * @category getters
@@ -727,7 +729,7 @@ export const getAndUpdateSomeEffect: {
  *
  * **Example** (Modifying a value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -737,14 +739,14 @@ export const getAndUpdateSomeEffect: {
  *     `Old value was ${n}`,
  *     n * 2
  *   ])
- *   console.log(result)
- *
  *   const newValue = yield* SubscriptionRef.get(ref)
- *   console.log("New value:", newValue)
+ *   return [result, newValue]
  * })
+ *
+ * await Effect.runPromise(program) // => ["Old value was 10", 20]
  * ```
  *
- * @category modifications
+ * @category mutations
  * @since 2.0.0
  */
 export const modify: {
@@ -754,7 +756,7 @@ export const modify: {
    *
    * **Example** (Modifying a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -764,14 +766,14 @@ export const modify: {
    *     `Old value was ${n}`,
    *     n * 2
    *   ])
-   *   console.log(result)
-   *
    *   const newValue = yield* SubscriptionRef.get(ref)
-   *   console.log("New value:", newValue)
+   *   return [result, newValue]
    * })
+   *
+   * await Effect.runPromise(program) // => ["Old value was 10", 20]
    * ```
    *
-   * @category modifications
+   * @category mutations
    * @since 2.0.0
    */
   <A, B>(modify: (a: A) => readonly [B, A]): (self: SubscriptionRef<A>) => Effect.Effect<B>
@@ -781,7 +783,7 @@ export const modify: {
    *
    * **Example** (Modifying a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -791,14 +793,14 @@ export const modify: {
    *     `Old value was ${n}`,
    *     n * 2
    *   ])
-   *   console.log(result)
-   *
    *   const newValue = yield* SubscriptionRef.get(ref)
-   *   console.log("New value:", newValue)
+   *   return [result, newValue]
    * })
+   *
+   * await Effect.runPromise(program) // => ["Old value was 10", 20]
    * ```
    *
-   * @category modifications
+   * @category mutations
    * @since 2.0.0
    */
   <A, B>(self: SubscriptionRef<A>, f: (a: A) => readonly [B, A]): Effect.Effect<B>
@@ -819,7 +821,7 @@ export const modify: {
  *
  * **Example** (Modifying with an effect)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -829,14 +831,14 @@ export const modify: {
  *     ref,
  *     (n) => Effect.succeed([`Doubled from ${n}`, n * 2] as const)
  *   )
- *   console.log(result)
- *
  *   const newValue = yield* SubscriptionRef.get(ref)
- *   console.log("New value:", newValue)
+ *   return [result, newValue]
  * })
+ *
+ * await Effect.runPromise(program) // => ["Doubled from 10", 20]
  * ```
  *
- * @category modifications
+ * @category mutations
  * @since 2.0.0
  */
 export const modifyEffect: {
@@ -847,7 +849,7 @@ export const modifyEffect: {
    *
    * **Example** (Modifying with an effect)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -857,14 +859,14 @@ export const modifyEffect: {
    *     ref,
    *     (n) => Effect.succeed([`Doubled from ${n}`, n * 2] as const)
    *   )
-   *   console.log(result)
-   *
    *   const newValue = yield* SubscriptionRef.get(ref)
-   *   console.log("New value:", newValue)
+   *   return [result, newValue]
    * })
+   *
+   * await Effect.runPromise(program) // => ["Doubled from 10", 20]
    * ```
    *
-   * @category modifications
+   * @category mutations
    * @since 2.0.0
    */
   <B, A, E, R>(modify: (a: A) => Effect.Effect<readonly [B, A], E, R>): (self: SubscriptionRef<A>) => Effect.Effect<B, E, R>
@@ -875,7 +877,7 @@ export const modifyEffect: {
    *
    * **Example** (Modifying with an effect)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -885,14 +887,14 @@ export const modifyEffect: {
    *     ref,
    *     (n) => Effect.succeed([`Doubled from ${n}`, n * 2] as const)
    *   )
-   *   console.log(result)
-   *
    *   const newValue = yield* SubscriptionRef.get(ref)
-   *   console.log("New value:", newValue)
+   *   return [result, newValue]
    * })
+   *
+   * await Effect.runPromise(program) // => ["Doubled from 10", 20]
    * ```
    *
-   * @category modifications
+   * @category mutations
    * @since 2.0.0
    */
   <A, B, E, R>(
@@ -926,7 +928,7 @@ export const modifyEffect: {
  *
  * **Example** (Conditionally modifying a value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Option, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -937,14 +939,14 @@ export const modifyEffect: {
  *     (n) =>
  *       n > 5 ? ["Updated", Option.some(n * 2)] : ["Not updated", Option.none()]
  *   )
- *   console.log(result)
- *
  *   const newValue = yield* SubscriptionRef.get(ref)
- *   console.log("New value:", newValue)
+ *   return [result, newValue]
  * })
+ *
+ * await Effect.runPromise(program) // => ["Updated", 20]
  * ```
  *
- * @category modifications
+ * @category mutations
  * @since 2.0.0
  */
 export const modifySome: {
@@ -964,7 +966,7 @@ export const modifySome: {
    *
    * **Example** (Conditionally modifying a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, Option, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -975,14 +977,14 @@ export const modifySome: {
    *     (n) =>
    *       n > 5 ? ["Updated", Option.some(n * 2)] : ["Not updated", Option.none()]
    *   )
-   *   console.log(result)
-   *
    *   const newValue = yield* SubscriptionRef.get(ref)
-   *   console.log("New value:", newValue)
+   *   return [result, newValue]
    * })
+   *
+   * await Effect.runPromise(program) // => ["Updated", 20]
    * ```
    *
-   * @category modifications
+   * @category mutations
    * @since 2.0.0
    */
   <B, A>(modify: (a: A) => readonly [B, Option.Option<A>]): (self: SubscriptionRef<A>) => Effect.Effect<B>
@@ -1002,7 +1004,7 @@ export const modifySome: {
    *
    * **Example** (Conditionally modifying a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, Option, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1013,14 +1015,14 @@ export const modifySome: {
    *     (n) =>
    *       n > 5 ? ["Updated", Option.some(n * 2)] : ["Not updated", Option.none()]
    *   )
-   *   console.log(result)
-   *
    *   const newValue = yield* SubscriptionRef.get(ref)
-   *   console.log("New value:", newValue)
+   *   return [result, newValue]
    * })
+   *
+   * await Effect.runPromise(program) // => ["Updated", 20]
    * ```
    *
-   * @category modifications
+   * @category mutations
    * @since 2.0.0
    */
   <A, B>(self: SubscriptionRef<A>, modify: (a: A) => readonly [B, Option.Option<A>]): Effect.Effect<B>
@@ -1051,7 +1053,7 @@ export const modifySome: {
  *
  * **Example** (Conditionally modifying with an effect)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Option, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1066,14 +1068,14 @@ export const modifySome: {
  *           : (["Not updated", Option.none()] as const)
  *       )
  *   )
- *   console.log(result)
- *
  *   const newValue = yield* SubscriptionRef.get(ref)
- *   console.log("New value:", newValue)
+ *   return [result, newValue]
  * })
+ *
+ * await Effect.runPromise(program) // => ["Updated", 15]
  * ```
  *
- * @category modifications
+ * @category mutations
  * @since 2.0.0
  */
 export const modifySomeEffect: {
@@ -1093,7 +1095,7 @@ export const modifySomeEffect: {
    *
    * **Example** (Conditionally modifying with an effect)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, Option, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1108,14 +1110,14 @@ export const modifySomeEffect: {
    *           : (["Not updated", Option.none()] as const)
    *       )
    *   )
-   *   console.log(result)
-   *
    *   const newValue = yield* SubscriptionRef.get(ref)
-   *   console.log("New value:", newValue)
+   *   return [result, newValue]
    * })
+   *
+   * await Effect.runPromise(program) // => ["Updated", 15]
    * ```
    *
-   * @category modifications
+   * @category mutations
    * @since 2.0.0
    */
   <A, B, R, E>(modify: (a: A) => Effect.Effect<readonly [B, Option.Option<A>], E, R>): (self: SubscriptionRef<A>) => Effect.Effect<B, E, R>
@@ -1135,7 +1137,7 @@ export const modifySomeEffect: {
    *
    * **Example** (Conditionally modifying with an effect)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, Option, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1150,14 +1152,14 @@ export const modifySomeEffect: {
    *           : (["Not updated", Option.none()] as const)
    *       )
    *   )
-   *   console.log(result)
-   *
    *   const newValue = yield* SubscriptionRef.get(ref)
-   *   console.log("New value:", newValue)
+   *   return [result, newValue]
    * })
+   *
+   * await Effect.runPromise(program) // => ["Updated", 15]
    * ```
    *
-   * @category modifications
+   * @category mutations
    * @since 2.0.0
    */
   <A, B, R, E>(
@@ -1182,7 +1184,7 @@ export const modifySomeEffect: {
  *
  * **Example** (Setting a value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1190,12 +1192,13 @@ export const modifySomeEffect: {
  *
  *   yield* SubscriptionRef.set(ref, 42)
  *
- *   const value = yield* SubscriptionRef.get(ref)
- *   console.log(value)
+ *   return yield* SubscriptionRef.get(ref)
  * })
+ *
+ * await Effect.runPromise(program) // => 42
  * ```
  *
- * @category setters
+ * @category mutations
  * @since 2.0.0
  */
 export const set: {
@@ -1205,7 +1208,7 @@ export const set: {
    *
    * **Example** (Setting a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1213,12 +1216,13 @@ export const set: {
    *
    *   yield* SubscriptionRef.set(ref, 42)
    *
-   *   const value = yield* SubscriptionRef.get(ref)
-   *   console.log(value)
+   *   return yield* SubscriptionRef.get(ref)
    * })
+   *
+   * await Effect.runPromise(program) // => 42
    * ```
    *
-   * @category setters
+   * @category mutations
    * @since 2.0.0
    */
   <A>(value: A): (self: SubscriptionRef<A>) => Effect.Effect<void>
@@ -1228,7 +1232,7 @@ export const set: {
    *
    * **Example** (Setting a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1236,12 +1240,13 @@ export const set: {
    *
    *   yield* SubscriptionRef.set(ref, 42)
    *
-   *   const value = yield* SubscriptionRef.get(ref)
-   *   console.log(value)
+   *   return yield* SubscriptionRef.get(ref)
    * })
+   *
+   * await Effect.runPromise(program) // => 42
    * ```
    *
-   * @category setters
+   * @category mutations
    * @since 2.0.0
    */
   <A>(self: SubscriptionRef<A>, value: A): Effect.Effect<void>
@@ -1256,18 +1261,19 @@ export const set: {
  *
  * **Example** (Setting and reading the new value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const ref = yield* SubscriptionRef.make(0)
  *
- *   const newValue = yield* SubscriptionRef.setAndGet(ref, 42)
- *   console.log("New value:", newValue)
+ *   return yield* SubscriptionRef.setAndGet(ref, 42)
  * })
+ *
+ * await Effect.runPromise(program) // => 42
  * ```
  *
- * @category setters
+ * @category mutations
  * @since 2.0.0
  */
 export const setAndGet: {
@@ -1277,18 +1283,19 @@ export const setAndGet: {
    *
    * **Example** (Setting and reading the new value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
    *   const ref = yield* SubscriptionRef.make(0)
    *
-   *   const newValue = yield* SubscriptionRef.setAndGet(ref, 42)
-   *   console.log("New value:", newValue)
+   *   return yield* SubscriptionRef.setAndGet(ref, 42)
    * })
+   *
+   * await Effect.runPromise(program) // => 42
    * ```
    *
-   * @category setters
+   * @category mutations
    * @since 2.0.0
    */
   <A>(value: A): (self: SubscriptionRef<A>) => Effect.Effect<A>
@@ -1298,18 +1305,19 @@ export const setAndGet: {
    *
    * **Example** (Setting and reading the new value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
    *   const ref = yield* SubscriptionRef.make(0)
    *
-   *   const newValue = yield* SubscriptionRef.setAndGet(ref, 42)
-   *   console.log("New value:", newValue)
+   *   return yield* SubscriptionRef.setAndGet(ref, 42)
    * })
+   *
+   * await Effect.runPromise(program) // => 42
    * ```
    *
-   * @category setters
+   * @category mutations
    * @since 2.0.0
    */
   <A>(self: SubscriptionRef<A>, value: A): Effect.Effect<A>
@@ -1325,7 +1333,7 @@ export const setAndGet: {
  *
  * **Example** (Updating a value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1333,12 +1341,13 @@ export const setAndGet: {
  *
  *   yield* SubscriptionRef.update(ref, (n) => n * 2)
  *
- *   const value = yield* SubscriptionRef.get(ref)
- *   console.log(value)
+ *   return yield* SubscriptionRef.get(ref)
  * })
+ *
+ * await Effect.runPromise(program) // => 20
  * ```
  *
- * @category updating
+ * @category mutations
  * @since 2.0.0
  */
 export const update: {
@@ -1348,7 +1357,7 @@ export const update: {
    *
    * **Example** (Updating a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1356,12 +1365,13 @@ export const update: {
    *
    *   yield* SubscriptionRef.update(ref, (n) => n * 2)
    *
-   *   const value = yield* SubscriptionRef.get(ref)
-   *   console.log(value)
+   *   return yield* SubscriptionRef.get(ref)
    * })
+   *
+   * await Effect.runPromise(program) // => 20
    * ```
    *
-   * @category updating
+   * @category mutations
    * @since 2.0.0
    */
   <A>(update: (a: A) => A): (self: SubscriptionRef<A>) => Effect.Effect<void>
@@ -1371,7 +1381,7 @@ export const update: {
    *
    * **Example** (Updating a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1379,12 +1389,13 @@ export const update: {
    *
    *   yield* SubscriptionRef.update(ref, (n) => n * 2)
    *
-   *   const value = yield* SubscriptionRef.get(ref)
-   *   console.log(value)
+   *   return yield* SubscriptionRef.get(ref)
    * })
+   *
+   * await Effect.runPromise(program) // => 20
    * ```
    *
-   * @category updating
+   * @category mutations
    * @since 2.0.0
    */
   <A>(self: SubscriptionRef<A>, update: (a: A) => A): Effect.Effect<void>
@@ -1400,7 +1411,7 @@ export const update: {
  *
  * **Example** (Updating with an effect)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1408,12 +1419,13 @@ export const update: {
  *
  *   yield* SubscriptionRef.updateEffect(ref, (n) => Effect.succeed(n + 5))
  *
- *   const value = yield* SubscriptionRef.get(ref)
- *   console.log(value)
+ *   return yield* SubscriptionRef.get(ref)
  * })
+ *
+ * await Effect.runPromise(program) // => 15
  * ```
  *
- * @category updating
+ * @category mutations
  * @since 2.0.0
  */
 export const updateEffect: {
@@ -1423,7 +1435,7 @@ export const updateEffect: {
    *
    * **Example** (Updating with an effect)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1431,12 +1443,13 @@ export const updateEffect: {
    *
    *   yield* SubscriptionRef.updateEffect(ref, (n) => Effect.succeed(n + 5))
    *
-   *   const value = yield* SubscriptionRef.get(ref)
-   *   console.log(value)
+   *   return yield* SubscriptionRef.get(ref)
    * })
+   *
+   * await Effect.runPromise(program) // => 15
    * ```
    *
-   * @category updating
+   * @category mutations
    * @since 2.0.0
    */
   <A, E, R>(update: (a: A) => Effect.Effect<A, E, R>): (self: SubscriptionRef<A>) => Effect.Effect<void, E, R>
@@ -1446,7 +1459,7 @@ export const updateEffect: {
    *
    * **Example** (Updating with an effect)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1454,12 +1467,13 @@ export const updateEffect: {
    *
    *   yield* SubscriptionRef.updateEffect(ref, (n) => Effect.succeed(n + 5))
    *
-   *   const value = yield* SubscriptionRef.get(ref)
-   *   console.log(value)
+   *   return yield* SubscriptionRef.get(ref)
    * })
+   *
+   * await Effect.runPromise(program) // => 15
    * ```
    *
-   * @category updating
+   * @category mutations
    * @since 2.0.0
    */
   <A, E, R>(self: SubscriptionRef<A>, update: (a: A) => Effect.Effect<A, E, R>): Effect.Effect<void, E, R>
@@ -1477,18 +1491,19 @@ export const updateEffect: {
  *
  * **Example** (Updating and reading the new value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const ref = yield* SubscriptionRef.make(10)
  *
- *   const newValue = yield* SubscriptionRef.updateAndGet(ref, (n) => n * 2)
- *   console.log("New value:", newValue)
+ *   return yield* SubscriptionRef.updateAndGet(ref, (n) => n * 2)
  * })
+ *
+ * await Effect.runPromise(program) // => 20
  * ```
  *
- * @category updating
+ * @category mutations
  * @since 2.0.0
  */
 export const updateAndGet: {
@@ -1498,18 +1513,19 @@ export const updateAndGet: {
    *
    * **Example** (Updating and reading the new value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
    *   const ref = yield* SubscriptionRef.make(10)
    *
-   *   const newValue = yield* SubscriptionRef.updateAndGet(ref, (n) => n * 2)
-   *   console.log("New value:", newValue)
+   *   return yield* SubscriptionRef.updateAndGet(ref, (n) => n * 2)
    * })
+   *
+   * await Effect.runPromise(program) // => 20
    * ```
    *
-   * @category updating
+   * @category mutations
    * @since 2.0.0
    */
   <A>(update: (a: A) => A): (self: SubscriptionRef<A>) => Effect.Effect<A>
@@ -1519,18 +1535,19 @@ export const updateAndGet: {
    *
    * **Example** (Updating and reading the new value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
    *   const ref = yield* SubscriptionRef.make(10)
    *
-   *   const newValue = yield* SubscriptionRef.updateAndGet(ref, (n) => n * 2)
-   *   console.log("New value:", newValue)
+   *   return yield* SubscriptionRef.updateAndGet(ref, (n) => n * 2)
    * })
+   *
+   * await Effect.runPromise(program) // => 20
    * ```
    *
-   * @category updating
+   * @category mutations
    * @since 2.0.0
    */
   <A>(self: SubscriptionRef<A>, update: (a: A) => A): Effect.Effect<A>
@@ -1548,21 +1565,22 @@ export const updateAndGet: {
  *
  * **Example** (Updating with an effect and reading the new value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const ref = yield* SubscriptionRef.make(10)
  *
- *   const newValue = yield* SubscriptionRef.updateAndGetEffect(
+ *   return yield* SubscriptionRef.updateAndGetEffect(
  *     ref,
  *     (n) => Effect.succeed(n + 5)
  *   )
- *   console.log("New value:", newValue)
  * })
+ *
+ * await Effect.runPromise(program) // => 15
  * ```
  *
- * @category updating
+ * @category mutations
  * @since 2.0.0
  */
 export const updateAndGetEffect: {
@@ -1573,21 +1591,22 @@ export const updateAndGetEffect: {
    *
    * **Example** (Updating with an effect and reading the new value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
    *   const ref = yield* SubscriptionRef.make(10)
    *
-   *   const newValue = yield* SubscriptionRef.updateAndGetEffect(
+   *   return yield* SubscriptionRef.updateAndGetEffect(
    *     ref,
    *     (n) => Effect.succeed(n + 5)
    *   )
-   *   console.log("New value:", newValue)
    * })
+   *
+   * await Effect.runPromise(program) // => 15
    * ```
    *
-   * @category updating
+   * @category mutations
    * @since 2.0.0
    */
   <A, E, R>(update: (a: A) => Effect.Effect<A, E, R>): (self: SubscriptionRef<A>) => Effect.Effect<A, E, R>
@@ -1598,21 +1617,22 @@ export const updateAndGetEffect: {
    *
    * **Example** (Updating with an effect and reading the new value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
    *   const ref = yield* SubscriptionRef.make(10)
    *
-   *   const newValue = yield* SubscriptionRef.updateAndGetEffect(
+   *   return yield* SubscriptionRef.updateAndGetEffect(
    *     ref,
    *     (n) => Effect.succeed(n + 5)
    *   )
-   *   console.log("New value:", newValue)
    * })
+   *
+   * await Effect.runPromise(program) // => 15
    * ```
    *
-   * @category updating
+   * @category mutations
    * @since 2.0.0
    */
   <A, E, R>(self: SubscriptionRef<A>, update: (a: A) => Effect.Effect<A, E, R>): Effect.Effect<A, E, R>
@@ -1634,7 +1654,7 @@ export const updateAndGetEffect: {
  *
  * **Example** (Conditionally updating a value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Option, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1645,12 +1665,13 @@ export const updateAndGetEffect: {
  *     (n) => n > 5 ? Option.some(n * 2) : Option.none()
  *   )
  *
- *   const value = yield* SubscriptionRef.get(ref)
- *   console.log(value)
+ *   return yield* SubscriptionRef.get(ref)
  * })
+ *
+ * await Effect.runPromise(program) // => 20
  * ```
  *
- * @category updating
+ * @category mutations
  * @since 2.0.0
  */
 export const updateSome: {
@@ -1661,7 +1682,7 @@ export const updateSome: {
    *
    * **Example** (Conditionally updating a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, Option, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1672,12 +1693,13 @@ export const updateSome: {
    *     (n) => n > 5 ? Option.some(n * 2) : Option.none()
    *   )
    *
-   *   const value = yield* SubscriptionRef.get(ref)
-   *   console.log(value)
+   *   return yield* SubscriptionRef.get(ref)
    * })
+   *
+   * await Effect.runPromise(program) // => 20
    * ```
    *
-   * @category updating
+   * @category mutations
    * @since 2.0.0
    */
   <A>(update: (a: A) => Option.Option<A>): (self: SubscriptionRef<A>) => Effect.Effect<void>
@@ -1688,7 +1710,7 @@ export const updateSome: {
    *
    * **Example** (Conditionally updating a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, Option, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1699,12 +1721,13 @@ export const updateSome: {
    *     (n) => n > 5 ? Option.some(n * 2) : Option.none()
    *   )
    *
-   *   const value = yield* SubscriptionRef.get(ref)
-   *   console.log(value)
+   *   return yield* SubscriptionRef.get(ref)
    * })
+   *
+   * await Effect.runPromise(program) // => 20
    * ```
    *
-   * @category updating
+   * @category mutations
    * @since 2.0.0
    */
   <A>(self: SubscriptionRef<A>, update: (a: A) => Option.Option<A>): Effect.Effect<void>
@@ -1734,7 +1757,7 @@ export const updateSome: {
  *
  * **Example** (Conditionally updating with an effect)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Option, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1745,12 +1768,13 @@ export const updateSome: {
  *     (n) => Effect.succeed(n > 5 ? Option.some(n + 3) : Option.none())
  *   )
  *
- *   const value = yield* SubscriptionRef.get(ref)
- *   console.log(value)
+ *   return yield* SubscriptionRef.get(ref)
  * })
+ *
+ * await Effect.runPromise(program) // => 13
  * ```
  *
- * @category updating
+ * @category mutations
  * @since 2.0.0
  */
 export const updateSomeEffect: {
@@ -1770,7 +1794,7 @@ export const updateSomeEffect: {
    *
    * **Example** (Conditionally updating with an effect)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, Option, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1781,12 +1805,13 @@ export const updateSomeEffect: {
    *     (n) => Effect.succeed(n > 5 ? Option.some(n + 3) : Option.none())
    *   )
    *
-   *   const value = yield* SubscriptionRef.get(ref)
-   *   console.log(value)
+   *   return yield* SubscriptionRef.get(ref)
    * })
+   *
+   * await Effect.runPromise(program) // => 13
    * ```
    *
-   * @category updating
+   * @category mutations
    * @since 2.0.0
    */
   <A, E, R>(update: (a: A) => Effect.Effect<Option.Option<A>, E, R>): (self: SubscriptionRef<A>) => Effect.Effect<void, E, R>
@@ -1806,7 +1831,7 @@ export const updateSomeEffect: {
    *
    * **Example** (Conditionally updating with an effect)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, Option, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1817,12 +1842,13 @@ export const updateSomeEffect: {
    *     (n) => Effect.succeed(n > 5 ? Option.some(n + 3) : Option.none())
    *   )
    *
-   *   const value = yield* SubscriptionRef.get(ref)
-   *   console.log(value)
+   *   return yield* SubscriptionRef.get(ref)
    * })
+   *
+   * await Effect.runPromise(program) // => 13
    * ```
    *
-   * @category updating
+   * @category mutations
    * @since 2.0.0
    */
   <A, E, R>(
@@ -1856,21 +1882,22 @@ export const updateSomeEffect: {
  *
  * **Example** (Conditionally updating and reading the new value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Option, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const ref = yield* SubscriptionRef.make(10)
  *
- *   const newValue = yield* SubscriptionRef.updateSomeAndGet(
+ *   return yield* SubscriptionRef.updateSomeAndGet(
  *     ref,
  *     (n) => n > 5 ? Option.some(n * 2) : Option.none()
  *   )
- *   console.log("New value:", newValue)
  * })
+ *
+ * await Effect.runPromise(program) // => 20
  * ```
  *
- * @category updating
+ * @category mutations
  * @since 2.0.0
  */
 export const updateSomeAndGet: {
@@ -1890,21 +1917,22 @@ export const updateSomeAndGet: {
    *
    * **Example** (Conditionally updating and reading the new value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, Option, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
    *   const ref = yield* SubscriptionRef.make(10)
    *
-   *   const newValue = yield* SubscriptionRef.updateSomeAndGet(
+   *   return yield* SubscriptionRef.updateSomeAndGet(
    *     ref,
    *     (n) => n > 5 ? Option.some(n * 2) : Option.none()
    *   )
-   *   console.log("New value:", newValue)
    * })
+   *
+   * await Effect.runPromise(program) // => 20
    * ```
    *
-   * @category updating
+   * @category mutations
    * @since 2.0.0
    */
   <A>(update: (a: A) => Option.Option<A>): (self: SubscriptionRef<A>) => Effect.Effect<A>
@@ -1924,21 +1952,22 @@ export const updateSomeAndGet: {
    *
    * **Example** (Conditionally updating and reading the new value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, Option, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
    *   const ref = yield* SubscriptionRef.make(10)
    *
-   *   const newValue = yield* SubscriptionRef.updateSomeAndGet(
+   *   return yield* SubscriptionRef.updateSomeAndGet(
    *     ref,
    *     (n) => n > 5 ? Option.some(n * 2) : Option.none()
    *   )
-   *   console.log("New value:", newValue)
    * })
+   *
+   * await Effect.runPromise(program) // => 20
    * ```
    *
-   * @category updating
+   * @category mutations
    * @since 2.0.0
    */
   <A>(self: SubscriptionRef<A>, update: (a: A) => Option.Option<A>): Effect.Effect<A>
@@ -1970,21 +1999,22 @@ export const updateSomeAndGet: {
  *
  * **Example** (Conditionally updating with an effect and reading the new value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Option, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const ref = yield* SubscriptionRef.make(10)
  *
- *   const newValue = yield* SubscriptionRef.updateSomeAndGetEffect(
+ *   return yield* SubscriptionRef.updateSomeAndGetEffect(
  *     ref,
  *     (n) => Effect.succeed(n > 5 ? Option.some(n + 3) : Option.none())
  *   )
- *   console.log("New value:", newValue)
  * })
+ *
+ * await Effect.runPromise(program) // => 13
  * ```
  *
- * @category updating
+ * @category mutations
  * @since 2.0.0
  */
 export const updateSomeAndGetEffect: {
@@ -2004,21 +2034,22 @@ export const updateSomeAndGetEffect: {
    *
    * **Example** (Conditionally updating with an effect and reading the new value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, Option, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
    *   const ref = yield* SubscriptionRef.make(10)
    *
-   *   const newValue = yield* SubscriptionRef.updateSomeAndGetEffect(
+   *   return yield* SubscriptionRef.updateSomeAndGetEffect(
    *     ref,
    *     (n) => Effect.succeed(n > 5 ? Option.some(n + 3) : Option.none())
    *   )
-   *   console.log("New value:", newValue)
    * })
+   *
+   * await Effect.runPromise(program) // => 13
    * ```
    *
-   * @category updating
+   * @category mutations
    * @since 2.0.0
    */
   <A, E, R>(update: (a: A) => Effect.Effect<Option.Option<A>, E, R>): (self: SubscriptionRef<A>) => Effect.Effect<A, E, R>
@@ -2038,21 +2069,22 @@ export const updateSomeAndGetEffect: {
    *
    * **Example** (Conditionally updating with an effect and reading the new value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Effect, Option, SubscriptionRef } from "effect"
    *
    * const program = Effect.gen(function*() {
    *   const ref = yield* SubscriptionRef.make(10)
    *
-   *   const newValue = yield* SubscriptionRef.updateSomeAndGetEffect(
+   *   return yield* SubscriptionRef.updateSomeAndGetEffect(
    *     ref,
    *     (n) => Effect.succeed(n > 5 ? Option.some(n + 3) : Option.none())
    *   )
-   *   console.log("New value:", newValue)
    * })
+   *
+   * await Effect.runPromise(program) // => 13
    * ```
    *
-   * @category updating
+   * @category mutations
    * @since 2.0.0
    */
   <A, E, R>(