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

package/dist/Redacted.d.ts

@@ -147,7 +147,7 @@ export declare namespace Redacted {
      * console.log(rotate({ token: "secret" })) // { token: "secret:rotated" }
      * ```
      *
-     * @category type-level
+     * @category utility types
      * @since 3.3.0
      */
     type Value<T extends Redacted<any>> = [T] extends [Redacted<infer _A>] ? _A : never;
@@ -214,7 +214,7 @@ export declare const make: <T>(value: T, options?: {
  *
  * **When to use**
  *
- * Use when the underlying sensitive value is required at a trusted boundary.
+ * Use when you need the underlying sensitive value at a trusted boundary.
  *
  * **Example** (Retrieving a redacted value)
  *
@@ -275,8 +275,8 @@ export declare const wipeUnsafe: <T>(self: Redacted<T>) => boolean;
  *
  * **When to use**
  *
- * Use when an API needs an `Equivalence` for `Redacted` values based on their
- * underlying values.
+ * Use when you need to compare wrapped secrets through an approved equality
+ * rule without exposing the underlying values at each comparison site.
  *
  * **Example** (Comparing redacted values)
  *
@@ -294,7 +294,7 @@ export declare const wipeUnsafe: <T>(self: Redacted<T>) => boolean;
  * assert.equal(equivalence(API_KEY1, API_KEY3), true)
  * ```
  *
- * @category equivalence
+ * @category instances
  * @since 4.0.0
  */
 export declare const makeEquivalence: <A>(isEquivalent: Equivalence.Equivalence<A>) => Equivalence.Equivalence<Redacted<A>>;

package/dist/Redacted.js

@@ -136,7 +136,7 @@ const Proto = {
  *
  * **When to use**
  *
- * Use when the underlying sensitive value is required at a trusted boundary.
+ * Use when you need the underlying sensitive value at a trusted boundary.
  *
  * **Example** (Retrieving a redacted value)
  *
@@ -197,8 +197,8 @@ export const wipeUnsafe = self => redacted.redactedRegistry.delete(self);
  *
  * **When to use**
  *
- * Use when an API needs an `Equivalence` for `Redacted` values based on their
- * underlying values.
+ * Use when you need to compare wrapped secrets through an approved equality
+ * rule without exposing the underlying values at each comparison site.
  *
  * **Example** (Comparing redacted values)
  *
@@ -216,7 +216,7 @@ export const wipeUnsafe = self => redacted.redactedRegistry.delete(self);
  * assert.equal(equivalence(API_KEY1, API_KEY3), true)
  * ```
  *
- * @category equivalence
+ * @category instances
  * @since 4.0.0
  */
 export const makeEquivalence = isEquivalent => Equivalence.make((x, y) => isEquivalent(value(x), value(y)));

package/dist/Reducer.d.ts

@@ -179,9 +179,8 @@ export declare function make<A>(combine: (self: A, that: A) => A, initialValue:
  *
  * **When to use**
  *
- * Use when you need the "right" value to act as the accumulator side.
- * - You want to reverse the natural direction of a non-commutative reducer
- *   (e.g. string concatenation becomes prepend).
+ * Use when you want the right-hand value to act as the accumulator, or need to
+ * reverse a non-commutative reducer such as string concatenation.
  *
  * **Details**
  *

package/dist/Reducer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Reducer.d.ts","sourceRoot":"","sources":["../src/Reducer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AAEH,OAAO,KAAK,KAAK,QAAQ,MAAM,eAAe,CAAA;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtD;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAA;IAExB;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;CACpD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,IAAI,CAAC,CAAC,EACpB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAChC,YAAY,EAAE,CAAC,EACf,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAC1C,OAAO,CAAC,CAAC,CAAC,CAaZ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEvD"}
+{"version":3,"file":"Reducer.d.ts","sourceRoot":"","sources":["../src/Reducer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AAEH,OAAO,KAAK,KAAK,QAAQ,MAAM,eAAe,CAAA;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtD;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAA;IAExB;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;CACpD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,IAAI,CAAC,CAAC,EACpB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAChC,YAAY,EAAE,CAAC,EACf,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAC1C,OAAO,CAAC,CAAC,CAAC,CAaZ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEvD"}

package/dist/Reducer.js

@@ -130,9 +130,8 @@ export function make(combine, initialValue, combineAll) {
  *
  * **When to use**
  *
- * Use when you need the "right" value to act as the accumulator side.
- * - You want to reverse the natural direction of a non-commutative reducer
- *   (e.g. string concatenation becomes prepend).
+ * Use when you want the right-hand value to act as the accumulator, or need to
+ * reverse a non-commutative reducer such as string concatenation.
  *
  * **Details**
  *

package/dist/Reducer.js.map

@@ -1 +1 @@
-{"version":3,"file":"Reducer.js","names":["make","combine","initialValue","combineAll","collection","out","value","flip","reducer","self","that"],"sources":["../src/Reducer.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CA,OAAM,SAAUA,IAAIA,CAClBC,OAAgC,EAChCC,YAAe,EACfC,UAA2C;EAE3C,OAAO;IACLF,OAAO;IACPC,YAAY;IACZC,UAAU,EAAEA,UAAU,KAClBC,UAAU,IAAI;MACd,IAAIC,GAAG,GAAGH,YAAY;MACtB,KAAK,MAAMI,KAAK,IAAIF,UAAU,EAAE;QAC9BC,GAAG,GAAGJ,OAAO,CAACI,GAAG,EAAEC,KAAK,CAAC;MAC3B;MACA,OAAOD,GAAG;IACZ,CAAC;GACJ;AACH;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,OAAM,SAAUE,IAAIA,CAAIC,OAAmB;EACzC,OAAOR,IAAI,CAAC,CAACS,IAAI,EAAEC,IAAI,KAAKF,OAAO,CAACP,OAAO,CAACS,IAAI,EAAED,IAAI,CAAC,EAAED,OAAO,CAACN,YAAY,CAAC;AAChF","ignoreList":[]}
+{"version":3,"file":"Reducer.js","names":["make","combine","initialValue","combineAll","collection","out","value","flip","reducer","self","that"],"sources":["../src/Reducer.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CA,OAAM,SAAUA,IAAIA,CAClBC,OAAgC,EAChCC,YAAe,EACfC,UAA2C;EAE3C,OAAO;IACLF,OAAO;IACPC,YAAY;IACZC,UAAU,EAAEA,UAAU,KAClBC,UAAU,IAAI;MACd,IAAIC,GAAG,GAAGH,YAAY;MACtB,KAAK,MAAMI,KAAK,IAAIF,UAAU,EAAE;QAC9BC,GAAG,GAAGJ,OAAO,CAACI,GAAG,EAAEC,KAAK,CAAC;MAC3B;MACA,OAAOD,GAAG;IACZ,CAAC;GACJ;AACH;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,OAAM,SAAUE,IAAIA,CAAIC,OAAmB;EACzC,OAAOR,IAAI,CAAC,CAACS,IAAI,EAAEC,IAAI,KAAKF,OAAO,CAACP,OAAO,CAACS,IAAI,EAAED,IAAI,CAAC,EAAED,OAAO,CAACN,YAAY,CAAC;AAChF","ignoreList":[]}

package/dist/Ref.d.ts

@@ -181,7 +181,7 @@ export declare const makeUnsafe: <A>(value: A) => Ref<A>;
  *
  * **When to use**
  *
- * Use to create shared mutable state inside an Effect program.
+ * Use to create a `Ref` for shared mutable state inside an Effect program.
  *
  * **Example** (Creating a ref)
  *
@@ -206,7 +206,7 @@ export declare const make: <A>(value: A) => Effect.Effect<Ref<A>>;
  *
  * **When to use**
  *
- * Use to read the current value without changing it.
+ * Use to read the current `Ref` value without changing it.
  *
  * **Example** (Getting the current value)
  *
@@ -231,7 +231,7 @@ export declare const get: <A>(self: Ref<A>) => Effect.Effect<A, never, never>;
  *
  * **When to use**
  *
- * Use to replace the current value with a known value.
+ * Use to replace the current `Ref` value with a known value.
  *
  * **Example** (Setting a value)
  *
@@ -266,7 +266,7 @@ export declare const set: (<A>(value: A) => (self: Ref<A>) => Effect.Effect<void
  *
  * **When to use**
  *
- * Use to replace the value while returning the previous value.
+ * Use to replace a plain `Ref` value while returning the previous value.
  *
  * **Example** (Replacing a value atomically)
  *
@@ -288,7 +288,7 @@ export declare const set: (<A>(value: A) => (self: Ref<A>) => Effect.Effect<void
  * @see {@link set} for setting without returning the previous value
  * @see {@link getAndUpdate} for deriving the new value from the previous value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export declare const getAndSet: (<A>(value: A) => (self: Ref<A>) => Effect.Effect<A>) & (<A>(self: Ref<A>, value: A) => Effect.Effect<A>);
@@ -297,7 +297,7 @@ export declare const getAndSet: (<A>(value: A) => (self: Ref<A>) => Effect.Effec
  *
  * **When to use**
  *
- * Use to derive a new value while returning the previous value.
+ * Use to derive a new `Ref` value while returning the previous value.
  *
  * **Example** (Updating and returning the previous value)
  *
@@ -319,7 +319,7 @@ export declare const getAndSet: (<A>(value: A) => (self: Ref<A>) => Effect.Effec
  * @see {@link update} for updating without returning the previous value
  * @see {@link updateAndGet} for returning the new value instead
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export declare const getAndUpdate: (<A>(f: (a: A) => A) => (self: Ref<A>) => Effect.Effect<A>) & (<A>(self: Ref<A>, f: (a: A) => A) => Effect.Effect<A>);
@@ -328,7 +328,7 @@ export declare const getAndUpdate: (<A>(f: (a: A) => A) => (self: Ref<A>) => Eff
  *
  * **When to use**
  *
- * Use to return the previous value while applying a conditional update.
+ * Use to return the previous `Ref` value while applying a conditional update.
  *
  * **Details**
  *
@@ -369,7 +369,7 @@ export declare const getAndUpdate: (<A>(f: (a: A) => A) => (self: Ref<A>) => Eff
  * @see {@link getAndUpdate} for always applying an update
  * @see {@link updateSome} for conditional updates without returning the previous value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export declare const getAndUpdateSome: (<A>(pf: (a: A) => Option.Option<A>) => (self: Ref<A>) => Effect.Effect<A>) & (<A>(self: Ref<A>, pf: (a: A) => Option.Option<A>) => Effect.Effect<A>);
@@ -378,7 +378,7 @@ export declare const getAndUpdateSome: (<A>(pf: (a: A) => Option.Option<A>) => (
  *
  * **When to use**
  *
- * Use when you want to set a value and immediately get it back in one
+ * Use when you want to set a `Ref` value and immediately get it back in one
  * atomic operation.
  *
  * **Example** (Setting and returning the new value)
@@ -407,7 +407,7 @@ export declare const getAndUpdateSome: (<A>(pf: (a: A) => Option.Option<A>) => (
  * })
  * ```
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export declare const setAndGet: (<A>(value: A) => (self: Ref<A>) => Effect.Effect<A>) & (<A>(self: Ref<A>, value: A) => Effect.Effect<A>);
@@ -416,8 +416,8 @@ export declare const setAndGet: (<A>(value: A) => (self: Ref<A>) => Effect.Effec
  *
  * **When to use**
  *
- * Use to compute both a separate return value and the next stored value in one
- * atomic update.
+ * Use to compute both a separate return value and the next stored `Ref` value
+ * in one atomic update.
  *
  * **Details**
  *
@@ -470,7 +470,7 @@ export declare const modify: (<A, B>(f: (a: A) => readonly [B, A]) => (self: Ref
  *
  * **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 plain `Ref`.
  *
  * **Details**
  *
@@ -529,7 +529,7 @@ 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 plain `Ref`.
      *
      * **Details**
      *
@@ -588,7 +588,7 @@ 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 plain `Ref`.
      *
      * **Details**
      *
@@ -648,7 +648,7 @@ export declare const modifySome: {
  *
  * **When to use**
  *
- * Use to apply a state transition without returning a value.
+ * Use to apply a `Ref` state transition without returning a value.
  *
  * **Example** (Updating a value)
  *
@@ -686,7 +686,7 @@ export declare const update: (<A>(f: (a: A) => A) => (self: Ref<A>) => Effect.Ef
  *
  * **When to use**
  *
- * Use to apply a state transition and return the new stored value.
+ * Use to apply a `Ref` state transition and return the new stored value.
  *
  * **Example** (Updating and returning the new value)
  *
@@ -709,7 +709,7 @@ export declare const update: (<A>(f: (a: A) => A) => (self: Ref<A>) => Effect.Ef
  * @see {@link update} for updating without returning the new value
  * @see {@link getAndUpdate} for returning the previous value instead
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export declare const updateAndGet: (<A>(f: (a: A) => A) => (self: Ref<A>) => Effect.Effect<A>) & (<A>(self: Ref<A>, f: (a: A) => A) => Effect.Effect<A>);
@@ -718,7 +718,7 @@ export declare const updateAndGet: (<A>(f: (a: A) => A) => (self: Ref<A>) => Eff
  *
  * **When to use**
  *
- * Use to apply a conditional update without returning a value.
+ * Use to apply a conditional `Ref` update without returning a value.
  *
  * **Details**
  *
@@ -766,7 +766,8 @@ export declare const updateSome: (<A>(f: (a: A) => Option.Option<A>) => (self: R
  *
  * **When to use**
  *
- * Use to apply a conditional update and return the resulting current value.
+ * Use to apply a conditional `Ref` update and return the resulting current
+ * value.
  *
  * **Details**
  *
@@ -801,7 +802,7 @@ export declare const updateSome: (<A>(f: (a: A) => Option.Option<A>) => (self: R
  * @see {@link updateSome} for conditional updates without returning a value
  * @see {@link updateAndGet} for always updating and returning the new value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export declare const updateSomeAndGet: (<A>(pf: (a: A) => Option.Option<A>) => (self: Ref<A>) => Effect.Effect<A>) & (<A>(self: Ref<A>, pf: (a: A) => Option.Option<A>) => Effect.Effect<A>);

package/dist/Ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Ref.d.ts","sourceRoot":"","sources":["../src/Ref.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Ref.d.ts","sourceRoot":"","sources":["../src/Ref.ts"],"names":[],"mappings":"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"}

package/dist/Ref.js

@@ -109,7 +109,7 @@ export const makeUnsafe = value => {
  *
  * **When to use**
  *
- * Use to create shared mutable state inside an Effect program.
+ * Use to create a `Ref` for shared mutable state inside an Effect program.
  *
  * **Example** (Creating a ref)
  *
@@ -134,7 +134,7 @@ export const make = value => Effect.sync(() => makeUnsafe(value));
  *
  * **When to use**
  *
- * Use to read the current value without changing it.
+ * Use to read the current `Ref` value without changing it.
  *
  * **Example** (Getting the current value)
  *
@@ -159,7 +159,7 @@ export const get = self => Effect.sync(() => self.ref.current);
  *
  * **When to use**
  *
- * Use to replace the current value with a known value.
+ * Use to replace the current `Ref` value with a known value.
  *
  * **Example** (Setting a value)
  *
@@ -194,7 +194,7 @@ export const set = /*#__PURE__*/dual(2, (self, value) => Effect.sync(() => Mutab
  *
  * **When to use**
  *
- * Use to replace the value while returning the previous value.
+ * Use to replace a plain `Ref` value while returning the previous value.
  *
  * **Example** (Replacing a value atomically)
  *
@@ -216,7 +216,7 @@ export const set = /*#__PURE__*/dual(2, (self, value) => Effect.sync(() => Mutab
  * @see {@link set} for setting without returning the previous value
  * @see {@link getAndUpdate} for deriving the new value from the previous value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const getAndSet = /*#__PURE__*/dual(2, (self, value) => Effect.sync(() => {
@@ -229,7 +229,7 @@ export const getAndSet = /*#__PURE__*/dual(2, (self, value) => Effect.sync(() =>
  *
  * **When to use**
  *
- * Use to derive a new value while returning the previous value.
+ * Use to derive a new `Ref` value while returning the previous value.
  *
  * **Example** (Updating and returning the previous value)
  *
@@ -251,7 +251,7 @@ export const getAndSet = /*#__PURE__*/dual(2, (self, value) => Effect.sync(() =>
  * @see {@link update} for updating without returning the previous value
  * @see {@link updateAndGet} for returning the new value instead
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const getAndUpdate = /*#__PURE__*/dual(2, (self, f) => Effect.sync(() => {
@@ -264,7 +264,7 @@ export const getAndUpdate = /*#__PURE__*/dual(2, (self, f) => Effect.sync(() =>
  *
  * **When to use**
  *
- * Use to return the previous value while applying a conditional update.
+ * Use to return the previous `Ref` value while applying a conditional update.
  *
  * **Details**
  *
@@ -305,7 +305,7 @@ export const getAndUpdate = /*#__PURE__*/dual(2, (self, f) => Effect.sync(() =>
  * @see {@link getAndUpdate} for always applying an update
  * @see {@link updateSome} for conditional updates without returning the previous value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const getAndUpdateSome = /*#__PURE__*/dual(2, (self, pf) => Effect.sync(() => {
@@ -321,7 +321,7 @@ export const getAndUpdateSome = /*#__PURE__*/dual(2, (self, pf) => Effect.sync((
  *
  * **When to use**
  *
- * Use when you want to set a value and immediately get it back in one
+ * Use when you want to set a `Ref` value and immediately get it back in one
  * atomic operation.
  *
  * **Example** (Setting and returning the new value)
@@ -350,7 +350,7 @@ export const getAndUpdateSome = /*#__PURE__*/dual(2, (self, pf) => Effect.sync((
  * })
  * ```
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const setAndGet = /*#__PURE__*/dual(2, (self, value) => Effect.sync(() => self.ref.current = value));
@@ -359,8 +359,8 @@ export const setAndGet = /*#__PURE__*/dual(2, (self, value) => Effect.sync(() =>
  *
  * **When to use**
  *
- * Use to compute both a separate return value and the next stored value in one
- * atomic update.
+ * Use to compute both a separate return value and the next stored `Ref` value
+ * in one atomic update.
  *
  * **Details**
  *
@@ -417,7 +417,7 @@ export const modify = /*#__PURE__*/dual(2, (self, f) => Effect.sync(() => {
  *
  * **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 plain `Ref`.
  *
  * **Details**
  *
@@ -479,7 +479,7 @@ export const modifySome = /*#__PURE__*/dual(2, (self, pf) => modify(self, value
  *
  * **When to use**
  *
- * Use to apply a state transition without returning a value.
+ * Use to apply a `Ref` state transition without returning a value.
  *
  * **Example** (Updating a value)
  *
@@ -519,7 +519,7 @@ export const update = /*#__PURE__*/dual(2, (self, f) => Effect.sync(() => {
  *
  * **When to use**
  *
- * Use to apply a state transition and return the new stored value.
+ * Use to apply a `Ref` state transition and return the new stored value.
  *
  * **Example** (Updating and returning the new value)
  *
@@ -542,7 +542,7 @@ export const update = /*#__PURE__*/dual(2, (self, f) => Effect.sync(() => {
  * @see {@link update} for updating without returning the new value
  * @see {@link getAndUpdate} for returning the previous value instead
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const updateAndGet = /*#__PURE__*/dual(2, (self, f) => Effect.sync(() => self.ref.current = f(self.ref.current)));
@@ -551,7 +551,7 @@ export const updateAndGet = /*#__PURE__*/dual(2, (self, f) => Effect.sync(() =>
  *
  * **When to use**
  *
- * Use to apply a conditional update without returning a value.
+ * Use to apply a conditional `Ref` update without returning a value.
  *
  * **Details**
  *
@@ -604,7 +604,8 @@ export const updateSome = /*#__PURE__*/dual(2, (self, f) => Effect.sync(() => {
  *
  * **When to use**
  *
- * Use to apply a conditional update and return the resulting current value.
+ * Use to apply a conditional `Ref` update and return the resulting current
+ * value.
  *
  * **Details**
  *
@@ -639,7 +640,7 @@ export const updateSome = /*#__PURE__*/dual(2, (self, f) => Effect.sync(() => {
  * @see {@link updateSome} for conditional updates without returning a value
  * @see {@link updateAndGet} for always updating and returning the new value
  *
- * @category utils
+ * @category mutations
  * @since 2.0.0
  */
 export const updateSomeAndGet = /*#__PURE__*/dual(2, (self, pf) => Effect.sync(() => {

package/dist/Ref.js.map

@@ -1 +1 @@
-{"version":3,"file":"Ref.js","names":["Effect","dual","identity","PipeInspectableProto","MutableRef","TypeId","RefProto","_A","toJSON","_id","ref","makeUnsafe","value","self","Object","create","make","sync","get","current","set","getAndSet","getAndUpdate","f","getAndUpdateSome","pf","option","_tag","setAndGet","modify","b","a","modifySome","update","updateAndGet","updateSome","updateSomeAndGet","getUnsafe"],"sources":["../src/Ref.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Ref.js","names":["Effect","dual","identity","PipeInspectableProto","MutableRef","TypeId","RefProto","_A","toJSON","_id","ref","makeUnsafe","value","self","Object","create","make","sync","get","current","set","getAndSet","getAndUpdate","f","getAndUpdateSome","pf","option","_tag","setAndGet","modify","b","a","modifySome","update","updateAndGet","updateSome","updateSomeAndGet","getUnsafe"],"sources":["../src/Ref.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/References.d.ts

@@ -105,8 +105,8 @@ DisablePropagation,
  *
  * **When to use**
  *
- * Use to tune scheduler fairness for CPU-bound fibers by changing the
- * operation budget that triggers a scheduler yield.
+ * Use to configure the runtime reference for the fiber operation budget that
+ * triggers a scheduler yield.
  *
  * **Details**
  *
@@ -759,8 +759,8 @@ export declare const CurrentLoggers: Context.Reference<ReadonlySet<Logger<unknow
  *
  * **When to use**
  *
- * Use to keep stdout reserved for protocol messages or data output while still
- * allowing Effect runtime logs to be emitted.
+ * Use to configure the runtime reference that controls whether built-in console
+ * loggers write to stderr.
  *
  * **Details**
  *

package/dist/References.js

@@ -41,8 +41,8 @@ DisablePropagation,
  *
  * **When to use**
  *
- * Use to tune scheduler fairness for CPU-bound fibers by changing the
- * operation budget that triggers a scheduler yield.
+ * Use to configure the runtime reference for the fiber operation budget that
+ * triggers a scheduler yield.
  *
  * **Details**
  *
@@ -672,8 +672,8 @@ export const CurrentLoggers = internalEffect.CurrentLoggers;
  *
  * **When to use**
  *
- * Use to keep stdout reserved for protocol messages or data output while still
- * allowing Effect runtime logs to be emitted.
+ * Use to configure the runtime reference that controls whether built-in console
+ * loggers write to stderr.
  *
  * **Details**
  *

package/dist/RegExp.d.ts

@@ -60,7 +60,7 @@ export declare const isRegExp: (input: unknown) => input is RegExp;
  * assert.deepStrictEqual(RegExp.escape("a*b"), "a\\*b")
  * ```
  *
- * @category utils
+ * @category RegExp
  * @since 2.0.0
  */
 export declare const escape: (string: string) => string;

package/dist/RegExp.js

@@ -99,7 +99,7 @@ export const isRegExp = predicate.isRegExp;
  * assert.deepStrictEqual(RegExp.escape("a*b"), "a\\*b")
  * ```
  *
- * @category utils
+ * @category RegExp
  * @since 2.0.0
  */
 export const escape = string => string.replace(/[/\\^$*+?.()|[\]{}]/g, "\\$&");