effect 4.0.0-beta.71 → 4.0.0-beta.72

package/dist/Array.d.ts

@@ -9,12 +9,12 @@ import * as Reducer from "./Reducer.ts";
 import * as Result from "./Result.ts";
 import type { NoInfer, TupleOf } from "./Types.ts";
 /**
- * Reference to the global `Array` constructor.
+ * Exposes the global array constructor.
  *
  * **When to use**
  *
- * Use when you need the native `Array` constructor while the `Array`
- * namespace is in scope (e.g. `Array.Array.isArray`, `Array.Array.from`).
+ * Use to access native JavaScript array constructor methods such as `isArray`
+ * or `from` from the Effect module namespace.
  *
  * **Example** (Using the Array constructor)
  *
@@ -742,7 +742,6 @@ export declare const matchRight: {
  * **Details**
  *
  * - Always returns a non-empty array.
- * - Does not mutate the input.
  *
  * **Example** (Prepending an element)
  *
@@ -770,7 +769,6 @@ export declare const prepend: {
      * **Details**
      *
      * - Always returns a non-empty array.
-     * - Does not mutate the input.
      *
      * **Example** (Prepending an element)
      *
@@ -798,7 +796,6 @@ export declare const prepend: {
      * **Details**
      *
      * - Always returns a non-empty array.
-     * - Does not mutate the input.
      *
      * **Example** (Prepending an element)
      *
@@ -827,7 +824,6 @@ export declare const prepend: {
  * **Details**
  *
  * - If either input is non-empty, the result is a `NonEmptyArray`.
- * - Does not mutate the input.
  *
  * **Example** (Prepending multiple elements)
  *
@@ -855,7 +851,6 @@ export declare const prependAll: {
      * **Details**
      *
      * - If either input is non-empty, the result is a `NonEmptyArray`.
-     * - Does not mutate the input.
      *
      * **Example** (Prepending multiple elements)
      *
@@ -883,7 +878,6 @@ export declare const prependAll: {
      * **Details**
      *
      * - If either input is non-empty, the result is a `NonEmptyArray`.
-     * - Does not mutate the input.
      *
      * **Example** (Prepending multiple elements)
      *
@@ -911,7 +905,6 @@ export declare const prependAll: {
      * **Details**
      *
      * - If either input is non-empty, the result is a `NonEmptyArray`.
-     * - Does not mutate the input.
      *
      * **Example** (Prepending multiple elements)
      *
@@ -939,7 +932,6 @@ export declare const prependAll: {
      * **Details**
      *
      * - If either input is non-empty, the result is a `NonEmptyArray`.
-     * - Does not mutate the input.
      *
      * **Example** (Prepending multiple elements)
      *
@@ -969,7 +961,6 @@ export declare const prependAll: {
  * **Details**
  *
  * - Always returns a non-empty array.
- * - Does not mutate the input.
  *
  * **Example** (Appending an element)
  *
@@ -998,7 +989,6 @@ export declare const append: {
      * **Details**
      *
      * - Always returns a non-empty array.
-     * - Does not mutate the input.
      *
      * **Example** (Appending an element)
      *
@@ -1027,7 +1017,6 @@ export declare const append: {
      * **Details**
      *
      * - Always returns a non-empty array.
-     * - Does not mutate the input.
      *
      * **Example** (Appending an element)
      *
@@ -1057,7 +1046,6 @@ export declare const append: {
  * **Details**
  *
  * - If either input is non-empty, the result is a `NonEmptyArray`.
- * - Does not mutate the inputs.
  *
  * **Example** (Concatenating arrays)
  *
@@ -1086,7 +1074,6 @@ export declare const appendAll: {
      * **Details**
      *
      * - If either input is non-empty, the result is a `NonEmptyArray`.
-     * - Does not mutate the inputs.
      *
      * **Example** (Concatenating arrays)
      *
@@ -1115,7 +1102,6 @@ export declare const appendAll: {
      * **Details**
      *
      * - If either input is non-empty, the result is a `NonEmptyArray`.
-     * - Does not mutate the inputs.
      *
      * **Example** (Concatenating arrays)
      *
@@ -1144,7 +1130,6 @@ export declare const appendAll: {
      * **Details**
      *
      * - If either input is non-empty, the result is a `NonEmptyArray`.
-     * - Does not mutate the inputs.
      *
      * **Example** (Concatenating arrays)
      *
@@ -1173,7 +1158,6 @@ export declare const appendAll: {
      * **Details**
      *
      * - If either input is non-empty, the result is a `NonEmptyArray`.
-     * - Does not mutate the inputs.
      *
      * **Example** (Concatenating arrays)
      *
@@ -1193,7 +1177,7 @@ export declare const appendAll: {
     <A, B>(self: Iterable<A>, that: Iterable<B>): Array<A | B>;
 };
 /**
- * Left-to-right fold that keeps every intermediate accumulator value.
+ * Folds left-to-right while keeping every intermediate accumulator value.
  *
  * **When to use**
  *
@@ -1222,7 +1206,7 @@ export declare const appendAll: {
  */
 export declare const scan: {
     /**
-     * Left-to-right fold that keeps every intermediate accumulator value.
+     * Folds left-to-right while keeping every intermediate accumulator value.
      *
      * **When to use**
      *
@@ -1251,7 +1235,7 @@ export declare const scan: {
      */
     <B, A>(b: B, f: (b: B, a: A) => B): (self: Iterable<A>) => NonEmptyArray<B>;
     /**
-     * Left-to-right fold that keeps every intermediate accumulator value.
+     * Folds left-to-right while keeping every intermediate accumulator value.
      *
      * **When to use**
      *
@@ -1281,7 +1265,7 @@ export declare const scan: {
     <A, B>(self: Iterable<A>, b: B, f: (b: B, a: A) => B): NonEmptyArray<B>;
 };
 /**
- * Right-to-left fold that keeps every intermediate accumulator value.
+ * Folds right-to-left while keeping every intermediate accumulator value.
  *
  * **When to use**
  *
@@ -1310,7 +1294,7 @@ export declare const scan: {
  */
 export declare const scanRight: {
     /**
-     * Right-to-left fold that keeps every intermediate accumulator value.
+     * Folds right-to-left while keeping every intermediate accumulator value.
      *
      * **When to use**
      *
@@ -1339,7 +1323,7 @@ export declare const scanRight: {
      */
     <B, A>(b: B, f: (b: B, a: A) => B): (self: Iterable<A>) => NonEmptyArray<B>;
     /**
-     * Right-to-left fold that keeps every intermediate accumulator value.
+     * Folds right-to-left while keeping every intermediate accumulator value.
      *
      * **When to use**
      *
@@ -1369,7 +1353,7 @@ export declare const scanRight: {
     <A, B>(self: Iterable<A>, b: B, f: (b: B, a: A) => B): NonEmptyArray<B>;
 };
 /**
- * Tests whether a value is an `Array`.
+ * Checks whether a value is an `Array`.
  *
  * **When to use**
  *
@@ -1397,7 +1381,7 @@ export declare const scanRight: {
  */
 export declare const isArray: {
     /**
-     * Tests whether a value is an `Array`.
+     * Checks whether a value is an `Array`.
      *
      * **When to use**
      *
@@ -1425,7 +1409,7 @@ export declare const isArray: {
      */
     (self: unknown): self is Array<unknown>;
     /**
-     * Tests whether a value is an `Array`.
+     * Checks whether a value is an `Array`.
      *
      * **When to use**
      *
@@ -1454,7 +1438,7 @@ export declare const isArray: {
     <T>(self: T): self is Extract<T, ReadonlyArray<any>>;
 };
 /**
- * Tests whether a mutable `Array` is empty, narrowing the type to `[]`.
+ * Checks whether a mutable `Array` is empty, narrowing the type to `[]`.
  *
  * **Example** (Checking for an empty array)
  *
@@ -1473,7 +1457,7 @@ export declare const isArray: {
  */
 export declare const isArrayEmpty: <A>(self: Array<A>) => self is [];
 /**
- * Tests whether a `ReadonlyArray` is empty, narrowing the type to `readonly []`.
+ * Checks whether a `ReadonlyArray` is empty, narrowing the type to `readonly []`.
  *
  * **Example** (Checking for an empty readonly array)
  *
@@ -1492,7 +1476,7 @@ export declare const isArrayEmpty: <A>(self: Array<A>) => self is [];
  */
 export declare const isReadonlyArrayEmpty: <A>(self: ReadonlyArray<A>) => self is readonly [];
 /**
- * Tests whether a mutable `Array` is non-empty, narrowing the type to
+ * Checks whether a mutable `Array` is non-empty, narrowing the type to
  * `NonEmptyArray`.
  *
  * **Example** (Checking for a non-empty array)
@@ -1512,7 +1496,7 @@ export declare const isReadonlyArrayEmpty: <A>(self: ReadonlyArray<A>) => self i
  */
 export declare const isArrayNonEmpty: <A>(self: Array<A>) => self is NonEmptyArray<A>;
 /**
- * Tests whether a `ReadonlyArray` is non-empty, narrowing the type to
+ * Checks whether a `ReadonlyArray` is non-empty, narrowing the type to
  * `NonEmptyReadonlyArray`.
  *
  * **Example** (Checking for a non-empty readonly array)
@@ -1551,7 +1535,7 @@ export declare const isReadonlyArrayNonEmpty: <A>(self: ReadonlyArray<A>) => sel
  */
 export declare const length: <A>(self: ReadonlyArray<A>) => number;
 /**
- * Safely reads an element at the given index, returning `Option.some` or
+ * Reads an element at the given index safely, returning `Option.some` or
  * `Option.none` if the index is out of bounds.
  *
  * **When to use**
@@ -1582,7 +1566,7 @@ export declare const length: <A>(self: ReadonlyArray<A>) => number;
  */
 export declare const get: {
     /**
-     * Safely reads an element at the given index, returning `Option.some` or
+     * Reads an element at the given index safely, returning `Option.some` or
      * `Option.none` if the index is out of bounds.
      *
      * **When to use**
@@ -1613,7 +1597,7 @@ export declare const get: {
      */
     (index: number): <A>(self: ReadonlyArray<A>) => Option.Option<A>;
     /**
-     * Safely reads an element at the given index, returning `Option.some` or
+     * Reads an element at the given index safely, returning `Option.some` or
      * `Option.none` if the index is out of bounds.
      *
      * **When to use**
@@ -1791,7 +1775,7 @@ export declare const unprepend: <A>(self: NonEmptyReadonlyArray<A>) => [firstEle
  */
 export declare const unappend: <A>(self: NonEmptyReadonlyArray<A>) => [arrayWithoutLastElement: Array<A>, lastElement: A];
 /**
- * Returns the first element of an array wrapped in `Option.some`, or
+ * Returns the first element of an array safely wrapped in `Option.some`, or
  * `Option.none` if the array is empty.
  *
  * **When to use**
@@ -1838,7 +1822,7 @@ export declare const head: <A>(self: ReadonlyArray<A>) => Option.Option<A>;
  */
 export declare const headNonEmpty: <A>(self: NonEmptyReadonlyArray<A>) => A;
 /**
- * Returns the last element of an array wrapped in `Option.some`, or
+ * Returns the last element of an array safely wrapped in `Option.some`, or
  * `Option.none` if the array is empty.
  *
  * **When to use**
@@ -1885,7 +1869,7 @@ export declare const last: <A>(self: ReadonlyArray<A>) => Option.Option<A>;
  */
 export declare const lastNonEmpty: <A>(self: NonEmptyReadonlyArray<A>) => A;
 /**
- * Returns all elements except the first, wrapped in an `Option`.
+ * Returns all elements except the first safely, wrapped in an `Option`.
  *
  * **When to use**
  *
@@ -1935,7 +1919,7 @@ export declare function tail<A>(self: Iterable<A>): Option.Option<Array<A>>;
  */
 export declare const tailNonEmpty: <A>(self: NonEmptyReadonlyArray<A>) => Array<A>;
 /**
- * Returns all elements except the last, wrapped in an `Option`.
+ * Returns all elements except the last safely, wrapped in an `Option`.
  *
  * **When to use**
  *
@@ -3589,7 +3573,7 @@ export declare const findLast: {
     <A>(self: Iterable<A>, predicate: (a: A, i: number) => boolean): Option.Option<A>;
 };
 /**
- * Inserts an element at the specified index, returning a new `NonEmptyArray`
+ * Inserts an element at the specified index safely, returning a new `NonEmptyArray`
  * wrapped in an `Option`.
  *
  * **When to use**
@@ -3599,7 +3583,6 @@ export declare const findLast: {
  * **Details**
  *
  * - Valid indices: `0` to `length` (inclusive — inserting at `length` appends).
- * - Does not mutate the input.
  *
  * **Example** (Inserting at an index)
  *
@@ -3617,7 +3600,7 @@ export declare const findLast: {
  */
 export declare const insertAt: {
     /**
-     * Inserts an element at the specified index, returning a new `NonEmptyArray`
+     * Inserts an element at the specified index safely, returning a new `NonEmptyArray`
      * wrapped in an `Option`.
      *
      * **When to use**
@@ -3627,7 +3610,6 @@ export declare const insertAt: {
      * **Details**
      *
      * - Valid indices: `0` to `length` (inclusive — inserting at `length` appends).
-     * - Does not mutate the input.
      *
      * **Example** (Inserting at an index)
      *
@@ -3645,7 +3627,7 @@ export declare const insertAt: {
      */
     <B>(i: number, b: B): <A>(self: Iterable<A>) => Option.Option<NonEmptyArray<A | B>>;
     /**
-     * Inserts an element at the specified index, returning a new `NonEmptyArray`
+     * Inserts an element at the specified index safely, returning a new `NonEmptyArray`
      * wrapped in an `Option`.
      *
      * **When to use**
@@ -3655,7 +3637,6 @@ export declare const insertAt: {
      * **Details**
      *
      * - Valid indices: `0` to `length` (inclusive — inserting at `length` appends).
-     * - Does not mutate the input.
      *
      * **Example** (Inserting at an index)
      *
@@ -3674,7 +3655,7 @@ export declare const insertAt: {
     <A, B>(self: Iterable<A>, i: number, b: B): Option.Option<NonEmptyArray<A | B>>;
 };
 /**
- * Replaces the element at the specified index with a new value, returning the
+ * Replaces the element at the specified index safely with a new value, returning the
  * updated array in `Option.some`.
  *
  * **When to use**
@@ -3684,7 +3665,6 @@ export declare const insertAt: {
  * **Details**
  *
  * - Returns `Option.none()` when the index is out of bounds.
- * - Does not mutate the input.
  *
  * **Example** (Replacing an element)
  *
@@ -3702,7 +3682,7 @@ export declare const insertAt: {
  */
 export declare const replace: {
     /**
-     * Replaces the element at the specified index with a new value, returning the
+     * Replaces the element at the specified index safely with a new value, returning the
      * updated array in `Option.some`.
      *
      * **When to use**
@@ -3712,7 +3692,6 @@ export declare const replace: {
      * **Details**
      *
      * - Returns `Option.none()` when the index is out of bounds.
-     * - Does not mutate the input.
      *
      * **Example** (Replacing an element)
      *
@@ -3730,7 +3709,7 @@ export declare const replace: {
      */
     <B>(i: number, b: B): <A, S extends Iterable<A> = Iterable<A>>(self: S) => Option.Option<ReadonlyArray.With<S, ReadonlyArray.Infer<S> | B>>;
     /**
-     * Replaces the element at the specified index with a new value, returning the
+     * Replaces the element at the specified index safely with a new value, returning the
      * updated array in `Option.some`.
      *
      * **When to use**
@@ -3740,7 +3719,6 @@ export declare const replace: {
      * **Details**
      *
      * - Returns `Option.none()` when the index is out of bounds.
-     * - Does not mutate the input.
      *
      * **Example** (Replacing an element)
      *
@@ -3759,7 +3737,7 @@ export declare const replace: {
     <A, B, S extends Iterable<A> = Iterable<A>>(self: S, i: number, b: B): Option.Option<ReadonlyArray.With<S, ReadonlyArray.Infer<S> | B>>;
 };
 /**
- * Applies a function to the element at the specified index, returning the
+ * Applies a function to the element at the specified index safely, returning the
  * updated array in `Option.some`.
  *
  * **When to use**
@@ -3770,7 +3748,6 @@ export declare const replace: {
  * **Details**
  *
  * - Returns `Option.none()` when the index is out of bounds.
- * - Does not mutate the input.
  *
  * **Example** (Modifying an element)
  *
@@ -3790,7 +3767,7 @@ export declare const replace: {
  */
 export declare const modify: {
     /**
-     * Applies a function to the element at the specified index, returning the
+     * Applies a function to the element at the specified index safely, returning the
      * updated array in `Option.some`.
      *
      * **When to use**
@@ -3801,7 +3778,6 @@ export declare const modify: {
      * **Details**
      *
      * - Returns `Option.none()` when the index is out of bounds.
-     * - Does not mutate the input.
      *
      * **Example** (Modifying an element)
      *
@@ -3821,7 +3797,7 @@ export declare const modify: {
      */
     <A, B, S extends Iterable<A> = Iterable<A>>(i: number, f: (a: ReadonlyArray.Infer<S>) => B): (self: S) => Option.Option<ReadonlyArray.With<S, ReadonlyArray.Infer<S> | B>>;
     /**
-     * Applies a function to the element at the specified index, returning the
+     * Applies a function to the element at the specified index safely, returning the
      * updated array in `Option.some`.
      *
      * **When to use**
@@ -3832,7 +3808,6 @@ export declare const modify: {
      * **Details**
      *
      * - Returns `Option.none()` when the index is out of bounds.
-     * - Does not mutate the input.
      *
      * **Example** (Modifying an element)
      *
@@ -3860,10 +3835,6 @@ export declare const modify: {
  *
  * Use to remove a single element at a known index.
  *
- * **Details**
- *
- * Does not mutate the input.
- *
  * **Example** (Removing an element)
  *
  * ```ts
@@ -3888,10 +3859,6 @@ export declare const remove: {
      *
      * Use to remove a single element at a known index.
      *
-     * **Details**
-     *
-     * Does not mutate the input.
-     *
      * **Example** (Removing an element)
      *
      * ```ts
@@ -3916,10 +3883,6 @@ export declare const remove: {
      *
      * Use to remove a single element at a known index.
      *
-     * **Details**
-     *
-     * Does not mutate the input.
-     *
      * **Example** (Removing an element)
      *
      * ```ts
@@ -3946,7 +3909,6 @@ export declare const remove: {
  *
  * **Details**
  *
- * - Does not mutate the input.
  * - Preserves `NonEmptyArray` in the return type.
  *
  * **Example** (Reversing an array)
@@ -3970,7 +3932,6 @@ export declare const reverse: <S extends Iterable<any>>(self: S) => S extends No
  *
  * **Details**
  *
- * - Does not mutate the input.
  * - Preserves `NonEmptyArray` in the return type.
  * - Use {@link sortWith} to sort by a derived key, or {@link sortBy} for
  *   multi-key sorting.
@@ -3999,7 +3960,6 @@ export declare const sort: {
      *
      * **Details**
      *
-     * - Does not mutate the input.
      * - Preserves `NonEmptyArray` in the return type.
      * - Use {@link sortWith} to sort by a derived key, or {@link sortBy} for
      *   multi-key sorting.
@@ -4028,7 +3988,6 @@ export declare const sort: {
      *
      * **Details**
      *
-     * - Does not mutate the input.
      * - Preserves `NonEmptyArray` in the return type.
      * - Use {@link sortWith} to sort by a derived key, or {@link sortBy} for
      *   multi-key sorting.
@@ -4057,7 +4016,6 @@ export declare const sort: {
      *
      * **Details**
      *
-     * - Does not mutate the input.
      * - Preserves `NonEmptyArray` in the return type.
      * - Use {@link sortWith} to sort by a derived key, or {@link sortBy} for
      *   multi-key sorting.
@@ -4090,7 +4048,6 @@ export declare const sort: {
  * **Details**
  *
  * - Equivalent to `sort(Order.mapInput(order, f))` but more convenient.
- * - Does not mutate the input.
  *
  * **Example** (Sorting strings by length)
  *
@@ -4120,7 +4077,6 @@ export declare const sortWith: {
      * **Details**
      *
      * - Equivalent to `sort(Order.mapInput(order, f))` but more convenient.
-     * - Does not mutate the input.
      *
      * **Example** (Sorting strings by length)
      *
@@ -4150,7 +4106,6 @@ export declare const sortWith: {
      * **Details**
      *
      * - Equivalent to `sort(Order.mapInput(order, f))` but more convenient.
-     * - Does not mutate the input.
      *
      * **Example** (Sorting strings by length)
      *
@@ -4180,7 +4135,6 @@ export declare const sortWith: {
      * **Details**
      *
      * - Equivalent to `sort(Order.mapInput(order, f))` but more convenient.
-     * - Does not mutate the input.
      *
      * **Example** (Sorting strings by length)
      *
@@ -4830,7 +4784,7 @@ export declare const setLastNonEmpty: {
     <A, B>(self: NonEmptyReadonlyArray<A>, b: B): NonEmptyArray<A | B>;
 };
 /**
- * Rotates an array by `n` steps. Positive `n` rotates right; negative `n`
+ * Transforms an array by rotating it `n` steps. Positive `n` rotates right; negative `n`
  * rotates left.
  *
  * **When to use**
@@ -4860,7 +4814,7 @@ export declare const setLastNonEmpty: {
  */
 export declare const rotate: {
     /**
-     * Rotates an array by `n` steps. Positive `n` rotates right; negative `n`
+     * Transforms an array by rotating it `n` steps. Positive `n` rotates right; negative `n`
      * rotates left.
      *
      * **When to use**
@@ -4890,7 +4844,7 @@ export declare const rotate: {
      */
     (n: number): <S extends Iterable<any>>(self: S) => ReadonlyArray.With<S, ReadonlyArray.Infer<S>>;
     /**
-     * Rotates an array by `n` steps. Positive `n` rotates right; negative `n`
+     * Transforms an array by rotating it `n` steps. Positive `n` rotates right; negative `n`
      * rotates left.
      *
      * **When to use**
@@ -4920,7 +4874,7 @@ export declare const rotate: {
      */
     <A>(self: NonEmptyReadonlyArray<A>, n: number): NonEmptyArray<A>;
     /**
-     * Rotates an array by `n` steps. Positive `n` rotates right; negative `n`
+     * Transforms an array by rotating it `n` steps. Positive `n` rotates right; negative `n`
      * rotates left.
      *
      * **When to use**
@@ -4977,7 +4931,7 @@ export declare const containsWith: <A>(isEquivalent: (self: A, that: A) => boole
     (self: Iterable<A>, a: A): boolean;
 };
 /**
- * Tests whether an array contains a value, using `Equal.equivalence()` for
+ * Checks whether an array contains a value, using `Equal.equivalence()` for
  * comparison.
  *
  * **When to use**
@@ -5000,7 +4954,7 @@ export declare const containsWith: <A>(isEquivalent: (self: A, that: A) => boole
  */
 export declare const contains: {
     /**
-     * Tests whether an array contains a value, using `Equal.equivalence()` for
+     * Checks whether an array contains a value, using `Equal.equivalence()` for
      * comparison.
      *
      * **When to use**
@@ -5023,7 +4977,7 @@ export declare const contains: {
      */
     <A>(a: A): (self: Iterable<A>) => boolean;
     /**
-     * Tests whether an array contains a value, using `Equal.equivalence()` for
+     * Checks whether an array contains a value, using `Equal.equivalence()` for
      * comparison.
      *
      * **When to use**
@@ -5047,8 +5001,8 @@ export declare const contains: {
     <A>(self: Iterable<A>, a: A): boolean;
 };
 /**
- * Repeatedly applies a function that consumes a prefix of the array and
- * produces a value plus the remaining elements, collecting the values.
+ * Applies a function repeatedly to consume prefixes of the array and collect
+ * the values it produces.
  *
  * **When to use**
  *
@@ -5082,8 +5036,8 @@ export declare const contains: {
  */
 export declare const chop: {
     /**
-     * Repeatedly applies a function that consumes a prefix of the array and
-     * produces a value plus the remaining elements, collecting the values.
+     * Applies a function repeatedly to consume prefixes of the array and collect
+     * the values it produces.
      *
      * **When to use**
      *
@@ -5117,8 +5071,8 @@ export declare const chop: {
      */
     <S extends Iterable<any>, B>(f: (as: NonEmptyReadonlyArray<ReadonlyArray.Infer<S>>) => readonly [B, ReadonlyArray<ReadonlyArray.Infer<S>>]): (self: S) => ReadonlyArray.With<S, ReadonlyArray.Infer<S>>;
     /**
-     * Repeatedly applies a function that consumes a prefix of the array and
-     * produces a value plus the remaining elements, collecting the values.
+     * Applies a function repeatedly to consume prefixes of the array and collect
+     * the values it produces.
      *
      * **When to use**
      *
@@ -5152,8 +5106,8 @@ export declare const chop: {
      */
     <A, B>(self: NonEmptyReadonlyArray<A>, f: (as: NonEmptyReadonlyArray<A>) => readonly [B, ReadonlyArray<A>]): NonEmptyArray<B>;
     /**
-     * Repeatedly applies a function that consumes a prefix of the array and
-     * produces a value plus the remaining elements, collecting the values.
+     * Applies a function repeatedly to consume prefixes of the array and collect
+     * the values it produces.
      *
      * **When to use**
      *
@@ -7665,7 +7619,7 @@ export declare const flatMapNullishOr: {
  */
 export declare const liftResult: <A extends Array<unknown>, E, B>(f: (...a: A) => Result.Result<B, E>) => (...a: A) => Array<B>;
 /**
- * Tests whether all elements satisfy the predicate. Supports refinements for
+ * Checks whether all elements satisfy the predicate. Supports refinements for
  * type narrowing.
  *
  * **When to use**
@@ -7689,7 +7643,7 @@ export declare const liftResult: <A extends Array<unknown>, E, B>(f: (...a: A) =
  */
 export declare const every: {
     /**
-     * Tests whether all elements satisfy the predicate. Supports refinements for
+     * Checks whether all elements satisfy the predicate. Supports refinements for
      * type narrowing.
      *
      * **When to use**
@@ -7713,7 +7667,7 @@ export declare const every: {
      */
     <A, B extends A>(refinement: (a: NoInfer<A>, i: number) => a is B): (self: ReadonlyArray<A>) => self is ReadonlyArray<B>;
     /**
-     * Tests whether all elements satisfy the predicate. Supports refinements for
+     * Checks whether all elements satisfy the predicate. Supports refinements for
      * type narrowing.
      *
      * **When to use**
@@ -7737,7 +7691,7 @@ export declare const every: {
      */
     <A>(predicate: (a: NoInfer<A>, i: number) => boolean): (self: ReadonlyArray<A>) => boolean;
     /**
-     * Tests whether all elements satisfy the predicate. Supports refinements for
+     * Checks whether all elements satisfy the predicate. Supports refinements for
      * type narrowing.
      *
      * **When to use**
@@ -7761,7 +7715,7 @@ export declare const every: {
      */
     <A, B extends A>(self: ReadonlyArray<A>, refinement: (a: A, i: number) => a is B): self is ReadonlyArray<B>;
     /**
-     * Tests whether all elements satisfy the predicate. Supports refinements for
+     * Checks whether all elements satisfy the predicate. Supports refinements for
      * type narrowing.
      *
      * **When to use**
@@ -7786,7 +7740,7 @@ export declare const every: {
     <A>(self: ReadonlyArray<A>, predicate: (a: A, i: number) => boolean): boolean;
 };
 /**
- * Tests whether at least one element satisfies the predicate. Narrows the type
+ * Checks whether at least one element satisfies the predicate. Narrows the type
  * to `NonEmptyReadonlyArray` on success.
  *
  * **Example** (Testing for any match)
@@ -7806,7 +7760,7 @@ export declare const every: {
  */
 export declare const some: {
     /**
-     * Tests whether at least one element satisfies the predicate. Narrows the type
+     * Checks whether at least one element satisfies the predicate. Narrows the type
      * to `NonEmptyReadonlyArray` on success.
      *
      * **Example** (Testing for any match)
@@ -7826,7 +7780,7 @@ export declare const some: {
      */
     <A>(predicate: (a: NoInfer<A>, i: number) => boolean): (self: ReadonlyArray<A>) => self is NonEmptyReadonlyArray<A>;
     /**
-     * Tests whether at least one element satisfies the predicate. Narrows the type
+     * Checks whether at least one element satisfies the predicate. Narrows the type
      * to `NonEmptyReadonlyArray` on success.
      *
      * **Example** (Testing for any match)
@@ -8721,7 +8675,7 @@ export declare const cartesian: {
     <A, B>(self: ReadonlyArray<A>, that: ReadonlyArray<B>): Array<[A, B]>;
 };
 /**
- * Starting point for the "do simulation" — an array comprehension pattern.
+ * Provides the starting point for the "do simulation" — an array comprehension pattern.
  *
  * **When to use**
  *
@@ -8753,7 +8707,7 @@ export declare const cartesian: {
  */
 export declare const Do: ReadonlyArray<{}>;
 /**
- * Introduces a new array variable into a do-notation scope, producing the cartesian product with all previous bindings.
+ * Adds a new array variable to a do-notation scope, producing the cartesian product with all previous bindings.
  *
  * **When to use**
  *
@@ -8789,7 +8743,7 @@ export declare const Do: ReadonlyArray<{}>;
  */
 export declare const bind: {
     /**
-     * Introduces a new array variable into a do-notation scope, producing the cartesian product with all previous bindings.
+     * Adds a new array variable to a do-notation scope, producing the cartesian product with all previous bindings.
      *
      * **When to use**
      *
@@ -8827,7 +8781,7 @@ export declare const bind: {
         [K in N | keyof A]: K extends keyof A ? A[K] : B;
     }>;
     /**
-     * Introduces a new array variable into a do-notation scope, producing the cartesian product with all previous bindings.
+     * Adds a new array variable to a do-notation scope, producing the cartesian product with all previous bindings.
      *
      * **When to use**
      *
@@ -8866,7 +8820,7 @@ export declare const bind: {
     }>;
 };
 /**
- * Names the elements of an array by wrapping each in an object with the given key, starting a do-notation scope.
+ * Wraps each array element in an object with the given key, starting a do-notation scope.
  *
  * **When to use**
  *
@@ -8898,7 +8852,7 @@ export declare const bind: {
  */
 export declare const bindTo: {
     /**
-     * Names the elements of an array by wrapping each in an object with the given key, starting a do-notation scope.
+     * Wraps each array element in an object with the given key, starting a do-notation scope.
      *
      * **When to use**
      *
@@ -8932,7 +8886,7 @@ export declare const bindTo: {
         [K in N]: A;
     }>;
     /**
-     * Names the elements of an array by wrapping each in an object with the given key, starting a do-notation scope.
+     * Wraps each array element in an object with the given key, starting a do-notation scope.
      *
      * **When to use**
      *
@@ -9023,7 +8977,7 @@ export declare function getReadonlyReducerConcat<A>(): Reducer.Reducer<ReadonlyA
  */
 export declare function makeReducerConcat<A>(): Reducer.Reducer<Array<A>>;
 /**
- * Counts the elements in an iterable that satisfy a predicate.
+ * Computes the number of elements in an iterable that satisfy a predicate.
  *
  * **When to use**
  *
@@ -9051,7 +9005,7 @@ export declare function makeReducerConcat<A>(): Reducer.Reducer<Array<A>>;
  */
 export declare const countBy: {
     /**
-     * Counts the elements in an iterable that satisfy a predicate.
+     * Computes the number of elements in an iterable that satisfy a predicate.
      *
      * **When to use**
      *
@@ -9079,7 +9033,7 @@ export declare const countBy: {
      */
     <A>(predicate: (a: NoInfer<A>, i: number) => boolean): (self: Iterable<A>) => number;
     /**
-     * Counts the elements in an iterable that satisfy a predicate.
+     * Computes the number of elements in an iterable that satisfy a predicate.
      *
      * **When to use**
      *