effect 4.0.0-beta.70 → 4.0.0-beta.72

package/dist/Chunk.d.ts

@@ -195,7 +195,7 @@ interface ISlice<A> {
  */
 export declare const makeEquivalence: <A>(isEquivalent: Equivalence.Equivalence<A>) => Equivalence.Equivalence<Chunk<A>>;
 /**
- * Checks if `u` is a `Chunk<unknown>`
+ * Checks whether `u` is a `Chunk<unknown>`
  *
  * **Example** (Checking for chunks)
  *
@@ -215,7 +215,7 @@ export declare const makeEquivalence: <A>(isEquivalent: Equivalence.Equivalence<
  */
 export declare const isChunk: {
     /**
-     * Checks if `u` is a `Chunk<unknown>`
+     * Checks whether `u` is a `Chunk<unknown>`
      *
      * **Example** (Checking for chunks)
      *
@@ -235,7 +235,7 @@ export declare const isChunk: {
      */
     <A>(u: Iterable<A>): u is Chunk<A>;
     /**
-     * Checks if `u` is a `Chunk<unknown>`
+     * Checks whether `u` is a `Chunk<unknown>`
      *
      * **Example** (Checking for chunks)
      *
@@ -371,7 +371,15 @@ export declare const toArray: <S extends Chunk<any>>(self: S) => S extends NonEm
 export declare const toReadonlyArray: <S extends Chunk<any>>(self: S) => S extends NonEmptyChunk<any> ? RA.NonEmptyReadonlyArray<Chunk.Infer<S>> : ReadonlyArray<Chunk.Infer<S>>;
 /**
  * Reverses the order of elements in a `Chunk`.
- * Importantly, if the input chunk is a `NonEmptyChunk`, the reversed chunk will also be a `NonEmptyChunk`.
+ *
+ * **When to use**
+ *
+ * Use to read or process chunk elements in reverse order.
+ *
+ * **Details**
+ *
+ * If the input chunk is a `NonEmptyChunk`, the reversed chunk is also a
+ * `NonEmptyChunk`.
  *
  * **Example** (Reversing chunks)
  *
@@ -389,7 +397,8 @@ export declare const toReadonlyArray: <S extends Chunk<any>>(self: S) => S exten
  */
 export declare const reverse: <S extends Chunk<any>>(self: S) => Chunk.With<S, Chunk.Infer<S>>;
 /**
- * This function provides a safe way to read a value at a particular index from a `Chunk`.
+ * Gets the value at an index in a `Chunk` safely, returning `None` when the index is
+ * out of bounds.
  *
  * **Example** (Accessing elements safely)
  *
@@ -412,7 +421,8 @@ export declare const reverse: <S extends Chunk<any>>(self: S) => Chunk.With<S, C
  */
 export declare const get: {
     /**
-     * This function provides a safe way to read a value at a particular index from a `Chunk`.
+     * Gets the value at an index in a `Chunk` safely, returning `None` when the index is
+     * out of bounds.
      *
      * **Example** (Accessing elements safely)
      *
@@ -435,7 +445,8 @@ export declare const get: {
      */
     (index: number): <A>(self: Chunk<A>) => Option<A>;
     /**
-     * This function provides a safe way to read a value at a particular index from a `Chunk`.
+     * Gets the value at an index in a `Chunk` safely, returning `None` when the index is
+     * out of bounds.
      *
      * **Example** (Accessing elements safely)
      *
@@ -459,7 +470,8 @@ export declare const get: {
     <A>(self: Chunk<A>, index: number): Option<A>;
 };
 /**
- * Wraps an array into a chunk without copying, unsafe on mutable arrays
+ * Wraps an array into a chunk without copying, so mutating the source array can
+ * mutate the chunk.
  *
  * **Example** (Creating chunks without copying arrays)
  *
@@ -480,7 +492,8 @@ export declare const get: {
  */
 export declare const fromArrayUnsafe: <A>(self: ReadonlyArray<A>) => Chunk<A>;
 /**
- * Wraps an array into a chunk without copying, unsafe on mutable arrays
+ * Wraps a non-empty array into a non-empty chunk without copying, so mutating
+ * the source array can mutate the chunk.
  *
  * **Example** (Creating non-empty chunks without copying arrays)
  *
@@ -566,6 +579,11 @@ export declare const getUnsafe: {
 /**
  * Appends the specified element to the end of the `Chunk`.
  *
+ * **When to use**
+ *
+ * Use to add one element after the existing elements and get a non-empty
+ * result.
+ *
  * **Example** (Appending an element)
  *
  * ```ts
@@ -581,6 +599,9 @@ export declare const getUnsafe: {
  * console.log(Chunk.toArray(singleElement)) // [42]
  * ```
  *
+ * @see {@link prepend} for adding one element before the existing elements
+ * @see {@link appendAll} for appending all elements from another chunk
+ *
  * @category concatenating
  * @since 2.0.0
  */
@@ -588,6 +609,11 @@ export declare const append: {
     /**
      * Appends the specified element to the end of the `Chunk`.
      *
+     * **When to use**
+     *
+     * Use to add one element after the existing elements and get a non-empty
+     * result.
+     *
      * **Example** (Appending an element)
      *
      * ```ts
@@ -603,6 +629,9 @@ export declare const append: {
      * console.log(Chunk.toArray(singleElement)) // [42]
      * ```
      *
+     * @see {@link prepend} for adding one element before the existing elements
+     * @see {@link appendAll} for appending all elements from another chunk
+     *
      * @category concatenating
      * @since 2.0.0
      */
@@ -610,6 +639,11 @@ export declare const append: {
     /**
      * Appends the specified element to the end of the `Chunk`.
      *
+     * **When to use**
+     *
+     * Use to add one element after the existing elements and get a non-empty
+     * result.
+     *
      * **Example** (Appending an element)
      *
      * ```ts
@@ -625,13 +659,16 @@ export declare const append: {
      * console.log(Chunk.toArray(singleElement)) // [42]
      * ```
      *
+     * @see {@link prepend} for adding one element before the existing elements
+     * @see {@link appendAll} for appending all elements from another chunk
+     *
      * @category concatenating
      * @since 2.0.0
      */
     <A, A2>(self: Chunk<A>, a: A2): NonEmptyChunk<A | A2>;
 };
 /**
- * Prepend an element to the front of a `Chunk`, creating a new `NonEmptyChunk`.
+ * Prepends an element to the front of a `Chunk`, creating a new `NonEmptyChunk`.
  *
  * **Example** (Prepending an element)
  *
@@ -653,7 +690,7 @@ export declare const append: {
  */
 export declare const prepend: {
     /**
-     * Prepend an element to the front of a `Chunk`, creating a new `NonEmptyChunk`.
+     * Prepends an element to the front of a `Chunk`, creating a new `NonEmptyChunk`.
      *
      * **Example** (Prepending an element)
      *
@@ -675,7 +712,7 @@ export declare const prepend: {
      */
     <B>(elem: B): <A>(self: Chunk<A>) => NonEmptyChunk<B | A>;
     /**
-     * Prepend an element to the front of a `Chunk`, creating a new `NonEmptyChunk`.
+     * Prepends an element to the front of a `Chunk`, creating a new `NonEmptyChunk`.
      *
      * **Example** (Prepending an element)
      *
@@ -1020,6 +1057,11 @@ export declare const prependAll: {
  * Concatenates two chunks, combining their elements.
  * If either chunk is non-empty, the result is also a non-empty chunk.
  *
+ * **When to use**
+ *
+ * Use to concatenate two chunks when the second chunk's elements should come
+ * after the first.
+ *
  * **Example** (Appending all elements)
  *
  * ```ts
@@ -1034,6 +1076,9 @@ export declare const prependAll: {
  * // [ 1, 2, "a", "b" ]
  * ```
  *
+ * @see {@link prependAll} for concatenating chunks in the opposite order
+ * @see {@link append} for adding a single element to the end
+ *
  * @category concatenating
  * @since 2.0.0
  */
@@ -1042,6 +1087,11 @@ export declare const appendAll: {
      * Concatenates two chunks, combining their elements.
      * If either chunk is non-empty, the result is also a non-empty chunk.
      *
+     * **When to use**
+     *
+     * Use to concatenate two chunks when the second chunk's elements should come
+     * after the first.
+     *
      * **Example** (Appending all elements)
      *
      * ```ts
@@ -1056,6 +1106,9 @@ export declare const appendAll: {
      * // [ 1, 2, "a", "b" ]
      * ```
      *
+     * @see {@link prependAll} for concatenating chunks in the opposite order
+     * @see {@link append} for adding a single element to the end
+     *
      * @category concatenating
      * @since 2.0.0
      */
@@ -1064,6 +1117,11 @@ export declare const appendAll: {
      * Concatenates two chunks, combining their elements.
      * If either chunk is non-empty, the result is also a non-empty chunk.
      *
+     * **When to use**
+     *
+     * Use to concatenate two chunks when the second chunk's elements should come
+     * after the first.
+     *
      * **Example** (Appending all elements)
      *
      * ```ts
@@ -1078,6 +1136,9 @@ export declare const appendAll: {
      * // [ 1, 2, "a", "b" ]
      * ```
      *
+     * @see {@link prependAll} for concatenating chunks in the opposite order
+     * @see {@link append} for adding a single element to the end
+     *
      * @category concatenating
      * @since 2.0.0
      */
@@ -1086,6 +1147,11 @@ export declare const appendAll: {
      * Concatenates two chunks, combining their elements.
      * If either chunk is non-empty, the result is also a non-empty chunk.
      *
+     * **When to use**
+     *
+     * Use to concatenate two chunks when the second chunk's elements should come
+     * after the first.
+     *
      * **Example** (Appending all elements)
      *
      * ```ts
@@ -1100,6 +1166,9 @@ export declare const appendAll: {
      * // [ 1, 2, "a", "b" ]
      * ```
      *
+     * @see {@link prependAll} for concatenating chunks in the opposite order
+     * @see {@link append} for adding a single element to the end
+     *
      * @category concatenating
      * @since 2.0.0
      */
@@ -1108,6 +1177,11 @@ export declare const appendAll: {
      * Concatenates two chunks, combining their elements.
      * If either chunk is non-empty, the result is also a non-empty chunk.
      *
+     * **When to use**
+     *
+     * Use to concatenate two chunks when the second chunk's elements should come
+     * after the first.
+     *
      * **Example** (Appending all elements)
      *
      * ```ts
@@ -1122,6 +1196,9 @@ export declare const appendAll: {
      * // [ 1, 2, "a", "b" ]
      * ```
      *
+     * @see {@link prependAll} for concatenating chunks in the opposite order
+     * @see {@link append} for adding a single element to the end
+     *
      * @category concatenating
      * @since 2.0.0
      */
@@ -1406,7 +1483,7 @@ export declare const filterMapWhile: {
     <A, B, X>(self: Chunk<A>, f: Filter.Filter<A, B, X>): Chunk<B>;
 };
 /**
- * Filter out optional values
+ * Filters out optional values
  *
  * **Example** (Compacting optional values)
  *
@@ -1686,6 +1763,20 @@ export declare const flatten: <S extends Chunk<Chunk<any>>>(self: S) => Chunk.Fl
 /**
  * Groups elements in chunks of up to `n` elements.
  *
+ * **When to use**
+ *
+ * Use to divide a chunk into ordered, non-overlapping batches with at most `n`
+ * elements each.
+ *
+ * **Details**
+ *
+ * The final chunk may contain fewer than `n` elements. Empty input produces an
+ * empty chunk of chunks.
+ *
+ * **Gotchas**
+ *
+ * Values of `n` less than or equal to zero produce singleton chunks.
+ *
  * **Example** (Splitting into fixed-size chunks)
  *
  * ```ts
@@ -1704,6 +1795,8 @@ export declare const flatten: <S extends Chunk<Chunk<any>>>(self: S) => Chunk.Fl
  * // [[1, 2], [3, 4], [5]]
  * ```
  *
+ * @see {@link split} for splitting into a target number of chunks instead of a fixed chunk size
+ *
  * @category elements
  * @since 2.0.0
  */
@@ -1711,6 +1804,20 @@ export declare const chunksOf: {
     /**
      * Groups elements in chunks of up to `n` elements.
      *
+     * **When to use**
+     *
+     * Use to divide a chunk into ordered, non-overlapping batches with at most `n`
+     * elements each.
+     *
+     * **Details**
+     *
+     * The final chunk may contain fewer than `n` elements. Empty input produces an
+     * empty chunk of chunks.
+     *
+     * **Gotchas**
+     *
+     * Values of `n` less than or equal to zero produce singleton chunks.
+     *
      * **Example** (Splitting into fixed-size chunks)
      *
      * ```ts
@@ -1729,6 +1836,8 @@ export declare const chunksOf: {
      * // [[1, 2], [3, 4], [5]]
      * ```
      *
+     * @see {@link split} for splitting into a target number of chunks instead of a fixed chunk size
+     *
      * @category elements
      * @since 2.0.0
      */
@@ -1736,6 +1845,20 @@ export declare const chunksOf: {
     /**
      * Groups elements in chunks of up to `n` elements.
      *
+     * **When to use**
+     *
+     * Use to divide a chunk into ordered, non-overlapping batches with at most `n`
+     * elements each.
+     *
+     * **Details**
+     *
+     * The final chunk may contain fewer than `n` elements. Empty input produces an
+     * empty chunk of chunks.
+     *
+     * **Gotchas**
+     *
+     * Values of `n` less than or equal to zero produce singleton chunks.
+     *
      * **Example** (Splitting into fixed-size chunks)
      *
      * ```ts
@@ -1754,6 +1877,8 @@ export declare const chunksOf: {
      * // [[1, 2], [3, 4], [5]]
      * ```
      *
+     * @see {@link split} for splitting into a target number of chunks instead of a fixed chunk size
+     *
      * @category elements
      * @since 2.0.0
      */
@@ -1889,7 +2014,7 @@ export declare const isEmpty: <A>(self: Chunk<A>) => boolean;
  */
 export declare const isNonEmpty: <A>(self: Chunk<A>) => self is NonEmptyChunk<A>;
 /**
- * Returns the first element of this chunk if it exists.
+ * Returns the first element of this chunk safely if it exists.
  *
  * **Example** (Getting the first element)
  *
@@ -1953,7 +2078,7 @@ export declare const headUnsafe: <A>(self: Chunk<A>) => A;
  */
 export declare const headNonEmpty: <A>(self: NonEmptyChunk<A>) => A;
 /**
- * Returns the last element of this chunk if it exists.
+ * Returns the last element of this chunk safely if it exists.
  *
  * **Example** (Getting the last element)
  *
@@ -2232,7 +2357,7 @@ export declare const map: {
     <A, B>(self: Chunk<A>, f: (a: A, i: number) => B): Chunk<B>;
 };
 /**
- * Statefully maps over the chunk, producing new elements of type `B`.
+ * Maps over the chunk statefully, producing new elements of type `B`.
  *
  * **Example** (Mapping with accumulated state)
  *
@@ -2263,7 +2388,7 @@ export declare const map: {
  */
 export declare const mapAccum: {
     /**
-     * Statefully maps over the chunk, producing new elements of type `B`.
+     * Maps over the chunk statefully, producing new elements of type `B`.
      *
      * **Example** (Mapping with accumulated state)
      *
@@ -2294,7 +2419,7 @@ export declare const mapAccum: {
      */
     <S, A, B>(s: S, f: (s: S, a: A) => readonly [S, B]): (self: Chunk<A>) => [S, Chunk<B>];
     /**
-     * Statefully maps over the chunk, producing new elements of type `B`.
+     * Maps over the chunk statefully, producing new elements of type `B`.
      *
      * **Example** (Mapping with accumulated state)
      *
@@ -2452,7 +2577,7 @@ export declare const separate: <A, B>(self: Chunk<Result<B, A>>) => [Chunk<A>, C
  */
 export declare const size: <A>(self: Chunk<A>) => number;
 /**
- * Sort the elements of a Chunk in increasing order, creating a new Chunk.
+ * Sorts the elements of a `Chunk` in increasing order, creating a new `Chunk`.
  *
  * **Example** (Sorting chunks)
  *
@@ -2478,7 +2603,7 @@ export declare const size: <A>(self: Chunk<A>) => number;
  */
 export declare const sort: {
     /**
-     * Sort the elements of a Chunk in increasing order, creating a new Chunk.
+     * Sorts the elements of a `Chunk` in increasing order, creating a new `Chunk`.
      *
      * **Example** (Sorting chunks)
      *
@@ -2504,7 +2629,7 @@ export declare const sort: {
      */
     <B>(O: Order.Order<B>): <A extends B>(self: Chunk<A>) => Chunk<A>;
     /**
-     * Sort the elements of a Chunk in increasing order, creating a new Chunk.
+     * Sorts the elements of a `Chunk` in increasing order, creating a new `Chunk`.
      *
      * **Example** (Sorting chunks)
      *
@@ -2531,7 +2656,7 @@ export declare const sort: {
     <A extends B, B>(self: Chunk<A>, O: Order.Order<B>): Chunk<A>;
 };
 /**
- * Sorts the elements of a Chunk based on a projection function.
+ * Sorts the elements of a `Chunk` based on a projection function.
  *
  * **Example** (Sorting chunks by a derived value)
  *
@@ -2565,7 +2690,7 @@ export declare const sort: {
  */
 export declare const sortWith: {
     /**
-     * Sorts the elements of a Chunk based on a projection function.
+     * Sorts the elements of a `Chunk` based on a projection function.
      *
      * **Example** (Sorting chunks by a derived value)
      *
@@ -2599,7 +2724,7 @@ export declare const sortWith: {
      */
     <A, B>(f: (a: A) => B, order: Order.Order<B>): (self: Chunk<A>) => Chunk<A>;
     /**
-     * Sorts the elements of a Chunk based on a projection function.
+     * Sorts the elements of a `Chunk` based on a projection function.
      *
      * **Example** (Sorting chunks by a derived value)
      *
@@ -3010,7 +3135,7 @@ export declare const splitWhere: {
     <A>(self: Chunk<A>, predicate: Predicate<A>): [beforeMatch: Chunk<A>, fromMatch: Chunk<A>];
 };
 /**
- * Returns every elements after the first.
+ * Returns every element after the first safely, or `None` when the chunk is empty.
  *
  * **Example** (Getting the tail safely)
  *
@@ -3032,7 +3157,7 @@ export declare const splitWhere: {
  */
 export declare const tail: <A>(self: Chunk<A>) => O.Option<Chunk<A>>;
 /**
- * Returns every elements after the first.
+ * Returns every element after the first from a non-empty chunk.
  *
  * **Example** (Getting the tail of a non-empty chunk)
  *
@@ -3564,7 +3689,7 @@ export declare const zip: {
     <A, B>(self: Chunk<A>, that: Chunk<B>): Chunk<[A, B]>;
 };
 /**
- * Delete the element at the specified index, creating a new `Chunk`.
+ * Deletes the element at the specified index, creating a new `Chunk`.
  *
  * **Example** (Removing an element)
  *
@@ -3589,7 +3714,7 @@ export declare const zip: {
  */
 export declare const remove: {
     /**
-     * Delete the element at the specified index, creating a new `Chunk`.
+     * Deletes the element at the specified index, creating a new `Chunk`.
      *
      * **Example** (Removing an element)
      *
@@ -3614,7 +3739,7 @@ export declare const remove: {
      */
     (i: number): <A>(self: Chunk<A>) => Chunk<A>;
     /**
-     * Delete the element at the specified index, creating a new `Chunk`.
+     * Deletes the element at the specified index, creating a new `Chunk`.
      *
      * **Example** (Removing an element)
      *
@@ -3640,7 +3765,7 @@ export declare const remove: {
     <A>(self: Chunk<A>, i: number): Chunk<A>;
 };
 /**
- * Applies a function to the element at the specified index, creating a new `Chunk`,
+ * Applies a function to the element at the specified index safely, creating a new `Chunk`,
  * or returns `None` if the index is out of bounds.
  *
  * **Example** (Modifying an element)
@@ -3666,7 +3791,7 @@ export declare const remove: {
  */
 export declare const modify: {
     /**
-     * Applies a function to the element at the specified index, creating a new `Chunk`,
+     * Applies a function to the element at the specified index safely, creating a new `Chunk`,
      * or returns `None` if the index is out of bounds.
      *
      * **Example** (Modifying an element)
@@ -3692,7 +3817,7 @@ export declare const modify: {
      */
     <A, B>(i: number, f: (a: A) => B): (self: Chunk<A>) => O.Option<Chunk<A | B>>;
     /**
-     * Applies a function to the element at the specified index, creating a new `Chunk`,
+     * Applies a function to the element at the specified index safely, creating a new `Chunk`,
      * or returns `None` if the index is out of bounds.
      *
      * **Example** (Modifying an element)
@@ -3719,7 +3844,7 @@ export declare const modify: {
     <A, B>(self: Chunk<A>, i: number, f: (a: A) => B): O.Option<Chunk<A | B>>;
 };
 /**
- * Change the element at the specified index, creating a new `Chunk`,
+ * Changes the element at the specified index safely, creating a new `Chunk`,
  * or returns `None` if the index is out of bounds.
  *
  * **Example** (Replacing an element)
@@ -3745,7 +3870,7 @@ export declare const modify: {
  */
 export declare const replace: {
     /**
-     * Change the element at the specified index, creating a new `Chunk`,
+     * Changes the element at the specified index safely, creating a new `Chunk`,
      * or returns `None` if the index is out of bounds.
      *
      * **Example** (Replacing an element)
@@ -3771,7 +3896,7 @@ export declare const replace: {
      */
     <B>(i: number, b: B): <A>(self: Chunk<A>) => O.Option<Chunk<B | A>>;
     /**
-     * Change the element at the specified index, creating a new `Chunk`,
+     * Changes the element at the specified index safely, creating a new `Chunk`,
      * or returns `None` if the index is out of bounds.
      *
      * **Example** (Replacing an element)
@@ -4149,7 +4274,7 @@ export declare const findFirst: {
     <A>(self: Chunk<A>, predicate: Predicate<A>): Option<A>;
 };
 /**
- * Return the first index for which a predicate holds.
+ * Returns the first index for which a predicate holds.
  *
  * **Example** (Finding the first matching index)
  *
@@ -4174,7 +4299,7 @@ export declare const findFirst: {
  */
 export declare const findFirstIndex: {
     /**
-     * Return the first index for which a predicate holds.
+     * Returns the first index for which a predicate holds.
      *
      * **Example** (Finding the first matching index)
      *
@@ -4199,7 +4324,7 @@ export declare const findFirstIndex: {
      */
     <A>(predicate: Predicate<A>): (self: Chunk<A>) => O.Option<number>;
     /**
-     * Return the first index for which a predicate holds.
+     * Returns the first index for which a predicate holds.
      *
      * **Example** (Finding the first matching index)
      *
@@ -4225,7 +4350,7 @@ export declare const findFirstIndex: {
     <A>(self: Chunk<A>, predicate: Predicate<A>): O.Option<number>;
 };
 /**
- * Find the last element for which a predicate holds.
+ * Finds the last element for which a predicate holds.
  *
  * **Example** (Finding the last matching element)
  *
@@ -4251,7 +4376,7 @@ export declare const findFirstIndex: {
  */
 export declare const findLast: {
     /**
-     * Find the last element for which a predicate holds.
+     * Finds the last element for which a predicate holds.
      *
      * **Example** (Finding the last matching element)
      *
@@ -4277,7 +4402,7 @@ export declare const findLast: {
      */
     <A, B extends A>(refinement: Refinement<NoInfer<A>, B>): (self: Chunk<A>) => Option<B>;
     /**
-     * Find the last element for which a predicate holds.
+     * Finds the last element for which a predicate holds.
      *
      * **Example** (Finding the last matching element)
      *
@@ -4303,7 +4428,7 @@ export declare const findLast: {
      */
     <A>(predicate: Predicate<NoInfer<A>>): (self: Chunk<A>) => Option<A>;
     /**
-     * Find the last element for which a predicate holds.
+     * Finds the last element for which a predicate holds.
      *
      * **Example** (Finding the last matching element)
      *
@@ -4329,7 +4454,7 @@ export declare const findLast: {
      */
     <A, B extends A>(self: Chunk<A>, refinement: Refinement<A, B>): Option<B>;
     /**
-     * Find the last element for which a predicate holds.
+     * Finds the last element for which a predicate holds.
      *
      * **Example** (Finding the last matching element)
      *
@@ -4356,7 +4481,7 @@ export declare const findLast: {
     <A>(self: Chunk<A>, predicate: Predicate<A>): Option<A>;
 };
 /**
- * Return the last index for which a predicate holds.
+ * Returns the last index for which a predicate holds.
  *
  * **Example** (Finding the last matching index)
  *
@@ -4381,7 +4506,7 @@ export declare const findLast: {
  */
 export declare const findLastIndex: {
     /**
-     * Return the last index for which a predicate holds.
+     * Returns the last index for which a predicate holds.
      *
      * **Example** (Finding the last matching index)
      *
@@ -4406,7 +4531,7 @@ export declare const findLastIndex: {
      */
     <A>(predicate: Predicate<A>): (self: Chunk<A>) => O.Option<number>;
     /**
-     * Return the last index for which a predicate holds.
+     * Returns the last index for which a predicate holds.
      *
      * **Example** (Finding the last matching index)
      *
@@ -4432,7 +4557,7 @@ export declare const findLastIndex: {
     <A>(self: Chunk<A>, predicate: Predicate<A>): O.Option<number>;
 };
 /**
- * Check if a predicate holds true for every `Chunk` element.
+ * Checks whether a predicate holds true for every `Chunk` element.
  *
  * **Example** (Checking every element)
  *
@@ -4460,7 +4585,7 @@ export declare const findLastIndex: {
  */
 export declare const every: {
     /**
-     * Check if a predicate holds true for every `Chunk` element.
+     * Checks whether a predicate holds true for every `Chunk` element.
      *
      * **Example** (Checking every element)
      *
@@ -4488,7 +4613,7 @@ export declare const every: {
      */
     <A, B extends A>(refinement: Refinement<NoInfer<A>, B>): (self: Chunk<A>) => self is Chunk<B>;
     /**
-     * Check if a predicate holds true for every `Chunk` element.
+     * Checks whether a predicate holds true for every `Chunk` element.
      *
      * **Example** (Checking every element)
      *
@@ -4516,7 +4641,7 @@ export declare const every: {
      */
     <A>(predicate: Predicate<A>): (self: Chunk<A>) => boolean;
     /**
-     * Check if a predicate holds true for every `Chunk` element.
+     * Checks whether a predicate holds true for every `Chunk` element.
      *
      * **Example** (Checking every element)
      *
@@ -4544,7 +4669,7 @@ export declare const every: {
      */
     <A, B extends A>(self: Chunk<A>, refinement: Refinement<A, B>): self is Chunk<B>;
     /**
-     * Check if a predicate holds true for every `Chunk` element.
+     * Checks whether a predicate holds true for every `Chunk` element.
      *
      * **Example** (Checking every element)
      *
@@ -4573,7 +4698,7 @@ export declare const every: {
     <A>(self: Chunk<A>, predicate: Predicate<A>): boolean;
 };
 /**
- * Check if a predicate holds true for some `Chunk` element.
+ * Checks whether a predicate holds true for some `Chunk` element.
  *
  * **Example** (Checking for some matching element)
  *
@@ -4598,7 +4723,7 @@ export declare const every: {
  */
 export declare const some: {
     /**
-     * Check if a predicate holds true for some `Chunk` element.
+     * Checks whether a predicate holds true for some `Chunk` element.
      *
      * **Example** (Checking for some matching element)
      *
@@ -4623,7 +4748,7 @@ export declare const some: {
      */
     <A>(predicate: Predicate<NoInfer<A>>): (self: Chunk<A>) => self is NonEmptyChunk<A>;
     /**
-     * Check if a predicate holds true for some `Chunk` element.
+     * Checks whether a predicate holds true for some `Chunk` element.
      *
      * **Example** (Checking for some matching element)
      *