effect 4.0.0-beta.73 → 4.0.0-beta.75

package/src/SynchronizedRef.ts

@@ -69,7 +69,8 @@ const Proto = {
  *
  * **When to use**
  *
- * Use when synchronous construction is required outside an Effect workflow.
+ * Use when you need synchronous `SynchronizedRef` construction outside an
+ * Effect workflow.
  *
  * @category constructors
  * @since 4.0.0
@@ -86,8 +87,8 @@ export const makeUnsafe = <A>(value: A): SynchronizedRef<A> => {
  *
  * **When to use**
  *
- * Use to create a synchronized reference inside an Effect program when later
- * updates may run effects and must be serialized.
+ * Use to create a `SynchronizedRef` inside an Effect program when later updates
+ * may run effects and must be serialized.
  *
  * **Details**
  *
@@ -146,7 +147,7 @@ export const get = <A>(self: SynchronizedRef<A>): Effect.Effect<A> => Effect.syn
  * @see {@link setAndGet} for setting a value and returning the new value
  * @see {@link getAndUpdate} for deriving the new value from the current value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const getAndSet: {
@@ -163,7 +164,7 @@ export const getAndSet: {
    * @see {@link setAndGet} for setting a value and returning the new value
    * @see {@link getAndUpdate} for deriving the new value from the current value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A>(value: A): (self: SynchronizedRef<A>) => Effect.Effect<A>
@@ -180,7 +181,7 @@ export const getAndSet: {
    * @see {@link setAndGet} for setting a value and returning the new value
    * @see {@link getAndUpdate} for deriving the new value from the current value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A>(self: SynchronizedRef<A>, value: A): Effect.Effect<A>
@@ -196,13 +197,14 @@ export const getAndSet: {
  *
  * **When to use**
  *
- * Use to run a pure state update when the previous stored value is also needed.
+ * Use to run a pure `SynchronizedRef` state update when the previous stored
+ * value is also needed.
  *
  * @see {@link update} for updating without returning a value
  * @see {@link updateAndGet} for updating and returning the new value
  * @see {@link getAndUpdateEffect} for effectful updates that return the previous value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const getAndUpdate: {
@@ -212,13 +214,14 @@ export const getAndUpdate: {
    *
    * **When to use**
    *
-   * Use to run a pure state update when the previous stored value is also needed.
+   * Use to run a pure `SynchronizedRef` state update when the previous stored
+   * value is also needed.
    *
    * @see {@link update} for updating without returning a value
    * @see {@link updateAndGet} for updating and returning the new value
    * @see {@link getAndUpdateEffect} for effectful updates that return the previous value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A>(f: (a: A) => A): (self: SynchronizedRef<A>) => Effect.Effect<A>
@@ -228,13 +231,14 @@ export const getAndUpdate: {
    *
    * **When to use**
    *
-   * Use to run a pure state update when the previous stored value is also needed.
+   * Use to run a pure `SynchronizedRef` state update when the previous stored
+   * value is also needed.
    *
    * @see {@link update} for updating without returning a value
    * @see {@link updateAndGet} for updating and returning the new value
    * @see {@link getAndUpdateEffect} for effectful updates that return the previous value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A>(self: SynchronizedRef<A>, f: (a: A) => A): Effect.Effect<A>
@@ -250,7 +254,8 @@ export const getAndUpdate: {
  *
  * **When to use**
  *
- * Use when an effectful state transition must return the previous stored value.
+ * Use when you need an effectful `SynchronizedRef` state transition to return
+ * the previous stored value.
  *
  * @see {@link getAndUpdate} for pure updates that return the previous value
  * @see {@link updateEffect} for effectful updates without returning a value
@@ -258,7 +263,7 @@ export const getAndUpdate: {
  * @see {@link modifyEffect} for effectful updates with a custom return value
  * @see {@link getAndUpdateSomeEffect} for conditional effectful updates that return the previous value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const getAndUpdateEffect: {
@@ -268,7 +273,8 @@ export const getAndUpdateEffect: {
    *
    * **When to use**
    *
-   * Use when an effectful state transition must return the previous stored value.
+   * Use when you need an effectful `SynchronizedRef` state transition to return
+   * the previous stored value.
    *
    * @see {@link getAndUpdate} for pure updates that return the previous value
    * @see {@link updateEffect} for effectful updates without returning a value
@@ -276,7 +282,7 @@ export const getAndUpdateEffect: {
    * @see {@link modifyEffect} for effectful updates with a custom return value
    * @see {@link getAndUpdateSomeEffect} for conditional effectful updates that return the previous value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, R, E>(f: (a: A) => Effect.Effect<A, E, R>): (self: SynchronizedRef<A>) => Effect.Effect<A, E, R>
@@ -286,7 +292,8 @@ export const getAndUpdateEffect: {
    *
    * **When to use**
    *
-   * Use when an effectful state transition must return the previous stored value.
+   * Use when you need an effectful `SynchronizedRef` state transition to return
+   * the previous stored value.
    *
    * @see {@link getAndUpdate} for pure updates that return the previous value
    * @see {@link updateEffect} for effectful updates without returning a value
@@ -294,7 +301,7 @@ export const getAndUpdateEffect: {
    * @see {@link modifyEffect} for effectful updates with a custom return value
    * @see {@link getAndUpdateSomeEffect} for conditional effectful updates that return the previous value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, R, E>(self: SynchronizedRef<A>, f: (a: A) => Effect.Effect<A, E, R>): Effect.Effect<A, E, R>
@@ -317,12 +324,13 @@ export const getAndUpdateEffect: {
  *
  * **When to use**
  *
- * Use to return the previous value while applying a pure conditional update.
+ * Use to return the previous `SynchronizedRef` value while applying a pure
+ * conditional update.
  *
  * @see {@link getAndUpdate} for always applying a pure update
  * @see {@link updateSome} for applying a pure conditional update without returning the previous value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const getAndUpdateSome: {
@@ -333,12 +341,13 @@ export const getAndUpdateSome: {
    *
    * **When to use**
    *
-   * Use to return the previous value while applying a pure conditional update.
+   * Use to return the previous `SynchronizedRef` value while applying a pure
+   * conditional update.
    *
    * @see {@link getAndUpdate} for always applying a pure update
    * @see {@link updateSome} for applying a pure conditional update without returning the previous value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A>(pf: (a: A) => Option.Option<A>): (self: SynchronizedRef<A>) => Effect.Effect<A>
@@ -349,12 +358,13 @@ export const getAndUpdateSome: {
    *
    * **When to use**
    *
-   * Use to return the previous value while applying a pure conditional update.
+   * Use to return the previous `SynchronizedRef` value while applying a pure
+   * conditional update.
    *
    * @see {@link getAndUpdate} for always applying a pure update
    * @see {@link updateSome} for applying a pure conditional update without returning the previous value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A>(self: SynchronizedRef<A>, pf: (a: A) => Option.Option<A>): Effect.Effect<A>
@@ -371,13 +381,13 @@ export const getAndUpdateSome: {
  *
  * **When to use**
  *
- * Use to return the previous value while running an effectful conditional
- * update.
+ * Use to return the previous `SynchronizedRef` value while running an effectful
+ * conditional update.
  *
  * @see {@link getAndUpdateSome} for the pure conditional variant
  * @see {@link updateSomeEffect} for effectful conditional updates without returning the previous value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const getAndUpdateSomeEffect: {
@@ -388,13 +398,13 @@ export const getAndUpdateSomeEffect: {
    *
    * **When to use**
    *
-   * Use to return the previous value while running an effectful conditional
-   * update.
+   * Use to return the previous `SynchronizedRef` value while running an effectful
+   * conditional update.
    *
    * @see {@link getAndUpdateSome} for the pure conditional variant
    * @see {@link updateSomeEffect} for effectful conditional updates without returning the previous value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, R, E>(pf: (a: A) => Effect.Effect<Option.Option<A>, E, R>): (self: SynchronizedRef<A>) => Effect.Effect<A, E, R>
@@ -405,13 +415,13 @@ export const getAndUpdateSomeEffect: {
    *
    * **When to use**
    *
-   * Use to return the previous value while running an effectful conditional
-   * update.
+   * Use to return the previous `SynchronizedRef` value while running an effectful
+   * conditional update.
    *
    * @see {@link getAndUpdateSome} for the pure conditional variant
    * @see {@link updateSomeEffect} for effectful conditional updates without returning the previous value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, R, E>(
@@ -439,14 +449,14 @@ export const getAndUpdateSomeEffect: {
  *
  * **When to use**
  *
- * Use to derive a separate result and the next stored value from the same
- * current value in one serialized pure update.
+ * Use to derive a separate result and the next stored `SynchronizedRef` value
+ * from the same current value in one serialized pure update.
  *
  * @see {@link modifyEffect} for effectfully deriving both the result and next stored value
  * @see {@link modifySome} for deriving a result and optionally updating the stored value
  * @see {@link updateAndGet} for returning the new stored value instead of a separate result
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const modify: {
@@ -456,14 +466,14 @@ export const modify: {
    *
    * **When to use**
    *
-   * Use to derive a separate result and the next stored value from the same
-   * current value in one serialized pure update.
+   * Use to derive a separate result and the next stored `SynchronizedRef` value
+   * from the same current value in one serialized pure update.
    *
    * @see {@link modifyEffect} for effectfully deriving both the result and next stored value
    * @see {@link modifySome} for deriving a result and optionally updating the stored value
    * @see {@link updateAndGet} for returning the new stored value instead of a separate result
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, B>(f: (a: A) => readonly [B, A]): (self: SynchronizedRef<A>) => Effect.Effect<B>
@@ -473,14 +483,14 @@ export const modify: {
    *
    * **When to use**
    *
-   * Use to derive a separate result and the next stored value from the same
-   * current value in one serialized pure update.
+   * Use to derive a separate result and the next stored `SynchronizedRef` value
+   * from the same current value in one serialized pure update.
    *
    * @see {@link modifyEffect} for effectfully deriving both the result and next stored value
    * @see {@link modifySome} for deriving a result and optionally updating the stored value
    * @see {@link updateAndGet} for returning the new stored value instead of a separate result
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, B>(self: SynchronizedRef<A>, f: (a: A) => readonly [B, A]): Effect.Effect<B>
@@ -497,12 +507,12 @@ export const modify: {
  * **When to use**
  *
  * Use to effectfully compute both a separate return value and the next stored
- * value in one serialized update.
+ * `SynchronizedRef` value in one serialized update.
  *
  * @see {@link modify} for the pure variant
  * @see {@link updateEffect} for effectfully storing a new value without a separate result
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const modifyEffect: {
@@ -513,12 +523,12 @@ export const modifyEffect: {
    * **When to use**
    *
    * Use to effectfully compute both a separate return value and the next stored
-   * value in one serialized update.
+   * `SynchronizedRef` value in one serialized update.
    *
    * @see {@link modify} for the pure variant
    * @see {@link updateEffect} for effectfully storing a new value without a separate result
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, B, E, R>(f: (a: A) => Effect.Effect<readonly [B, A], E, R>): (self: SynchronizedRef<A>) => Effect.Effect<B, E, R>
@@ -529,12 +539,12 @@ export const modifyEffect: {
    * **When to use**
    *
    * Use to effectfully compute both a separate return value and the next stored
-   * value in one serialized update.
+   * `SynchronizedRef` value in one serialized update.
    *
    * @see {@link modify} for the pure variant
    * @see {@link updateEffect} for effectfully storing a new value without a separate result
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, B, E, R>(
@@ -559,12 +569,13 @@ export const modifyEffect: {
  *
  * **When to use**
  *
- * Use to compute a return value while optionally updating the stored value.
+ * Use to compute a return value while optionally updating a `SynchronizedRef`
+ * under its semaphore.
  *
  * @see {@link modify} for always storing a new value
  * @see {@link updateSome} for optional updates without a separate return value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const modifySome: {
@@ -574,12 +585,13 @@ export const modifySome: {
    *
    * **When to use**
    *
-   * Use to compute a return value while optionally updating the stored value.
+   * Use to compute a return value while optionally updating a `SynchronizedRef`
+   * under its semaphore.
    *
    * @see {@link modify} for always storing a new value
    * @see {@link updateSome} for optional updates without a separate return value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <B, A>(pf: (a: A) => readonly [B, Option.Option<A>]): (self: SynchronizedRef<A>) => Effect.Effect<B>
@@ -589,12 +601,13 @@ export const modifySome: {
    *
    * **When to use**
    *
-   * Use to compute a return value while optionally updating the stored value.
+   * Use to compute a return value while optionally updating a `SynchronizedRef`
+   * under its semaphore.
    *
    * @see {@link modify} for always storing a new value
    * @see {@link updateSome} for optional updates without a separate return value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, B>(self: SynchronizedRef<A>, pf: (a: A) => readonly [B, Option.Option<A>]): Effect.Effect<B>
@@ -614,12 +627,12 @@ export const modifySome: {
  * **When to use**
  *
  * Use to effectfully compute a return value while optionally updating the
- * stored value.
+ * stored `SynchronizedRef` value.
  *
  * @see {@link modifySome} for the pure variant
  * @see {@link updateSomeEffect} for effectful optional updates without a separate return value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const modifySomeEffect: {
@@ -631,12 +644,12 @@ export const modifySomeEffect: {
    * **When to use**
    *
    * Use to effectfully compute a return value while optionally updating the
-   * stored value.
+   * stored `SynchronizedRef` value.
    *
    * @see {@link modifySome} for the pure variant
    * @see {@link updateSomeEffect} for effectful optional updates without a separate return value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, B, R, E>(
@@ -651,12 +664,12 @@ export const modifySomeEffect: {
    * **When to use**
    *
    * Use to effectfully compute a return value while optionally updating the
-   * stored value.
+   * stored `SynchronizedRef` value.
    *
    * @see {@link modifySome} for the pure variant
    * @see {@link updateSomeEffect} for effectful optional updates without a separate return value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, B, R, E>(
@@ -693,7 +706,7 @@ export const modifySomeEffect: {
  * @see {@link setAndGet} for replacing the value when the new value should be returned
  * @see {@link update} for deriving the next value from the current value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const set: {
@@ -709,7 +722,7 @@ export const set: {
    * @see {@link setAndGet} for replacing the value when the new value should be returned
    * @see {@link update} for deriving the next value from the current value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A>(value: A): (self: SynchronizedRef<A>) => Effect.Effect<void>
@@ -725,7 +738,7 @@ export const set: {
    * @see {@link setAndGet} for replacing the value when the new value should be returned
    * @see {@link update} for deriving the next value from the current value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A>(self: SynchronizedRef<A>, value: A): Effect.Effect<void>
@@ -740,13 +753,13 @@ export const set: {
  *
  * **When to use**
  *
- * Use to replace the current value with a known value and return that new
- * value.
+ * Use to replace the current `SynchronizedRef` value with a known value and
+ * return that new value.
  *
  * @see {@link set} for setting without returning a value
  * @see {@link getAndSet} for setting while returning the previous value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const setAndGet: {
@@ -755,13 +768,13 @@ export const setAndGet: {
    *
    * **When to use**
    *
-   * Use to replace the current value with a known value and return that new
-   * value.
+   * Use to replace the current `SynchronizedRef` value with a known value and
+   * return that new value.
    *
    * @see {@link set} for setting without returning a value
    * @see {@link getAndSet} for setting while returning the previous value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A>(value: A): (self: SynchronizedRef<A>) => Effect.Effect<A>
@@ -770,13 +783,13 @@ export const setAndGet: {
    *
    * **When to use**
    *
-   * Use to replace the current value with a known value and return that new
-   * value.
+   * Use to replace the current `SynchronizedRef` value with a known value and
+   * return that new value.
    *
    * @see {@link set} for setting without returning a value
    * @see {@link getAndSet} for setting while returning the previous value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A>(self: SynchronizedRef<A>, value: A): Effect.Effect<A>
@@ -799,7 +812,7 @@ export const setAndGet: {
  * @see {@link updateAndGet} for returning the new stored value
  * @see {@link getAndUpdate} for returning the previous stored value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const update: {
@@ -816,7 +829,7 @@ export const update: {
    * @see {@link updateAndGet} for returning the new stored value
    * @see {@link getAndUpdate} for returning the previous stored value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A>(f: (a: A) => A): (self: SynchronizedRef<A>) => Effect.Effect<void>
@@ -833,7 +846,7 @@ export const update: {
    * @see {@link updateAndGet} for returning the new stored value
    * @see {@link getAndUpdate} for returning the previous stored value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A>(self: SynchronizedRef<A>, f: (a: A) => A): Effect.Effect<void>
@@ -858,7 +871,7 @@ export const update: {
  * @see {@link modifyEffect} for returning a separate result while storing a new value
  * @see {@link updateSomeEffect} for effectfully applying only some state transitions
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const updateEffect: {
@@ -877,7 +890,7 @@ export const updateEffect: {
    * @see {@link modifyEffect} for returning a separate result while storing a new value
    * @see {@link updateSomeEffect} for effectfully applying only some state transitions
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, R, E>(f: (a: A) => Effect.Effect<A, E, R>): (self: SynchronizedRef<A>) => Effect.Effect<void, E, R>
@@ -896,7 +909,7 @@ export const updateEffect: {
    * @see {@link modifyEffect} for returning a separate result while storing a new value
    * @see {@link updateSomeEffect} for effectfully applying only some state transitions
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, R, E>(self: SynchronizedRef<A>, f: (a: A) => Effect.Effect<A, E, R>): Effect.Effect<void, E, R>
@@ -917,12 +930,13 @@ export const updateEffect: {
  *
  * **When to use**
  *
- * Use to apply a pure state transition and return the new stored value.
+ * Use to apply a pure `SynchronizedRef` state transition and return the new
+ * stored value.
  *
  * @see {@link update} for updating without returning the new value
  * @see {@link getAndUpdate} for updating while returning the previous value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const updateAndGet: {
@@ -932,12 +946,13 @@ export const updateAndGet: {
    *
    * **When to use**
    *
-   * Use to apply a pure state transition and return the new stored value.
+   * Use to apply a pure `SynchronizedRef` state transition and return the new
+   * stored value.
    *
    * @see {@link update} for updating without returning the new value
    * @see {@link getAndUpdate} for updating while returning the previous value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A>(f: (a: A) => A): (self: SynchronizedRef<A>) => Effect.Effect<A>
@@ -947,12 +962,13 @@ export const updateAndGet: {
    *
    * **When to use**
    *
-   * Use to apply a pure state transition and return the new stored value.
+   * Use to apply a pure `SynchronizedRef` state transition and return the new
+   * stored value.
    *
    * @see {@link update} for updating without returning the new value
    * @see {@link getAndUpdate} for updating while returning the previous value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A>(self: SynchronizedRef<A>, f: (a: A) => A): Effect.Effect<A>
@@ -968,12 +984,13 @@ export const updateAndGet: {
  *
  * **When to use**
  *
- * Use to run an effectful state transition and return the new stored value.
+ * Use to run an effectful `SynchronizedRef` state transition and return the new
+ * stored value.
  *
  * @see {@link updateEffect} for effectful updates without returning the new value
  * @see {@link updateAndGet} for the pure variant
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const updateAndGetEffect: {
@@ -983,12 +1000,13 @@ export const updateAndGetEffect: {
    *
    * **When to use**
    *
-   * Use to run an effectful state transition and return the new stored value.
+   * Use to run an effectful `SynchronizedRef` state transition and return the new
+   * stored value.
    *
    * @see {@link updateEffect} for effectful updates without returning the new value
    * @see {@link updateAndGet} for the pure variant
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, R, E>(f: (a: A) => Effect.Effect<A, E, R>): (self: SynchronizedRef<A>) => Effect.Effect<A, E, R>
@@ -998,12 +1016,13 @@ export const updateAndGetEffect: {
    *
    * **When to use**
    *
-   * Use to run an effectful state transition and return the new stored value.
+   * Use to run an effectful `SynchronizedRef` state transition and return the new
+   * stored value.
    *
    * @see {@link updateEffect} for effectful updates without returning the new value
    * @see {@link updateAndGet} for the pure variant
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, R, E>(self: SynchronizedRef<A>, f: (a: A) => Effect.Effect<A, E, R>): Effect.Effect<A, E, R>
@@ -1025,12 +1044,13 @@ export const updateAndGetEffect: {
  *
  * **When to use**
  *
- * Use to apply a pure conditional update without returning a value.
+ * Use to apply a pure conditional `SynchronizedRef` update without returning a
+ * value.
  *
  * @see {@link update} for always applying a pure update
  * @see {@link updateSomeAndGet} for returning the resulting current value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const updateSome: {
@@ -1040,12 +1060,13 @@ export const updateSome: {
    *
    * **When to use**
    *
-   * Use to apply a pure conditional update without returning a value.
+   * Use to apply a pure conditional `SynchronizedRef` update without returning a
+   * value.
    *
    * @see {@link update} for always applying a pure update
    * @see {@link updateSomeAndGet} for returning the resulting current value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A>(f: (a: A) => Option.Option<A>): (self: SynchronizedRef<A>) => Effect.Effect<void>
@@ -1055,12 +1076,13 @@ export const updateSome: {
    *
    * **When to use**
    *
-   * Use to apply a pure conditional update without returning a value.
+   * Use to apply a pure conditional `SynchronizedRef` update without returning a
+   * value.
    *
    * @see {@link update} for always applying a pure update
    * @see {@link updateSomeAndGet} for returning the resulting current value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A>(self: SynchronizedRef<A>, f: (a: A) => Option.Option<A>): Effect.Effect<void>
@@ -1076,12 +1098,13 @@ export const updateSome: {
  *
  * **When to use**
  *
- * Use to run an effectful conditional update without returning a value.
+ * Use to run an effectful conditional `SynchronizedRef` update without
+ * returning a value.
  *
  * @see {@link updateSome} for the pure conditional variant
  * @see {@link updateEffect} for effectful updates that always store a new value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const updateSomeEffect: {
@@ -1091,12 +1114,13 @@ export const updateSomeEffect: {
    *
    * **When to use**
    *
-   * Use to run an effectful conditional update without returning a value.
+   * Use to run an effectful conditional `SynchronizedRef` update without
+   * returning a value.
    *
    * @see {@link updateSome} for the pure conditional variant
    * @see {@link updateEffect} for effectful updates that always store a new value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, R, E>(pf: (a: A) => Effect.Effect<Option.Option<A>, E, R>): (self: SynchronizedRef<A>) => Effect.Effect<void, E, R>
@@ -1106,12 +1130,13 @@ export const updateSomeEffect: {
    *
    * **When to use**
    *
-   * Use to run an effectful conditional update without returning a value.
+   * Use to run an effectful conditional `SynchronizedRef` update without
+   * returning a value.
    *
    * @see {@link updateSome} for the pure conditional variant
    * @see {@link updateEffect} for effectful updates that always store a new value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, R, E>(
@@ -1139,13 +1164,13 @@ export const updateSomeEffect: {
  *
  * **When to use**
  *
- * Use to apply a pure conditional update and return the resulting current
- * value.
+ * Use to apply a pure conditional `SynchronizedRef` update and return the
+ * resulting current value.
  *
  * @see {@link updateSome} for conditional updates without returning a value
  * @see {@link updateAndGet} for always applying a pure update and returning the new value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const updateSomeAndGet: {
@@ -1156,13 +1181,13 @@ export const updateSomeAndGet: {
    *
    * **When to use**
    *
-   * Use to apply a pure conditional update and return the resulting current
-   * value.
+   * Use to apply a pure conditional `SynchronizedRef` update and return the
+   * resulting current value.
    *
    * @see {@link updateSome} for conditional updates without returning a value
    * @see {@link updateAndGet} for always applying a pure update and returning the new value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A>(pf: (a: A) => Option.Option<A>): (self: SynchronizedRef<A>) => Effect.Effect<A>
@@ -1173,13 +1198,13 @@ export const updateSomeAndGet: {
    *
    * **When to use**
    *
-   * Use to apply a pure conditional update and return the resulting current
-   * value.
+   * Use to apply a pure conditional `SynchronizedRef` update and return the
+   * resulting current value.
    *
    * @see {@link updateSome} for conditional updates without returning a value
    * @see {@link updateAndGet} for always applying a pure update and returning the new value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A>(self: SynchronizedRef<A>, pf: (a: A) => Option.Option<A>): Effect.Effect<A>
@@ -1196,13 +1221,13 @@ export const updateSomeAndGet: {
  *
  * **When to use**
  *
- * Use to run an effectful conditional update and return the resulting current
- * value.
+ * Use to run an effectful conditional `SynchronizedRef` update and return the
+ * resulting current value.
  *
  * @see {@link updateSomeEffect} for effectful conditional updates without returning a value
  * @see {@link updateAndGetEffect} for effectful updates that always store and return a new value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const updateSomeAndGetEffect: {
@@ -1213,13 +1238,13 @@ export const updateSomeAndGetEffect: {
    *
    * **When to use**
    *
-   * Use to run an effectful conditional update and return the resulting current
-   * value.
+   * Use to run an effectful conditional `SynchronizedRef` update and return the
+   * resulting current value.
    *
    * @see {@link updateSomeEffect} for effectful conditional updates without returning a value
    * @see {@link updateAndGetEffect} for effectful updates that always store and return a new value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, R, E>(pf: (a: A) => Effect.Effect<Option.Option<A>, E, R>): (self: SynchronizedRef<A>) => Effect.Effect<A, E, R>
@@ -1230,13 +1255,13 @@ export const updateSomeAndGetEffect: {
    *
    * **When to use**
    *
-   * Use to run an effectful conditional update and return the resulting current
-   * value.
+   * Use to run an effectful conditional `SynchronizedRef` update and return the
+   * resulting current value.
    *
    * @see {@link updateSomeEffect} for effectful conditional updates without returning a value
    * @see {@link updateAndGetEffect} for effectful updates that always store and return a new value
    *
-   * @category utils
+   * @category mutations
    * @since 2.0.0
    */
   <A, R, E>(