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

package/dist/SynchronizedRef.d.ts

@@ -53,7 +53,8 @@ export interface SynchronizedRef<in out A> extends Ref.Ref<A> {
  *
  * **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
@@ -64,8 +65,8 @@ export declare 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**
  *
@@ -121,7 +122,7 @@ export declare const get: <A>(self: SynchronizedRef<A>) => Effect.Effect<A>;
  * @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 declare const getAndSet: {
@@ -138,7 +139,7 @@ export declare 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>;
@@ -155,7 +156,7 @@ export declare 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>;
@@ -166,13 +167,14 @@ export declare 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 declare const getAndUpdate: {
@@ -182,13 +184,14 @@ export declare 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>;
@@ -198,13 +201,14 @@ export declare 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>;
@@ -215,7 +219,8 @@ export declare 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
@@ -223,7 +228,7 @@ export declare 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 declare const getAndUpdateEffect: {
@@ -233,7 +238,8 @@ export declare 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
@@ -241,7 +247,7 @@ export declare 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>;
@@ -251,7 +257,8 @@ export declare 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
@@ -259,7 +266,7 @@ export declare 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>;
@@ -271,12 +278,13 @@ export declare 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 declare const getAndUpdateSome: {
@@ -287,12 +295,13 @@ export declare 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>;
@@ -303,12 +312,13 @@ export declare 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>;
@@ -320,13 +330,13 @@ export declare 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 declare const getAndUpdateSomeEffect: {
@@ -337,13 +347,13 @@ export declare 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>;
@@ -354,13 +364,13 @@ export declare 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>(self: SynchronizedRef<A>, pf: (a: A) => Effect.Effect<Option.Option<A>, E, R>): Effect.Effect<A, E, R>;
@@ -371,14 +381,14 @@ export declare 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 declare const modify: {
@@ -388,14 +398,14 @@ export declare 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>;
@@ -405,14 +415,14 @@ export declare 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>;
@@ -424,12 +434,12 @@ export declare 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 declare const modifyEffect: {
@@ -440,12 +450,12 @@ export declare 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>;
@@ -456,12 +466,12 @@ export declare 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>(self: SynchronizedRef<A>, f: (a: A) => Effect.Effect<readonly [B, A], E, R>): Effect.Effect<B, E, R>;
@@ -472,12 +482,13 @@ export declare 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 declare const modifySome: {
@@ -487,12 +498,13 @@ export declare 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>;
@@ -502,12 +514,13 @@ export declare 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>;
@@ -520,12 +533,12 @@ export declare 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 declare const modifySomeEffect: {
@@ -537,12 +550,12 @@ export declare 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>(fallback: B, pf: (a: A) => Effect.Effect<readonly [B, Option.Option<A>], E, R>): (self: SynchronizedRef<A>) => Effect.Effect<B, E, R>;
@@ -554,12 +567,12 @@ export declare 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>(self: SynchronizedRef<A>, pf: (a: A) => Effect.Effect<readonly [B, Option.Option<A>], E, R>): Effect.Effect<B, E, R>;
@@ -576,7 +589,7 @@ export declare 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 declare const set: {
@@ -592,7 +605,7 @@ export declare 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>;
@@ -608,7 +621,7 @@ export declare 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>;
@@ -618,13 +631,13 @@ export declare 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 declare const setAndGet: {
@@ -633,13 +646,13 @@ export declare 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>;
@@ -648,13 +661,13 @@ export declare 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>;
@@ -672,7 +685,7 @@ export declare 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 declare const update: {
@@ -689,7 +702,7 @@ export declare 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>;
@@ -706,7 +719,7 @@ export declare 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>;
@@ -726,7 +739,7 @@ export declare 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 declare const updateEffect: {
@@ -745,7 +758,7 @@ export declare 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>;
@@ -764,7 +777,7 @@ export declare 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>;
@@ -775,12 +788,13 @@ export declare 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 declare const updateAndGet: {
@@ -790,12 +804,13 @@ export declare 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>;
@@ -805,12 +820,13 @@ export declare 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>;
@@ -821,12 +837,13 @@ export declare 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 declare const updateAndGetEffect: {
@@ -836,12 +853,13 @@ export declare 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>;
@@ -851,12 +869,13 @@ export declare 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>;
@@ -867,12 +886,13 @@ export declare 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 declare const updateSome: {
@@ -882,12 +902,13 @@ export declare 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>;
@@ -897,12 +918,13 @@ export declare 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>;
@@ -913,12 +935,13 @@ export declare 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 declare const updateSomeEffect: {
@@ -928,12 +951,13 @@ export declare 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>;
@@ -943,12 +967,13 @@ export declare 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>(self: SynchronizedRef<A>, pf: (a: A) => Effect.Effect<Option.Option<A>, E, R>): Effect.Effect<void, E, R>;
@@ -960,13 +985,13 @@ export declare 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 declare const updateSomeAndGet: {
@@ -977,13 +1002,13 @@ export declare 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>;
@@ -994,13 +1019,13 @@ export declare 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>;
@@ -1012,13 +1037,13 @@ export declare 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 declare const updateSomeAndGetEffect: {
@@ -1029,13 +1054,13 @@ export declare 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>;
@@ -1046,13 +1071,13 @@ export declare 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>(self: SynchronizedRef<A>, pf: (a: A) => Effect.Effect<Option.Option<A>, E, R>): Effect.Effect<A, E, R>;