effect 4.0.0-beta.101 → 4.0.0-beta.103

package/dist/SubscriptionRef.d.ts

@@ -97,7 +97,7 @@ export declare 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*() {
@@ -116,13 +116,13 @@ export declare 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 declare const changes: <A>(self: SubscriptionRef<A>) => Stream.Stream<A>;
@@ -142,15 +142,16 @@ export declare const changes: <A>(self: SubscriptionRef<A>) => Stream.Stream<A>;
  *
  * **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
@@ -162,15 +163,16 @@ export declare const getUnsafe: <A>(self: SubscriptionRef<A>) => A;
  *
  * **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
@@ -183,18 +185,18 @@ export declare const get: <A>(self: SubscriptionRef<A>) => Effect.Effect<A>;
  *
  * **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
@@ -207,18 +209,18 @@ export declare 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
@@ -231,18 +233,18 @@ export declare 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
@@ -256,18 +258,18 @@ export declare const getAndSet: {
  *
  * **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
@@ -280,18 +282,18 @@ export declare 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
@@ -304,18 +306,18 @@ export declare 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
@@ -329,7 +331,7 @@ export declare const getAndUpdate: {
  *
  * **Example** (Getting and updating with an effect)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -339,11 +341,11 @@ export declare 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
@@ -356,7 +358,7 @@ export declare const getAndUpdateEffect: {
      *
      * **Example** (Getting and updating with an effect)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -366,11 +368,11 @@ export declare 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
@@ -383,7 +385,7 @@ export declare const getAndUpdateEffect: {
      *
      * **Example** (Getting and updating with an effect)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -393,11 +395,11 @@ export declare 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
@@ -421,7 +423,7 @@ export declare 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*() {
@@ -431,11 +433,11 @@ export declare 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
@@ -458,7 +460,7 @@ export declare 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*() {
@@ -468,11 +470,11 @@ export declare 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
@@ -495,7 +497,7 @@ export declare 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*() {
@@ -505,11 +507,11 @@ export declare 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
@@ -533,7 +535,7 @@ export declare 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*() {
@@ -543,11 +545,11 @@ export declare 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
@@ -570,7 +572,7 @@ export declare 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*() {
@@ -580,11 +582,11 @@ export declare 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
@@ -607,7 +609,7 @@ export declare 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*() {
@@ -617,11 +619,11 @@ export declare 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
@@ -635,7 +637,7 @@ export declare const getAndUpdateSomeEffect: {
  *
  * **Example** (Modifying a value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -645,14 +647,14 @@ export declare 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 declare const modify: {
@@ -662,7 +664,7 @@ export declare const modify: {
      *
      * **Example** (Modifying a value)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -672,14 +674,14 @@ export declare 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>;
@@ -689,7 +691,7 @@ export declare const modify: {
      *
      * **Example** (Modifying a value)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -699,14 +701,14 @@ export declare 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>;
@@ -718,7 +720,7 @@ export declare const modify: {
  *
  * **Example** (Modifying with an effect)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -728,14 +730,14 @@ export declare 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 declare const modifyEffect: {
@@ -746,7 +748,7 @@ export declare const modifyEffect: {
      *
      * **Example** (Modifying with an effect)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -756,14 +758,14 @@ export declare 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>;
@@ -774,7 +776,7 @@ export declare const modifyEffect: {
      *
      * **Example** (Modifying with an effect)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -784,14 +786,14 @@ export declare 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>(self: SubscriptionRef<A>, modify: (a: A) => Effect.Effect<readonly [B, A], E, R>): Effect.Effect<B, E, R>;
@@ -812,7 +814,7 @@ export declare const modifyEffect: {
  *
  * **Example** (Conditionally modifying a value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Option, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -823,14 +825,14 @@ export declare 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 declare const modifySome: {
@@ -850,7 +852,7 @@ export declare const modifySome: {
      *
      * **Example** (Conditionally modifying a value)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, Option, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -861,14 +863,14 @@ export declare 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>;
@@ -888,7 +890,7 @@ export declare const modifySome: {
      *
      * **Example** (Conditionally modifying a value)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, Option, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -899,14 +901,14 @@ export declare 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>;
@@ -927,7 +929,7 @@ export declare const modifySome: {
  *
  * **Example** (Conditionally modifying with an effect)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Option, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -942,14 +944,14 @@ export declare 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 declare const modifySomeEffect: {
@@ -969,7 +971,7 @@ export declare const modifySomeEffect: {
      *
      * **Example** (Conditionally modifying with an effect)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, Option, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -984,14 +986,14 @@ export declare 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>;
@@ -1011,7 +1013,7 @@ export declare const modifySomeEffect: {
      *
      * **Example** (Conditionally modifying with an effect)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, Option, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -1026,14 +1028,14 @@ export declare 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>(self: SubscriptionRef<A>, modify: (a: A) => Effect.Effect<readonly [B, Option.Option<A>], E, R>): Effect.Effect<B, E, R>;
@@ -1044,7 +1046,7 @@ export declare const modifySomeEffect: {
  *
  * **Example** (Setting a value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1052,12 +1054,13 @@ export declare 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 declare const set: {
@@ -1067,7 +1070,7 @@ export declare const set: {
      *
      * **Example** (Setting a value)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -1075,12 +1078,13 @@ export declare 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>;
@@ -1090,7 +1094,7 @@ export declare const set: {
      *
      * **Example** (Setting a value)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -1098,12 +1102,13 @@ export declare 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>;
@@ -1114,18 +1119,19 @@ export declare 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 declare const setAndGet: {
@@ -1135,18 +1141,19 @@ export declare 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>;
@@ -1156,18 +1163,19 @@ export declare 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>;
@@ -1178,7 +1186,7 @@ export declare const setAndGet: {
  *
  * **Example** (Updating a value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1186,12 +1194,13 @@ export declare 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 declare const update: {
@@ -1201,7 +1210,7 @@ export declare const update: {
      *
      * **Example** (Updating a value)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -1209,12 +1218,13 @@ export declare 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>;
@@ -1224,7 +1234,7 @@ export declare const update: {
      *
      * **Example** (Updating a value)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -1232,12 +1242,13 @@ export declare 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>;
@@ -1248,7 +1259,7 @@ export declare const update: {
  *
  * **Example** (Updating with an effect)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1256,12 +1267,13 @@ export declare 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 declare const updateEffect: {
@@ -1271,7 +1283,7 @@ export declare const updateEffect: {
      *
      * **Example** (Updating with an effect)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -1279,12 +1291,13 @@ export declare 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>;
@@ -1294,7 +1307,7 @@ export declare const updateEffect: {
      *
      * **Example** (Updating with an effect)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -1302,12 +1315,13 @@ export declare 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>;
@@ -1318,18 +1332,19 @@ export declare 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 declare const updateAndGet: {
@@ -1339,18 +1354,19 @@ export declare 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>;
@@ -1360,18 +1376,19 @@ export declare 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>;
@@ -1383,21 +1400,22 @@ export declare 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 declare const updateAndGetEffect: {
@@ -1408,21 +1426,22 @@ export declare 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>;
@@ -1433,21 +1452,22 @@ export declare 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>;
@@ -1459,7 +1479,7 @@ export declare const updateAndGetEffect: {
  *
  * **Example** (Conditionally updating a value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Option, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1470,12 +1490,13 @@ export declare 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 declare const updateSome: {
@@ -1486,7 +1507,7 @@ export declare const updateSome: {
      *
      * **Example** (Conditionally updating a value)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, Option, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -1497,12 +1518,13 @@ export declare 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>;
@@ -1513,7 +1535,7 @@ export declare const updateSome: {
      *
      * **Example** (Conditionally updating a value)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, Option, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -1524,12 +1546,13 @@ export declare 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>;
@@ -1550,7 +1573,7 @@ export declare const updateSome: {
  *
  * **Example** (Conditionally updating with an effect)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Option, SubscriptionRef } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1561,12 +1584,13 @@ export declare 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 declare const updateSomeEffect: {
@@ -1586,7 +1610,7 @@ export declare const updateSomeEffect: {
      *
      * **Example** (Conditionally updating with an effect)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, Option, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -1597,12 +1621,13 @@ export declare 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>;
@@ -1622,7 +1647,7 @@ export declare const updateSomeEffect: {
      *
      * **Example** (Conditionally updating with an effect)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, Option, SubscriptionRef } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -1633,12 +1658,13 @@ export declare 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>(self: SubscriptionRef<A>, update: (a: A) => Effect.Effect<Option.Option<A>, E, R>): Effect.Effect<void, E, R>;
@@ -1659,21 +1685,22 @@ export declare 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 declare const updateSomeAndGet: {
@@ -1693,21 +1720,22 @@ export declare 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>;
@@ -1727,21 +1755,22 @@ export declare 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>;
@@ -1762,21 +1791,22 @@ export declare 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 declare const updateSomeAndGetEffect: {
@@ -1796,21 +1826,22 @@ export declare 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>;
@@ -1830,21 +1861,22 @@ export declare 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>(self: SubscriptionRef<A>, update: (a: A) => Effect.Effect<Option.Option<A>, E, R>): Effect.Effect<A, E, R>;