effect 4.0.1 → 4.0.3

package/src/Array.ts

@@ -7,6 +7,7 @@
  * arrays and preserve non-empty array types when the result is guaranteed to
  * contain values.
  *
+ * @stability stable
  * @since 2.0.0
  */
 import * as Equal from "./Equal.ts"
@@ -45,6 +46,7 @@ import type { NoInfer, TupleOf } from "./Types.ts"
  * Array.Array === globalThis.Array // => true
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -53,6 +55,7 @@ export const Array = globalThis.Array
 /**
  * Type lambda for `ReadonlyArray`, used for higher-kinded type operations.
  *
+ * @stability stable
  * @category utility types
  * @since 2.0.0
  */
@@ -82,6 +85,7 @@ export interface ReadonlyArrayTypeLambda extends TypeLambda {
  * @see {@link NonEmptyArray} — mutable counterpart
  * @see {@link isReadonlyArrayNonEmpty} — narrow a `ReadonlyArray` to this type
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -115,6 +119,7 @@ export type NonEmptyReadonlyArray<A> = readonly [A, ...Array<A>]
  * @see {@link NonEmptyReadonlyArray} — readonly counterpart
  * @see {@link isArrayNonEmpty} — narrow an `Array` to this type
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -143,6 +148,7 @@ export type NonEmptyArray<A> = [A, ...Array<A>]
  * @see {@link of} — create a single-element array
  * @see {@link fromIterable} — create from any iterable
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -172,6 +178,7 @@ export const make = <Elements extends NonEmptyArray<unknown>>(
  *
  * @see {@link makeBy} — create an array by computing each element
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -201,6 +208,7 @@ export const allocate = <A = never>(n: number): Array<A | undefined> => new Arra
  * @see {@link range} — create a range of integers
  * @see {@link replicate} — repeat a single value
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -229,6 +237,7 @@ export const makeBy: {
    * @see {@link range} — create a range of integers
    * @see {@link replicate} — repeat a single value
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -257,6 +266,7 @@ export const makeBy: {
    * @see {@link range} — create a range of integers
    * @see {@link replicate} — repeat a single value
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -292,6 +302,7 @@ export const makeBy: {
  *
  * @see {@link makeBy} — generate values from a function
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -321,6 +332,7 @@ export const range = (start: number, end: number): NonEmptyArray<number> =>
  *
  * @see {@link makeBy} — vary values based on index
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -348,6 +360,7 @@ export const replicate: {
    *
    * @see {@link makeBy} — vary values based on index
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -375,6 +388,7 @@ export const replicate: {
    *
    * @see {@link makeBy} — vary values based on index
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -405,6 +419,7 @@ export const replicate: {
  * @see {@link ensure} — wrap a single value or return an existing array
  * @see {@link copy} — create a shallow copy of an array
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -437,6 +452,7 @@ export const fromIterable = <A>(collection: Iterable<A>): Array<A> =>
  * @see {@link of} — always wrap in a single-element array
  * @see {@link fromIterable} — convert any iterable
  *
+ * @stability stable
  * @category constructors
  * @since 3.3.0
  */
@@ -466,6 +482,7 @@ export const ensure = <A>(self: ReadonlyArray<A> | A): Array<A> => Array.isArray
  * @see {@link Record.toEntries} the equivalent function from the Record module
  * @see {@link Record.fromEntries} to build a record from an array of tuples
  *
+ * @stability stable
  * @category converting
  * @since 2.0.0
  */
@@ -489,6 +506,7 @@ export const fromRecord: <K extends string, A>(self: Readonly<Record<K, A>>) =>
  *
  * @see {@link getSomes} — extract `Some` values from an array of Options
  *
+ * @stability stable
  * @category converting
  * @since 2.0.0
  */
@@ -523,6 +541,7 @@ export const fromOption: <A>(self: Option.Option<A>) => Array<A> = Option.toArra
  * @see {@link matchLeft} — destructures into head + tail
  * @see {@link matchRight} — destructures into init + last
  *
+ * @stability stable
  * @category pattern matching
  * @since 2.0.0
  */
@@ -556,6 +575,7 @@ export const match: {
    * @see {@link matchLeft} — destructures into head + tail
    * @see {@link matchRight} — destructures into init + last
    *
+   * @stability stable
    * @category pattern matching
    * @since 2.0.0
    */
@@ -594,6 +614,7 @@ export const match: {
    * @see {@link matchLeft} — destructures into head + tail
    * @see {@link matchRight} — destructures into init + last
    *
+   * @stability stable
    * @category pattern matching
    * @since 2.0.0
    */
@@ -642,6 +663,7 @@ export const match: {
  * @see {@link match} — receives the full non-empty array
  * @see {@link matchRight} — destructures into init + last
  *
+ * @stability stable
  * @category pattern matching
  * @since 2.0.0
  */
@@ -676,6 +698,7 @@ export const matchLeft: {
    * @see {@link match} — receives the full non-empty array
    * @see {@link matchRight} — destructures into init + last
    *
+   * @stability stable
    * @category pattern matching
    * @since 2.0.0
    */
@@ -715,6 +738,7 @@ export const matchLeft: {
    * @see {@link match} — receives the full non-empty array
    * @see {@link matchRight} — destructures into init + last
    *
+   * @stability stable
    * @category pattern matching
    * @since 2.0.0
    */
@@ -763,6 +787,7 @@ export const matchLeft: {
  * @see {@link match} — receives the full non-empty array
  * @see {@link matchLeft} — destructures into head + tail
  *
+ * @stability stable
  * @category pattern matching
  * @since 2.0.0
  */
@@ -797,6 +822,7 @@ export const matchRight: {
    * @see {@link match} — receives the full non-empty array
    * @see {@link matchLeft} — destructures into head + tail
    *
+   * @stability stable
    * @category pattern matching
    * @since 2.0.0
    */
@@ -836,6 +862,7 @@ export const matchRight: {
    * @see {@link match} — receives the full non-empty array
    * @see {@link matchLeft} — destructures into head + tail
    *
+   * @stability stable
    * @category pattern matching
    * @since 2.0.0
    */
@@ -876,6 +903,7 @@ export const matchRight: {
  * @see {@link append} — add to the end
  * @see {@link prependAll} — prepend multiple elements
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -899,6 +927,7 @@ export const prepend: {
    * @see {@link append} — add to the end
    * @see {@link prependAll} — prepend multiple elements
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -922,6 +951,7 @@ export const prepend: {
    * @see {@link append} — add to the end
    * @see {@link prependAll} — prepend multiple elements
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -950,6 +980,7 @@ export const prepend: {
  * @see {@link prepend} — add a single element to the front
  * @see {@link appendAll} — add elements to the end
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -976,6 +1007,7 @@ export const prependAll: {
    * @see {@link prepend} — add a single element to the front
    * @see {@link appendAll} — add elements to the end
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1002,6 +1034,7 @@ export const prependAll: {
    * @see {@link prepend} — add a single element to the front
    * @see {@link appendAll} — add elements to the end
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1028,6 +1061,7 @@ export const prependAll: {
    * @see {@link prepend} — add a single element to the front
    * @see {@link appendAll} — add elements to the end
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1054,6 +1088,7 @@ export const prependAll: {
    * @see {@link prepend} — add a single element to the front
    * @see {@link appendAll} — add elements to the end
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1082,6 +1117,7 @@ export const prependAll: {
  * @see {@link prepend} — add to the front
  * @see {@link appendAll} — append multiple elements
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -1105,6 +1141,7 @@ export const append: {
    * @see {@link prepend} — add to the front
    * @see {@link appendAll} — append multiple elements
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1128,6 +1165,7 @@ export const append: {
    * @see {@link prepend} — add to the front
    * @see {@link appendAll} — append multiple elements
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1157,6 +1195,7 @@ export const append: {
  * @see {@link append} — add a single element to the end
  * @see {@link prependAll} — add elements to the front
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -1184,6 +1223,7 @@ export const appendAll: {
    * @see {@link append} — add a single element to the end
    * @see {@link prependAll} — add elements to the front
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1211,6 +1251,7 @@ export const appendAll: {
    * @see {@link append} — add a single element to the end
    * @see {@link prependAll} — add elements to the front
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1238,6 +1279,7 @@ export const appendAll: {
    * @see {@link append} — add a single element to the end
    * @see {@link prependAll} — add elements to the front
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1265,6 +1307,7 @@ export const appendAll: {
    * @see {@link append} — add a single element to the end
    * @see {@link prependAll} — add elements to the front
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1298,6 +1341,7 @@ export const appendAll: {
  * @see {@link scanRight} — right-to-left scan
  * @see {@link reduce} — fold without intermediate values
  *
+ * @stability stable
  * @category folding
  * @since 2.0.0
  */
@@ -1326,6 +1370,7 @@ export const scan: {
    * @see {@link scanRight} — right-to-left scan
    * @see {@link reduce} — fold without intermediate values
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -1354,6 +1399,7 @@ export const scan: {
    * @see {@link scanRight} — right-to-left scan
    * @see {@link reduce} — fold without intermediate values
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -1392,6 +1438,7 @@ export const scan: {
  * @see {@link scan} — left-to-right scan
  * @see {@link reduceRight} — fold without intermediate values
  *
+ * @stability stable
  * @category folding
  * @since 2.0.0
  */
@@ -1420,6 +1467,7 @@ export const scanRight: {
    * @see {@link scan} — left-to-right scan
    * @see {@link reduceRight} — fold without intermediate values
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -1448,6 +1496,7 @@ export const scanRight: {
    * @see {@link scan} — left-to-right scan
    * @see {@link reduceRight} — fold without intermediate values
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -1486,6 +1535,7 @@ export const scanRight: {
  * @see {@link isArrayEmpty} — check for an empty array
  * @see {@link isArrayNonEmpty} — check for a non-empty array
  *
+ * @stability stable
  * @category guards
  * @since 2.0.0
  */
@@ -1514,6 +1564,7 @@ export const isArray: {
    * @see {@link isArrayEmpty} — check for an empty array
    * @see {@link isArrayNonEmpty} — check for a non-empty array
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -1542,6 +1593,7 @@ export const isArray: {
    * @see {@link isArrayEmpty} — check for an empty array
    * @see {@link isArrayNonEmpty} — check for a non-empty array
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -1563,6 +1615,7 @@ export const isArray: {
  * @see {@link isReadonlyArrayEmpty} — readonly variant
  * @see {@link isArrayNonEmpty} — opposite check
  *
+ * @stability stable
  * @category guards
  * @since 4.0.0
  */
@@ -1583,6 +1636,7 @@ export const isArrayEmpty = <A>(self: Array<A>): self is [] => self.length === 0
  * @see {@link isArrayEmpty} — mutable variant
  * @see {@link isReadonlyArrayNonEmpty} — opposite check
  *
+ * @stability stable
  * @category guards
  * @since 4.0.0
  */
@@ -1609,6 +1663,7 @@ export const isReadonlyArrayEmpty: <A>(self: ReadonlyArray<A>) => self is readon
  * @see {@link isReadonlyArrayNonEmpty} — readonly variant
  * @see {@link isArrayEmpty} — opposite check
  *
+ * @stability stable
  * @category guards
  * @since 4.0.0
  */
@@ -1635,6 +1690,7 @@ export const isArrayNonEmpty: <A>(self: Array<A>) => self is NonEmptyArray<A> =
  * @see {@link isArrayNonEmpty} — mutable variant
  * @see {@link isReadonlyArrayEmpty} — opposite check
  *
+ * @stability stable
  * @category guards
  * @since 4.0.0
  */
@@ -1656,6 +1712,7 @@ export const isReadonlyArrayNonEmpty: <A>(self: ReadonlyArray<A>) => self is Non
  * Array.length([1, 2, 3]) // => 3
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -1704,6 +1761,7 @@ export function isOutOfBounds<A>(i: number, as: ReadonlyArray<A>): boolean {
  * @see {@link head} for reading the first element as an `Option`
  * @see {@link last} for reading the last element as an `Option`
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -1734,6 +1792,7 @@ export const get: {
    * @see {@link head} for reading the first element as an `Option`
    * @see {@link last} for reading the last element as an `Option`
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -1764,6 +1823,7 @@ export const get: {
    * @see {@link head} for reading the first element as an `Option`
    * @see {@link last} for reading the last element as an `Option`
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -1797,6 +1857,7 @@ export const get: {
  *
  * @see {@link get} — safe version returning `Option`
  *
+ * @stability stable
  * @category unsafe
  * @since 4.0.0
  */
@@ -1825,6 +1886,7 @@ export const getUnsafe: {
    *
    * @see {@link get} — safe version returning `Option`
    *
+   * @stability stable
    * @category unsafe
    * @since 4.0.0
    */
@@ -1853,6 +1915,7 @@ export const getUnsafe: {
    *
    * @see {@link get} — safe version returning `Option`
    *
+   * @stability stable
    * @category unsafe
    * @since 4.0.0
    */
@@ -1889,6 +1952,7 @@ export const getUnsafe: {
  * @see {@link headNonEmpty} for getting only the first element
  * @see {@link tailNonEmpty} for getting only the elements after the first
  *
+ * @stability stable
  * @category splitting
  * @since 2.0.0
  */
@@ -1921,6 +1985,7 @@ export const unprepend = <A>(
  * @see {@link initNonEmpty} for getting only the elements before the last
  * @see {@link lastNonEmpty} for getting only the last element
  *
+ * @stability stable
  * @category splitting
  * @since 2.0.0
  */
@@ -1948,6 +2013,7 @@ export const unappend = <A>(
  * @see {@link headNonEmpty} — direct access when array is known non-empty
  * @see {@link last} — get the last element
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -1972,6 +2038,7 @@ export const head: <A>(self: ReadonlyArray<A>) => Option.Option<A> = get(0)
  *
  * @see {@link head} — safe version for possibly-empty arrays
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -1997,6 +2064,7 @@ export const headNonEmpty: <A>(self: NonEmptyReadonlyArray<A>) => A = getUnsafe(
  * @see {@link lastNonEmpty} — direct access when array is known non-empty
  * @see {@link head} — get the first element
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -2022,6 +2090,7 @@ export const last = <A>(self: ReadonlyArray<A>): Option.Option<A> =>
  *
  * @see {@link last} — safe version for possibly-empty arrays
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -2050,6 +2119,7 @@ export const lastNonEmpty = <A>(self: NonEmptyReadonlyArray<A>): A => self[self.
  * @see {@link tailNonEmpty} — when the array is known non-empty
  * @see {@link init} — all elements except the last
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -2076,6 +2146,7 @@ export function tail<A>(self: Iterable<A>): Option.Option<Array<A>> {
  * @see {@link tail} — safe version for possibly-empty arrays
  * @see {@link initNonEmpty} — all elements except the last
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -2105,6 +2176,7 @@ export const tailNonEmpty = <A>(self: NonEmptyReadonlyArray<A>): Array<A> => sel
  * @see {@link initNonEmpty} — when the array is known non-empty
  * @see {@link tail} — all elements except the first
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -2131,6 +2203,7 @@ export function init<A>(self: Iterable<A>): Option.Option<Array<A>> {
  * @see {@link init} — safe version for possibly-empty arrays
  * @see {@link tailNonEmpty} — all elements except the first
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -2162,6 +2235,7 @@ const clampCount = (n: number, length: number): number => Math.min(Count.normali
  * @see {@link takeWhile} for keeping an initial prefix while a predicate holds
  * @see {@link drop} for removing elements from the start
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -2190,6 +2264,7 @@ export const take: {
    * @see {@link takeWhile} for keeping an initial prefix while a predicate holds
    * @see {@link drop} for removing elements from the start
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -2218,6 +2293,7 @@ export const take: {
    * @see {@link takeWhile} for keeping an initial prefix while a predicate holds
    * @see {@link drop} for removing elements from the start
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -2250,6 +2326,7 @@ export const take: {
  * @see {@link take} — keep from the start
  * @see {@link dropRight} — remove from the end
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -2277,6 +2354,7 @@ export const takeRight: {
    * @see {@link take} — keep from the start
    * @see {@link dropRight} — remove from the end
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -2304,6 +2382,7 @@ export const takeRight: {
    * @see {@link take} — keep from the start
    * @see {@link dropRight} — remove from the end
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -2340,6 +2419,7 @@ export const takeRight: {
  * @see {@link dropWhile} for removing the matching prefix and keeping the rest
  * @see {@link span} for splitting the matching prefix from the remaining elements
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -2370,6 +2450,7 @@ export const takeWhile: {
    * @see {@link dropWhile} for removing the matching prefix and keeping the rest
    * @see {@link span} for splitting the matching prefix from the remaining elements
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -2400,6 +2481,7 @@ export const takeWhile: {
    * @see {@link dropWhile} for removing the matching prefix and keeping the rest
    * @see {@link span} for splitting the matching prefix from the remaining elements
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -2430,6 +2512,7 @@ export const takeWhile: {
    * @see {@link dropWhile} for removing the matching prefix and keeping the rest
    * @see {@link span} for splitting the matching prefix from the remaining elements
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -2460,6 +2543,7 @@ export const takeWhile: {
    * @see {@link dropWhile} for removing the matching prefix and keeping the rest
    * @see {@link span} for splitting the matching prefix from the remaining elements
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -2493,6 +2577,7 @@ export const takeWhile: {
  *
  * @see {@link takeWhile} for taking a prefix based on a boolean predicate
  *
+ * @stability stable
  * @category getters
  * @since 4.0.0
  */
@@ -2513,6 +2598,7 @@ export const takeWhileFilter: {
    *
    * @see {@link takeWhile} for taking a prefix based on a boolean predicate
    *
+   * @stability stable
    * @category getters
    * @since 4.0.0
    */
@@ -2533,6 +2619,7 @@ export const takeWhileFilter: {
    *
    * @see {@link takeWhile} for taking a prefix based on a boolean predicate
    *
+   * @stability stable
    * @category getters
    * @since 4.0.0
    */
@@ -2592,6 +2679,7 @@ const spanIndex = <A>(self: Iterable<A>, predicate: (a: A, i: number) => boolean
  * @see {@link dropWhile} for keeping only the elements after the matching prefix
  * @see {@link splitWhere} for splitting at the first element that satisfies a predicate
  *
+ * @stability stable
  * @category splitting
  * @since 2.0.0
  */
@@ -2623,6 +2711,7 @@ export const span: {
    * @see {@link dropWhile} for keeping only the elements after the matching prefix
    * @see {@link splitWhere} for splitting at the first element that satisfies a predicate
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -2654,6 +2743,7 @@ export const span: {
    * @see {@link dropWhile} for keeping only the elements after the matching prefix
    * @see {@link splitWhere} for splitting at the first element that satisfies a predicate
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -2685,6 +2775,7 @@ export const span: {
    * @see {@link dropWhile} for keeping only the elements after the matching prefix
    * @see {@link splitWhere} for splitting at the first element that satisfies a predicate
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -2716,6 +2807,7 @@ export const span: {
    * @see {@link dropWhile} for keeping only the elements after the matching prefix
    * @see {@link splitWhere} for splitting at the first element that satisfies a predicate
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -2753,6 +2845,7 @@ export const span: {
  * @see {@link dropWhile} for removing a prefix based on a predicate instead of a fixed count
  * @see {@link take} for keeping a fixed number of elements from the start
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -2782,6 +2875,7 @@ export const drop: {
    * @see {@link dropWhile} for removing a prefix based on a predicate instead of a fixed count
    * @see {@link take} for keeping a fixed number of elements from the start
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -2811,6 +2905,7 @@ export const drop: {
    * @see {@link dropWhile} for removing a prefix based on a predicate instead of a fixed count
    * @see {@link take} for keeping a fixed number of elements from the start
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -2842,6 +2937,7 @@ export const drop: {
  * @see {@link drop} — remove from the start
  * @see {@link takeRight} — keep from the end
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -2868,6 +2964,7 @@ export const dropRight: {
    * @see {@link drop} — remove from the start
    * @see {@link takeRight} — keep from the end
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -2894,6 +2991,7 @@ export const dropRight: {
    * @see {@link drop} — remove from the start
    * @see {@link takeRight} — keep from the end
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -2925,6 +3023,7 @@ export const dropRight: {
  * @see {@link takeWhile} — keep the matching prefix instead
  * @see {@link drop} — drop a fixed count
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -2951,6 +3050,7 @@ export const dropWhile: {
    * @see {@link takeWhile} — keep the matching prefix instead
    * @see {@link drop} — drop a fixed count
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -2977,6 +3077,7 @@ export const dropWhile: {
    * @see {@link takeWhile} — keep the matching prefix instead
    * @see {@link drop} — drop a fixed count
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -3009,6 +3110,7 @@ export const dropWhile: {
  * @see {@link dropWhile} for dropping a prefix with a simple boolean predicate
  * @see {@link takeWhileFilter} for keeping only the matching prefix
  *
+ * @stability stable
  * @category getters
  * @since 4.0.0
  */
@@ -3029,6 +3131,7 @@ export const dropWhileFilter: {
    * @see {@link dropWhile} for dropping a prefix with a simple boolean predicate
    * @see {@link takeWhileFilter} for keeping only the matching prefix
    *
+   * @stability stable
    * @category getters
    * @since 4.0.0
    */
@@ -3049,6 +3152,7 @@ export const dropWhileFilter: {
    * @see {@link dropWhile} for dropping a prefix with a simple boolean predicate
    * @see {@link takeWhileFilter} for keeping only the matching prefix
    *
+   * @stability stable
    * @category getters
    * @since 4.0.0
    */
@@ -3088,6 +3192,7 @@ export const dropWhileFilter: {
  * @see {@link findLastIndex} — search from the end
  * @see {@link findFirst} — get the element itself
  *
+ * @stability stable
  * @category searching
  * @since 2.0.0
  */
@@ -3112,6 +3217,7 @@ export const findFirstIndex: {
    * @see {@link findLastIndex} — search from the end
    * @see {@link findFirst} — get the element itself
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -3136,6 +3242,7 @@ export const findFirstIndex: {
    * @see {@link findLastIndex} — search from the end
    * @see {@link findFirst} — get the element itself
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -3170,6 +3277,7 @@ export const findFirstIndex: {
  * @see {@link findFirstIndex} — search from the start
  * @see {@link findLast} — get the element itself
  *
+ * @stability stable
  * @category searching
  * @since 2.0.0
  */
@@ -3193,6 +3301,7 @@ export const findLastIndex: {
    * @see {@link findFirstIndex} — search from the start
    * @see {@link findLast} — get the element itself
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -3216,6 +3325,7 @@ export const findLastIndex: {
    * @see {@link findFirstIndex} — search from the start
    * @see {@link findLast} — get the element itself
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -3257,6 +3367,7 @@ export const findLastIndex: {
  * @see {@link findFirstIndex} — get the index instead
  * @see {@link findFirstWithIndex} — get both element and index
  *
+ * @stability stable
  * @category searching
  * @since 2.0.0
  */
@@ -3288,6 +3399,7 @@ export const findFirst: {
    * @see {@link findFirstIndex} — get the index instead
    * @see {@link findFirstWithIndex} — get both element and index
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -3319,6 +3431,7 @@ export const findFirst: {
    * @see {@link findFirstIndex} — get the index instead
    * @see {@link findFirstWithIndex} — get both element and index
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -3350,6 +3463,7 @@ export const findFirst: {
    * @see {@link findFirstIndex} — get the index instead
    * @see {@link findFirstWithIndex} — get both element and index
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -3381,6 +3495,7 @@ export const findFirst: {
    * @see {@link findFirstIndex} — get the index instead
    * @see {@link findFirstWithIndex} — get both element and index
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -3412,6 +3527,7 @@ export const findFirst: {
    * @see {@link findFirstIndex} — get the index instead
    * @see {@link findFirstWithIndex} — get both element and index
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -3443,6 +3559,7 @@ export const findFirst: {
    * @see {@link findFirstIndex} — get the index instead
    * @see {@link findFirstWithIndex} — get both element and index
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -3474,6 +3591,7 @@ export const findFirst: {
  * @see {@link findFirst} — get only the element
  * @see {@link findFirstIndex} — get only the index
  *
+ * @stability stable
  * @category searching
  * @since 3.17.0
  */
@@ -3503,6 +3621,7 @@ export const findFirstWithIndex: {
    * @see {@link findFirst} — get only the element
    * @see {@link findFirstIndex} — get only the index
    *
+   * @stability stable
    * @category searching
    * @since 3.17.0
    */
@@ -3532,6 +3651,7 @@ export const findFirstWithIndex: {
    * @see {@link findFirst} — get only the element
    * @see {@link findFirstIndex} — get only the index
    *
+   * @stability stable
    * @category searching
    * @since 3.17.0
    */
@@ -3561,6 +3681,7 @@ export const findFirstWithIndex: {
    * @see {@link findFirst} — get only the element
    * @see {@link findFirstIndex} — get only the index
    *
+   * @stability stable
    * @category searching
    * @since 3.17.0
    */
@@ -3590,6 +3711,7 @@ export const findFirstWithIndex: {
    * @see {@link findFirst} — get only the element
    * @see {@link findFirstIndex} — get only the index
    *
+   * @stability stable
    * @category searching
    * @since 3.17.0
    */
@@ -3619,6 +3741,7 @@ export const findFirstWithIndex: {
    * @see {@link findFirst} — get only the element
    * @see {@link findFirstIndex} — get only the index
    *
+   * @stability stable
    * @category searching
    * @since 3.17.0
    */
@@ -3648,6 +3771,7 @@ export const findFirstWithIndex: {
    * @see {@link findFirst} — get only the element
    * @see {@link findFirstIndex} — get only the index
    *
+   * @stability stable
    * @category searching
    * @since 3.17.0
    */
@@ -3700,6 +3824,7 @@ export const findFirstWithIndex: {
  * @see {@link findFirst} — search from the start
  * @see {@link findLastIndex} — get the index instead
  *
+ * @stability stable
  * @category searching
  * @since 2.0.0
  */
@@ -3728,6 +3853,7 @@ export const findLast: {
    * @see {@link findFirst} — search from the start
    * @see {@link findLastIndex} — get the index instead
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -3756,6 +3882,7 @@ export const findLast: {
    * @see {@link findFirst} — search from the start
    * @see {@link findLastIndex} — get the index instead
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -3784,6 +3911,7 @@ export const findLast: {
    * @see {@link findFirst} — search from the start
    * @see {@link findLastIndex} — get the index instead
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -3812,6 +3940,7 @@ export const findLast: {
    * @see {@link findFirst} — search from the start
    * @see {@link findLastIndex} — get the index instead
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -3840,6 +3969,7 @@ export const findLast: {
    * @see {@link findFirst} — search from the start
    * @see {@link findLastIndex} — get the index instead
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -3868,6 +3998,7 @@ export const findLast: {
    * @see {@link findFirst} — search from the start
    * @see {@link findLastIndex} — get the index instead
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -3919,6 +4050,7 @@ export const findLast: {
  * @see {@link replace} — replace an existing element
  * @see {@link modify} — transform an element at an index
  *
+ * @stability stable
  * @category transforming
  * @since 2.0.0
  */
@@ -3946,6 +4078,7 @@ export const insertAt: {
    * @see {@link replace} — replace an existing element
    * @see {@link modify} — transform an element at an index
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -3973,6 +4106,7 @@ export const insertAt: {
    * @see {@link replace} — replace an existing element
    * @see {@link modify} — transform an element at an index
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -4010,6 +4144,7 @@ export const insertAt: {
  * @see {@link modify} — transform an element with a function
  * @see {@link insertAt} — insert without removing
  *
+ * @stability stable
  * @category transforming
  * @since 2.0.0
  */
@@ -4037,6 +4172,7 @@ export const replace: {
    * @see {@link modify} — transform an element with a function
    * @see {@link insertAt} — insert without removing
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -4066,6 +4202,7 @@ export const replace: {
    * @see {@link modify} — transform an element with a function
    * @see {@link insertAt} — insert without removing
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -4104,6 +4241,7 @@ export const replace: {
  * @see {@link modifyHeadNonEmpty} — modify the first element
  * @see {@link modifyLastNonEmpty} — modify the last element
  *
+ * @stability stable
  * @category transforming
  * @since 2.0.0
  */
@@ -4137,6 +4275,7 @@ export const modify: {
    * @see {@link modifyHeadNonEmpty} — modify the first element
    * @see {@link modifyLastNonEmpty} — modify the last element
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -4170,6 +4309,7 @@ export const modify: {
    * @see {@link modifyHeadNonEmpty} — modify the first element
    * @see {@link modifyLastNonEmpty} — modify the last element
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -4207,6 +4347,7 @@ export const modify: {
  * @see {@link insertAt} — insert an element
  * @see {@link filter} — remove elements by predicate
  *
+ * @stability stable
  * @category transforming
  * @since 2.0.0
  */
@@ -4232,6 +4373,7 @@ export const remove: {
    * @see {@link insertAt} — insert an element
    * @see {@link filter} — remove elements by predicate
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -4257,6 +4399,7 @@ export const remove: {
    * @see {@link insertAt} — insert an element
    * @see {@link filter} — remove elements by predicate
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -4291,6 +4434,7 @@ export const remove: {
  * Array.reverse([1, 2, 3, 4]) // => [4, 3, 2, 1]
  * ```
  *
+ * @stability stable
  * @category transforming
  * @since 2.0.0
  */
@@ -4322,6 +4466,7 @@ export const reverse = <S extends Iterable<any>>(
  * @see {@link sortWith} — sort by a mapping function
  * @see {@link sortBy} — sort by multiple orders
  *
+ * @stability stable
  * @category sorting
  * @since 2.0.0
  */
@@ -4349,6 +4494,7 @@ export const sort: {
    * @see {@link sortWith} — sort by a mapping function
    * @see {@link sortBy} — sort by multiple orders
    *
+   * @stability stable
    * @category sorting
    * @since 2.0.0
    */
@@ -4376,6 +4522,7 @@ export const sort: {
    * @see {@link sortWith} — sort by a mapping function
    * @see {@link sortBy} — sort by multiple orders
    *
+   * @stability stable
    * @category sorting
    * @since 2.0.0
    */
@@ -4403,6 +4550,7 @@ export const sort: {
    * @see {@link sortWith} — sort by a mapping function
    * @see {@link sortBy} — sort by multiple orders
    *
+   * @stability stable
    * @category sorting
    * @since 2.0.0
    */
@@ -4437,6 +4585,7 @@ export const sort: {
  * @see {@link sort} for sorting with an `Order` that compares the elements directly
  * @see {@link sortBy} for sorting with multiple `Order`s applied in sequence
  *
+ * @stability stable
  * @category sorting
  * @since 2.0.0
  */
@@ -4465,6 +4614,7 @@ export const sortWith: {
    * @see {@link sort} for sorting with an `Order` that compares the elements directly
    * @see {@link sortBy} for sorting with multiple `Order`s applied in sequence
    *
+   * @stability stable
    * @category sorting
    * @since 2.0.0
    */
@@ -4493,6 +4643,7 @@ export const sortWith: {
    * @see {@link sort} for sorting with an `Order` that compares the elements directly
    * @see {@link sortBy} for sorting with multiple `Order`s applied in sequence
    *
+   * @stability stable
    * @category sorting
    * @since 2.0.0
    */
@@ -4521,6 +4672,7 @@ export const sortWith: {
    * @see {@link sort} for sorting with an `Order` that compares the elements directly
    * @see {@link sortBy} for sorting with multiple `Order`s applied in sequence
    *
+   * @stability stable
    * @category sorting
    * @since 2.0.0
    */
@@ -4570,6 +4722,7 @@ export const sortWith: {
  * @see {@link sort} — sort by a single `Order`
  * @see {@link sortWith} — sort by a derived key
  *
+ * @stability stable
  * @category sorting
  * @since 2.0.0
  */
@@ -4611,6 +4764,7 @@ export const sortBy = <S extends Iterable<any>>(
  * @see {@link zipWith} — zip with a combiner function
  * @see {@link unzip} — inverse operation
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -4638,6 +4792,7 @@ export const zip: {
    * @see {@link zipWith} — zip with a combiner function
    * @see {@link unzip} — inverse operation
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -4665,6 +4820,7 @@ export const zip: {
    * @see {@link zipWith} — zip with a combiner function
    * @see {@link unzip} — inverse operation
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -4692,6 +4848,7 @@ export const zip: {
    * @see {@link zipWith} — zip with a combiner function
    * @see {@link unzip} — inverse operation
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -4719,6 +4876,7 @@ export const zip: {
    * @see {@link zipWith} — zip with a combiner function
    * @see {@link unzip} — inverse operation
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -4747,6 +4905,7 @@ export const zip: {
  *
  * @see {@link zip} — zip into tuples
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -4770,6 +4929,7 @@ export const zipWith: {
    *
    * @see {@link zip} — zip into tuples
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -4793,6 +4953,7 @@ export const zipWith: {
    *
    * @see {@link zip} — zip into tuples
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -4816,6 +4977,7 @@ export const zipWith: {
    *
    * @see {@link zip} — zip into tuples
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -4843,6 +5005,7 @@ export const zipWith: {
    *
    * @see {@link zip} — zip into tuples
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -4874,6 +5037,7 @@ export const zipWith: {
  *
  * @see {@link zip} — combine two arrays into pairs
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -4917,6 +5081,7 @@ export const unzip: <S extends Iterable<readonly [any, any]>>(
  *
  * @see {@link join} — intersperse and join into a string
  *
+ * @stability stable
  * @category transforming
  * @since 2.0.0
  */
@@ -4943,6 +5108,7 @@ export const intersperse: {
    *
    * @see {@link join} — intersperse and join into a string
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -4969,6 +5135,7 @@ export const intersperse: {
    *
    * @see {@link join} — intersperse and join into a string
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -4995,6 +5162,7 @@ export const intersperse: {
    *
    * @see {@link join} — intersperse and join into a string
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -5034,6 +5202,7 @@ export const intersperse: {
  * @see {@link setHeadNonEmpty} — replace with a fixed value
  * @see {@link modifyLastNonEmpty} — modify the last element
  *
+ * @stability stable
  * @category transforming
  * @since 4.0.0
  */
@@ -5057,6 +5226,7 @@ export const modifyHeadNonEmpty: {
    * @see {@link setHeadNonEmpty} — replace with a fixed value
    * @see {@link modifyLastNonEmpty} — modify the last element
    *
+   * @stability stable
    * @category transforming
    * @since 4.0.0
    */
@@ -5080,6 +5250,7 @@ export const modifyHeadNonEmpty: {
    * @see {@link setHeadNonEmpty} — replace with a fixed value
    * @see {@link modifyLastNonEmpty} — modify the last element
    *
+   * @stability stable
    * @category transforming
    * @since 4.0.0
    */
@@ -5111,6 +5282,7 @@ export const modifyHeadNonEmpty: {
  * @see {@link modifyHeadNonEmpty} — transform the head with a function
  * @see {@link setLastNonEmpty} — replace the last element
  *
+ * @stability stable
  * @category transforming
  * @since 4.0.0
  */
@@ -5134,6 +5306,7 @@ export const setHeadNonEmpty: {
    * @see {@link modifyHeadNonEmpty} — transform the head with a function
    * @see {@link setLastNonEmpty} — replace the last element
    *
+   * @stability stable
    * @category transforming
    * @since 4.0.0
    */
@@ -5157,6 +5330,7 @@ export const setHeadNonEmpty: {
    * @see {@link modifyHeadNonEmpty} — transform the head with a function
    * @see {@link setLastNonEmpty} — replace the last element
    *
+   * @stability stable
    * @category transforming
    * @since 4.0.0
    */
@@ -5186,6 +5360,7 @@ export const setHeadNonEmpty: {
  * @see {@link setLastNonEmpty} — replace with a fixed value
  * @see {@link modifyHeadNonEmpty} — modify the first element
  *
+ * @stability stable
  * @category transforming
  * @since 4.0.0
  */
@@ -5210,6 +5385,7 @@ export const modifyLastNonEmpty: {
    * @see {@link setLastNonEmpty} — replace with a fixed value
    * @see {@link modifyHeadNonEmpty} — modify the first element
    *
+   * @stability stable
    * @category transforming
    * @since 4.0.0
    */
@@ -5234,6 +5410,7 @@ export const modifyLastNonEmpty: {
    * @see {@link setLastNonEmpty} — replace with a fixed value
    * @see {@link modifyHeadNonEmpty} — modify the first element
    *
+   * @stability stable
    * @category transforming
    * @since 4.0.0
    */
@@ -5263,6 +5440,7 @@ export const modifyLastNonEmpty: {
  * @see {@link modifyLastNonEmpty} — transform the last element with a function
  * @see {@link setHeadNonEmpty} — replace the first element
  *
+ * @stability stable
  * @category transforming
  * @since 4.0.0
  */
@@ -5286,6 +5464,7 @@ export const setLastNonEmpty: {
    * @see {@link modifyLastNonEmpty} — transform the last element with a function
    * @see {@link setHeadNonEmpty} — replace the first element
    *
+   * @stability stable
    * @category transforming
    * @since 4.0.0
    */
@@ -5309,6 +5488,7 @@ export const setLastNonEmpty: {
    * @see {@link modifyLastNonEmpty} — transform the last element with a function
    * @see {@link setHeadNonEmpty} — replace the first element
    *
+   * @stability stable
    * @category transforming
    * @since 4.0.0
    */
@@ -5344,6 +5524,7 @@ export const setLastNonEmpty: {
  * @see {@link take} for taking a fixed number of elements from the start
  * @see {@link drop} for dropping a fixed number of elements from the start
  *
+ * @stability stable
  * @category transforming
  * @since 2.0.0
  */
@@ -5374,6 +5555,7 @@ export const rotate: {
    * @see {@link take} for taking a fixed number of elements from the start
    * @see {@link drop} for dropping a fixed number of elements from the start
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -5404,6 +5586,7 @@ export const rotate: {
    * @see {@link take} for taking a fixed number of elements from the start
    * @see {@link drop} for dropping a fixed number of elements from the start
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -5434,6 +5617,7 @@ export const rotate: {
    * @see {@link take} for taking a fixed number of elements from the start
    * @see {@link drop} for dropping a fixed number of elements from the start
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -5476,6 +5660,7 @@ export const rotate: {
  *
  * @see {@link contains} for the `Equal.equivalence()` variant
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -5511,6 +5696,7 @@ export const containsWith = <A>(isEquivalent: (self: A, that: A) => boolean): {
  *
  * @see {@link containsWith} — use custom equality
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -5534,6 +5720,7 @@ export const contains: {
    *
    * @see {@link containsWith} — use custom equality
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -5557,6 +5744,7 @@ export const contains: {
    *
    * @see {@link containsWith} — use custom equality
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -5588,6 +5776,7 @@ export const contains: {
  * @see {@link chunksOf} — split into fixed-size chunks
  * @see {@link splitAt} — split at an index
  *
+ * @stability stable
  * @category splitting
  * @since 2.0.0
  */
@@ -5617,6 +5806,7 @@ export const chop: {
    * @see {@link chunksOf} — split into fixed-size chunks
    * @see {@link splitAt} — split at an index
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -5648,6 +5838,7 @@ export const chop: {
    * @see {@link chunksOf} — split into fixed-size chunks
    * @see {@link splitAt} — split at an index
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -5680,6 +5871,7 @@ export const chop: {
    * @see {@link chunksOf} — split into fixed-size chunks
    * @see {@link splitAt} — split at an index
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -5729,6 +5921,7 @@ export const chop: {
  * @see {@link splitAtNonEmpty} — for non-empty arrays
  * @see {@link splitWhere} — split at a predicate boundary
  *
+ * @stability stable
  * @category splitting
  * @since 2.0.0
  */
@@ -5756,6 +5949,7 @@ export const splitAt: {
    * @see {@link splitAtNonEmpty} — for non-empty arrays
    * @see {@link splitWhere} — split at a predicate boundary
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -5783,6 +5977,7 @@ export const splitAt: {
    * @see {@link splitAtNonEmpty} — for non-empty arrays
    * @see {@link splitWhere} — split at a predicate boundary
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -5822,6 +6017,7 @@ export const splitAt: {
  *
  * @see {@link splitAt} — for possibly-empty arrays
  *
+ * @stability stable
  * @category splitting
  * @since 4.0.0
  */
@@ -5849,6 +6045,7 @@ export const splitAtNonEmpty: {
    *
    * @see {@link splitAt} — for possibly-empty arrays
    *
+   * @stability stable
    * @category splitting
    * @since 4.0.0
    */
@@ -5876,6 +6073,7 @@ export const splitAtNonEmpty: {
    *
    * @see {@link splitAt} — for possibly-empty arrays
    *
+   * @stability stable
    * @category splitting
    * @since 4.0.0
    */
@@ -5909,6 +6107,7 @@ export const splitAtNonEmpty: {
  *
  * @see {@link chunksOf} — split into fixed-size chunks
  *
+ * @stability stable
  * @category splitting
  * @since 2.0.0
  */
@@ -5935,6 +6134,7 @@ export const split: {
    *
    * @see {@link chunksOf} — split into fixed-size chunks
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -5961,6 +6161,7 @@ export const split: {
    *
    * @see {@link chunksOf} — split into fixed-size chunks
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -5990,6 +6191,7 @@ export const split: {
  * @see {@link span} — splits at the first element that fails the predicate
  * @see {@link splitAt} — split at a fixed index
  *
+ * @stability stable
  * @category splitting
  * @since 2.0.0
  */
@@ -6014,6 +6216,7 @@ export const splitWhere: {
    * @see {@link span} — splits at the first element that fails the predicate
    * @see {@link splitAt} — split at a fixed index
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -6038,6 +6241,7 @@ export const splitWhere: {
    * @see {@link span} — splits at the first element that fails the predicate
    * @see {@link splitAt} — split at a fixed index
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -6075,6 +6279,7 @@ export const splitWhere: {
  *
  * @see {@link fromIterable} — returns the same reference for arrays
  *
+ * @stability stable
  * @category transforming
  * @since 2.0.0
  */
@@ -6106,6 +6311,7 @@ export const copy: {
    *
    * @see {@link fromIterable} — returns the same reference for arrays
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -6137,6 +6343,7 @@ export const copy: {
    *
    * @see {@link fromIterable} — returns the same reference for arrays
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -6167,6 +6374,7 @@ export const copy: {
  * @see {@link take} — truncate without padding
  * @see {@link replicate} — create an array of a single repeated value
  *
+ * @stability stable
  * @category transforming
  * @since 3.8.4
  */
@@ -6195,6 +6403,7 @@ export const pad: {
    * @see {@link take} — truncate without padding
    * @see {@link replicate} — create an array of a single repeated value
    *
+   * @stability stable
    * @category transforming
    * @since 3.8.4
    */
@@ -6225,6 +6434,7 @@ export const pad: {
    * @see {@link take} — truncate without padding
    * @see {@link replicate} — create an array of a single repeated value
    *
+   * @stability stable
    * @category transforming
    * @since 3.8.4
    */
@@ -6267,6 +6477,7 @@ export const pad: {
  * @see {@link split} — split into a given number of groups
  * @see {@link window} — sliding windows
  *
+ * @stability stable
  * @category splitting
  * @since 2.0.0
  */
@@ -6298,6 +6509,7 @@ export const chunksOf: {
    * @see {@link split} — split into a given number of groups
    * @see {@link window} — sliding windows
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -6331,6 +6543,7 @@ export const chunksOf: {
    * @see {@link split} — split into a given number of groups
    * @see {@link window} — sliding windows
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -6362,6 +6575,7 @@ export const chunksOf: {
    * @see {@link split} — split into a given number of groups
    * @see {@link window} — sliding windows
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -6400,6 +6614,7 @@ export const chunksOf: {
  *
  * @see {@link chunksOf} — non-overlapping chunks
  *
+ * @stability stable
  * @category splitting
  * @since 3.13.2
  */
@@ -6430,6 +6645,7 @@ export const window: {
    *
    * @see {@link chunksOf} — non-overlapping chunks
    *
+   * @stability stable
    * @category splitting
    * @since 3.13.2
    */
@@ -6460,6 +6676,7 @@ export const window: {
    *
    * @see {@link chunksOf} — non-overlapping chunks
    *
+   * @stability stable
    * @category splitting
    * @since 3.13.2
    */
@@ -6503,6 +6720,7 @@ export const window: {
  * @see {@link group} for grouping adjacent elements with `Equal.equivalence()`
  * @see {@link groupBy} for grouping all elements into a record by key, regardless of adjacency
  *
+ * @stability stable
  * @category grouping
  * @since 2.0.0
  */
@@ -6534,6 +6752,7 @@ export const groupWith: {
    * @see {@link group} for grouping adjacent elements with `Equal.equivalence()`
    * @see {@link groupBy} for grouping all elements into a record by key, regardless of adjacency
    *
+   * @stability stable
    * @category grouping
    * @since 2.0.0
    */
@@ -6565,6 +6784,7 @@ export const groupWith: {
    * @see {@link group} for grouping adjacent elements with `Equal.equivalence()`
    * @see {@link groupBy} for grouping all elements into a record by key, regardless of adjacency
    *
+   * @stability stable
    * @category grouping
    * @since 2.0.0
    */
@@ -6614,6 +6834,7 @@ export const groupWith: {
  * @see {@link groupWith} — use custom equality
  * @see {@link groupBy} — group by a key function into a record
  *
+ * @stability stable
  * @category grouping
  * @since 2.0.0
  */
@@ -6658,6 +6879,7 @@ export const group: <A>(self: NonEmptyReadonlyArray<A>) => NonEmptyArray<NonEmpt
  * @see {@link group} — group adjacent equal elements
  * @see {@link groupWith} — group adjacent elements by custom equality
  *
+ * @stability stable
  * @category grouping
  * @since 2.0.0
  */
@@ -6699,6 +6921,7 @@ export const groupBy: {
    * @see {@link group} — group adjacent equal elements
    * @see {@link groupWith} — group adjacent elements by custom equality
    *
+   * @stability stable
    * @category grouping
    * @since 2.0.0
    */
@@ -6740,6 +6963,7 @@ export const groupBy: {
    * @see {@link group} — group adjacent equal elements
    * @see {@link groupWith} — group adjacent elements by custom equality
    *
+   * @stability stable
    * @category grouping
    * @since 2.0.0
    */
@@ -6821,6 +7045,7 @@ const hashBucketsHas = (buckets: HashBuckets, value: unknown): boolean => {
  * @see {@link intersectionWith} for keeping elements present in both arrays
  * @see {@link differenceWith} for keeping elements present only in the first array
  *
+ * @stability stable
  * @category set operations
  * @since 2.0.0
  */
@@ -6846,6 +7071,7 @@ export const unionWith: {
    * @see {@link intersectionWith} for keeping elements present in both arrays
    * @see {@link differenceWith} for keeping elements present only in the first array
    *
+   * @stability stable
    * @category set operations
    * @since 2.0.0
    */
@@ -6874,6 +7100,7 @@ export const unionWith: {
    * @see {@link intersectionWith} for keeping elements present in both arrays
    * @see {@link differenceWith} for keeping elements present only in the first array
    *
+   * @stability stable
    * @category set operations
    * @since 2.0.0
    */
@@ -6903,6 +7130,7 @@ export const unionWith: {
    * @see {@link intersectionWith} for keeping elements present in both arrays
    * @see {@link differenceWith} for keeping elements present only in the first array
    *
+   * @stability stable
    * @category set operations
    * @since 2.0.0
    */
@@ -6932,6 +7160,7 @@ export const unionWith: {
    * @see {@link intersectionWith} for keeping elements present in both arrays
    * @see {@link differenceWith} for keeping elements present only in the first array
    *
+   * @stability stable
    * @category set operations
    * @since 2.0.0
    */
@@ -6969,6 +7198,7 @@ export const unionWith: {
  * @see {@link intersection} — elements in both arrays
  * @see {@link difference} — elements only in the first array
  *
+ * @stability stable
  * @category set operations
  * @since 2.0.0
  */
@@ -6989,6 +7219,7 @@ export const union: {
    * @see {@link intersection} — elements in both arrays
    * @see {@link difference} — elements only in the first array
    *
+   * @stability stable
    * @category set operations
    * @since 2.0.0
    */
@@ -7011,6 +7242,7 @@ export const union: {
    * @see {@link intersection} — elements in both arrays
    * @see {@link difference} — elements only in the first array
    *
+   * @stability stable
    * @category set operations
    * @since 2.0.0
    */
@@ -7031,6 +7263,7 @@ export const union: {
    * @see {@link intersection} — elements in both arrays
    * @see {@link difference} — elements only in the first array
    *
+   * @stability stable
    * @category set operations
    * @since 2.0.0
    */
@@ -7051,6 +7284,7 @@ export const union: {
    * @see {@link intersection} — elements in both arrays
    * @see {@link difference} — elements only in the first array
    *
+   * @stability stable
    * @category set operations
    * @since 2.0.0
    */
@@ -7092,6 +7326,7 @@ export const union: {
  * @see {@link unionWith} for keeping values from either array with custom equality
  * @see {@link differenceWith} for keeping values only from the first array with custom equality
  *
+ * @stability stable
  * @category set operations
  * @since 2.0.0
  */
@@ -7130,6 +7365,7 @@ export const intersectionWith = <A>(isEquivalent: (self: A, that: A) => boolean)
  * @see {@link union} — elements in either array
  * @see {@link difference} — elements only in the first array
  *
+ * @stability stable
  * @category set operations
  * @since 2.0.0
  */
@@ -7155,6 +7391,7 @@ export const intersection: {
    * @see {@link union} — elements in either array
    * @see {@link difference} — elements only in the first array
    *
+   * @stability stable
    * @category set operations
    * @since 2.0.0
    */
@@ -7180,6 +7417,7 @@ export const intersection: {
    * @see {@link union} — elements in either array
    * @see {@link difference} — elements only in the first array
    *
+   * @stability stable
    * @category set operations
    * @since 2.0.0
    */
@@ -7215,6 +7453,7 @@ export const intersection: {
  * @see {@link unionWith} for keeping values from either array with custom equality
  * @see {@link intersectionWith} for keeping values present in both arrays with custom equality
  *
+ * @stability stable
  * @category set operations
  * @since 2.0.0
  */
@@ -7253,6 +7492,7 @@ export const differenceWith = <A>(isEquivalent: (self: A, that: A) => boolean):
  * @see {@link union} — elements in either array
  * @see {@link intersection} — elements in both arrays
  *
+ * @stability stable
  * @category set operations
  * @since 2.0.0
  */
@@ -7278,6 +7518,7 @@ export const difference: {
    * @see {@link union} — elements in either array
    * @see {@link intersection} — elements in both arrays
    *
+   * @stability stable
    * @category set operations
    * @since 2.0.0
    */
@@ -7303,6 +7544,7 @@ export const difference: {
    * @see {@link union} — elements in either array
    * @see {@link intersection} — elements in both arrays
    *
+   * @stability stable
    * @category set operations
    * @since 2.0.0
    */
@@ -7338,6 +7580,7 @@ export const difference: {
  * @see {@link of} — create a single-element array
  * @see {@link make} — create from multiple values
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -7357,6 +7600,7 @@ export const empty: <A = never>() => Array<A> = () => []
  * @see {@link make} — create from multiple values
  * @see {@link empty} — create an empty array
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -7366,6 +7610,7 @@ export const of = <A>(a: A): NonEmptyArray<A> => [a]
  * Utility types for working with `ReadonlyArray` at the type level. Use these
  * to infer element types, preserve non-emptiness, and flatten nested arrays.
  *
+ * @stability stable
  * @since 2.0.0
  */
 export declare namespace ReadonlyArray {
@@ -7503,6 +7748,7 @@ export declare namespace ReadonlyArray {
  *
  * @see {@link flatMap} — map and flatten
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -7529,6 +7775,7 @@ export const map: {
    *
    * @see {@link flatMap} — map and flatten
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -7555,6 +7802,7 @@ export const map: {
    *
    * @see {@link flatMap} — map and flatten
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -7585,6 +7833,7 @@ export const map: {
  * @see {@link map} — transform without flattening
  * @see {@link flatten} — flatten without mapping
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -7613,6 +7862,7 @@ export const flatMap: {
    * @see {@link map} — transform without flattening
    * @see {@link flatten} — flatten without mapping
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -7641,6 +7891,7 @@ export const flatMap: {
    * @see {@link map} — transform without flattening
    * @see {@link flatten} — flatten without mapping
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -7672,6 +7923,7 @@ export const flatMap: {
    * @see {@link map} — transform without flattening
    * @see {@link flatten} — flatten without mapping
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -7711,6 +7963,7 @@ export const flatMap: {
  *
  * @see {@link flatMap} — map then flatten in one step
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -7736,6 +7989,7 @@ export const flatten: <const S extends ReadonlyArray<ReadonlyArray<any>>>(self:
  * @see {@link fromOption} — convert a single Option
  * @see {@link getSuccesses} — extract successes from Results
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -7772,6 +8026,7 @@ export const getSomes: <T extends Iterable<Option.Option<X>>, X = any>(
  * @see {@link getSuccesses} — extract success values
  * @see {@link separate} — split into successes and failures
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -7808,6 +8063,7 @@ export const getFailures = <T extends Iterable<Result.Result<any, any>>>(
  * @see {@link getFailures} — extract failure values
  * @see {@link separate} — split into successes and failures
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -7847,6 +8103,7 @@ export const getSuccesses = <T extends Iterable<Result.Result<any, any>>>(
  * @see {@link filter} — keep original elements matching a predicate
  * @see {@link partition} for keeping both successes and failures
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -7874,6 +8131,7 @@ export const filterMap: {
    * @see {@link filter} — keep original elements matching a predicate
    * @see {@link partition} for keeping both successes and failures
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -7901,6 +8159,7 @@ export const filterMap: {
    * @see {@link filter} — keep original elements matching a predicate
    * @see {@link partition} for keeping both successes and failures
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -7941,6 +8200,7 @@ export const filterMap: {
  * @see {@link partition} — split into matching and non-matching
  * @see {@link filterMap} for transforming while filtering
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -7969,6 +8229,7 @@ export const filter: {
    * @see {@link partition} — split into matching and non-matching
    * @see {@link filterMap} for transforming while filtering
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -7997,6 +8258,7 @@ export const filter: {
    * @see {@link partition} — split into matching and non-matching
    * @see {@link filterMap} for transforming while filtering
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -8025,6 +8287,7 @@ export const filter: {
    * @see {@link partition} — split into matching and non-matching
    * @see {@link filterMap} for transforming while filtering
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -8053,6 +8316,7 @@ export const filter: {
    * @see {@link partition} — split into matching and non-matching
    * @see {@link filterMap} for transforming while filtering
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -8097,6 +8361,7 @@ export const filter: {
  * @see {@link filterMap} for discarding failures
  * @see {@link separate} — split an iterable of `Result` values
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -8127,6 +8392,7 @@ export const partition: {
    * @see {@link filterMap} for discarding failures
    * @see {@link separate} — split an iterable of `Result` values
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -8157,6 +8423,7 @@ export const partition: {
    * @see {@link filterMap} for discarding failures
    * @see {@link separate} — split an iterable of `Result` values
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -8206,6 +8473,7 @@ export const partition: {
  * @see {@link getSuccesses} — extract only successes
  * @see {@link partition} for computing `Result` values while splitting
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -8238,6 +8506,7 @@ export const separate: <T extends Iterable<Result.Result<any, any>>>(
  * @see {@link reduceRight} — fold from right to left
  * @see {@link scan} — fold keeping intermediate values
  *
+ * @stability stable
  * @category folding
  * @since 2.0.0
  */
@@ -8264,6 +8533,7 @@ export const reduce: {
    * @see {@link reduceRight} — fold from right to left
    * @see {@link scan} — fold keeping intermediate values
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -8290,6 +8560,7 @@ export const reduce: {
    * @see {@link reduceRight} — fold from right to left
    * @see {@link scan} — fold keeping intermediate values
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -8322,6 +8593,7 @@ export const reduce: {
  * @see {@link reduce} — fold from left to right
  * @see {@link scanRight} — fold keeping intermediate values
  *
+ * @stability stable
  * @category folding
  * @since 2.0.0
  */
@@ -8348,6 +8620,7 @@ export const reduceRight: {
    * @see {@link reduce} — fold from left to right
    * @see {@link scanRight} — fold keeping intermediate values
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -8374,6 +8647,7 @@ export const reduceRight: {
    * @see {@link reduce} — fold from left to right
    * @see {@link scanRight} — fold keeping intermediate values
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -8401,6 +8675,7 @@ export const reduceRight: {
  *
  * @see {@link liftOption} — lift an Option-returning function
  *
+ * @stability stable
  * @category lifting
  * @since 2.0.0
  */
@@ -8423,6 +8698,7 @@ export const liftPredicate: { // Note: I intentionally avoid using the NoInfer p
    *
    * @see {@link liftOption} — lift an Option-returning function
    *
+   * @stability stable
    * @category lifting
    * @since 2.0.0
    */
@@ -8455,6 +8731,7 @@ export const liftPredicate: { // Note: I intentionally avoid using the NoInfer p
  * @see {@link liftPredicate} — lift a boolean predicate
  * @see {@link liftResult} — lift a Result-returning function
  *
+ * @stability stable
  * @category lifting
  * @since 2.0.0
  */
@@ -8484,6 +8761,7 @@ export const liftOption = <A extends Array<unknown>, B>(
  * @see {@link liftNullishOr} — lift a nullable-returning function
  * @see {@link fromOption} — convert from Option
  *
+ * @stability stable
  * @category converting
  * @since 4.0.0
  */
@@ -8510,6 +8788,7 @@ export const fromNullishOr = <A>(a: A): Array<NonNullable<A>> => a == null ? emp
  * @see {@link fromNullishOr} — convert a single nullable value
  * @see {@link liftOption} — lift an Option-returning function
  *
+ * @stability stable
  * @category lifting
  * @since 4.0.0
  */
@@ -8538,6 +8817,7 @@ export const liftNullishOr = <A extends Array<unknown>, B>(
  * @see {@link flatMap} for mapping each element to an array and flattening
  * @see {@link fromNullishOr} for converting a single nullable value to an array
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -8562,6 +8842,7 @@ export const flatMapNullishOr: {
    * @see {@link flatMap} for mapping each element to an array and flattening
    * @see {@link fromNullishOr} for converting a single nullable value to an array
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -8586,6 +8867,7 @@ export const flatMapNullishOr: {
    * @see {@link flatMap} for mapping each element to an array and flattening
    * @see {@link fromNullishOr} for converting a single nullable value to an array
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -8623,6 +8905,7 @@ export const flatMapNullishOr: {
  * @see {@link liftOption} — lift an Option-returning function
  * @see {@link liftPredicate} — lift a boolean predicate
  *
+ * @stability stable
  * @category lifting
  * @since 4.0.0
  */
@@ -8654,6 +8937,7 @@ export const liftResult = <A extends Array<unknown>, E, B>(
  *
  * @see {@link some} — test if any element matches
  *
+ * @stability stable
  * @category guards
  * @since 2.0.0
  */
@@ -8678,6 +8962,7 @@ export const every: {
    *
    * @see {@link some} — test if any element matches
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -8702,6 +8987,7 @@ export const every: {
    *
    * @see {@link some} — test if any element matches
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -8726,6 +9012,7 @@ export const every: {
    *
    * @see {@link some} — test if any element matches
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -8750,6 +9037,7 @@ export const every: {
    *
    * @see {@link some} — test if any element matches
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -8776,6 +9064,7 @@ export const every: {
  * @see {@link every} — test if all elements match
  * @see {@link contains} — test for a specific value
  *
+ * @stability stable
  * @category guards
  * @since 2.0.0
  */
@@ -8796,6 +9085,7 @@ export const some: {
    * @see {@link every} — test if all elements match
    * @see {@link contains} — test for a specific value
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -8816,6 +9106,7 @@ export const some: {
    * @see {@link every} — test if all elements match
    * @see {@link contains} — test for a specific value
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -8849,6 +9140,7 @@ export const some: {
  *
  * @see {@link scan} for keeping intermediate accumulator values during a fold
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -8876,6 +9168,7 @@ export const extend: {
    *
    * @see {@link scan} for keeping intermediate accumulator values during a fold
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -8903,6 +9196,7 @@ export const extend: {
    *
    * @see {@link scan} for keeping intermediate accumulator values during a fold
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -8927,6 +9221,7 @@ export const extend: {
  * @see {@link max} — find the maximum
  * @see {@link sort} — sort the entire array
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -8946,6 +9241,7 @@ export const min: {
    * @see {@link max} — find the maximum
    * @see {@link sort} — sort the entire array
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -8965,6 +9261,7 @@ export const min: {
    * @see {@link max} — find the maximum
    * @see {@link sort} — sort the entire array
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -8986,6 +9283,7 @@ export const min: {
  * @see {@link min} — find the minimum
  * @see {@link sort} — sort the entire array
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -9005,6 +9303,7 @@ export const max: {
    * @see {@link min} — find the minimum
    * @see {@link sort} — sort the entire array
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -9024,6 +9323,7 @@ export const max: {
    * @see {@link min} — find the minimum
    * @see {@link sort} — sort the entire array
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -9046,6 +9346,7 @@ export const max: {
  * @see {@link makeBy} — generate from index
  * @see {@link range} — generate a numeric range
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -9081,6 +9382,7 @@ export const unfold = <B, A>(b: B, f: (b: B) => Option.Option<readonly [A, B]>):
  *
  * @see {@link makeEquivalence} — create an equivalence for arrays
  *
+ * @stability stable
  * @category instances
  * @since 4.0.0
  */
@@ -9103,6 +9405,7 @@ export const makeOrder: <A>(O: Order.Order<A>) => Order.Order<ReadonlyArray<A>>
  *
  * @see {@link makeOrder} — create an ordering for arrays
  *
+ * @stability stable
  * @category instances
  * @since 4.0.0
  */
@@ -9131,6 +9434,7 @@ export const makeEquivalence: <A>(
  *
  * @see {@link map} for transforming each element into a new array
  *
+ * @stability stable
  * @category traversing
  * @since 2.0.0
  */
@@ -9156,6 +9460,7 @@ export const forEach: {
    *
    * @see {@link map} for transforming each element into a new array
    *
+   * @stability stable
    * @category traversing
    * @since 2.0.0
    */
@@ -9181,6 +9486,7 @@ export const forEach: {
    *
    * @see {@link map} for transforming each element into a new array
    *
+   * @stability stable
    * @category traversing
    * @since 2.0.0
    */
@@ -9207,6 +9513,7 @@ export const forEach: {
  * @see {@link dedupe} — uses default equality
  * @see {@link dedupeAdjacentWith} — only dedupes consecutive elements
  *
+ * @stability stable
  * @category deduplication
  * @since 2.0.0
  */
@@ -9231,6 +9538,7 @@ export const dedupeWith: {
    * @see {@link dedupe} — uses default equality
    * @see {@link dedupeAdjacentWith} — only dedupes consecutive elements
    *
+   * @stability stable
    * @category deduplication
    * @since 2.0.0
    */
@@ -9257,6 +9565,7 @@ export const dedupeWith: {
    * @see {@link dedupe} — uses default equality
    * @see {@link dedupeAdjacentWith} — only dedupes consecutive elements
    *
+   * @stability stable
    * @category deduplication
    * @since 2.0.0
    */
@@ -9284,6 +9593,7 @@ export const dedupeWith: {
    * @see {@link dedupe} — uses default equality
    * @see {@link dedupeAdjacentWith} — only dedupes consecutive elements
    *
+   * @stability stable
    * @category deduplication
    * @since 2.0.0
    */
@@ -9322,6 +9632,7 @@ export const dedupeWith: {
  * @see {@link dedupeWith} — use custom equality
  * @see {@link dedupeAdjacent} — only dedupes consecutive elements
  *
+ * @stability stable
  * @category deduplication
  * @since 2.0.0
  */
@@ -9366,6 +9677,7 @@ export const dedupe = <S extends Iterable<any>>(
  * @see {@link dedupeAdjacent} — uses default equality
  * @see {@link dedupeWith} — dedupes all duplicates, not just adjacent
  *
+ * @stability stable
  * @category deduplication
  * @since 2.0.0
  */
@@ -9394,6 +9706,7 @@ export const dedupeAdjacentWith: {
    * @see {@link dedupeAdjacent} — uses default equality
    * @see {@link dedupeWith} — dedupes all duplicates, not just adjacent
    *
+   * @stability stable
    * @category deduplication
    * @since 2.0.0
    */
@@ -9422,6 +9735,7 @@ export const dedupeAdjacentWith: {
    * @see {@link dedupeAdjacent} — uses default equality
    * @see {@link dedupeWith} — dedupes all duplicates, not just adjacent
    *
+   * @stability stable
    * @category deduplication
    * @since 2.0.0
    */
@@ -9457,6 +9771,7 @@ export const dedupeAdjacentWith: {
  * @see {@link dedupeAdjacentWith} — use custom equality
  * @see {@link dedupe} — remove all duplicates
  *
+ * @stability stable
  * @category deduplication
  * @since 2.0.0
  */
@@ -9475,6 +9790,7 @@ export const dedupeAdjacent: <A>(self: Iterable<A>) => Array<A> = dedupeAdjacent
  *
  * @see {@link intersperse} — insert separator elements without joining
  *
+ * @stability stable
  * @category folding
  * @since 2.0.0
  */
@@ -9492,6 +9808,7 @@ export const join: {
    *
    * @see {@link intersperse} — insert separator elements without joining
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -9509,6 +9826,7 @@ export const join: {
    *
    * @see {@link intersperse} — insert separator elements without joining
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -9541,6 +9859,7 @@ export const join: {
  * @see {@link scan} — when you only need the accumulated results (not the final state)
  * @see {@link reduce} — when you only need the final accumulated value
  *
+ * @stability stable
  * @category folding
  * @since 2.0.0
  */
@@ -9571,6 +9890,7 @@ export const mapAccum: {
    * @see {@link scan} — when you only need the accumulated results (not the final state)
    * @see {@link reduce} — when you only need the final accumulated value
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -9601,6 +9921,7 @@ export const mapAccum: {
    * @see {@link scan} — when you only need the accumulated results (not the final state)
    * @see {@link reduce} — when you only need the final accumulated value
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -9649,6 +9970,7 @@ export const mapAccum: {
  *
  * @see {@link cartesian} for returning tuples instead of applying a combiner
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -9677,6 +9999,7 @@ export const cartesianWith: {
    *
    * @see {@link cartesian} for returning tuples instead of applying a combiner
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -9705,6 +10028,7 @@ export const cartesianWith: {
    *
    * @see {@link cartesian} for returning tuples instead of applying a combiner
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -9737,6 +10061,7 @@ export const cartesianWith: {
  *
  * @see {@link cartesianWith} — apply a combiner to each pair
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -9763,6 +10088,7 @@ export const cartesian: {
    *
    * @see {@link cartesianWith} — apply a combiner to each pair
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -9789,6 +10115,7 @@ export const cartesian: {
    *
    * @see {@link cartesianWith} — apply a combiner to each pair
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -9834,6 +10161,7 @@ export const cartesian: {
  * @see {@link bindTo} — start a pipeline by naming the first array
  * @see {@link let_ let} — introduce a plain computed value
  *
+ * @stability stable
  * @category constructors
  * @since 3.2.0
  */
@@ -9869,6 +10197,7 @@ export const Do: ReadonlyArray<{}> = of({})
  * @see {@link bindTo} — name the first array in a pipeline
  * @see {@link let_ let} — add a plain computed value
  *
+ * @stability stable
  * @category sequencing
  * @since 3.2.0
  */
@@ -9903,6 +10232,7 @@ export const bind: {
    * @see {@link bindTo} — name the first array in a pipeline
    * @see {@link let_ let} — add a plain computed value
    *
+   * @stability stable
    * @category sequencing
    * @since 3.2.0
    */
@@ -9939,6 +10269,7 @@ export const bind: {
    * @see {@link bindTo} — name the first array in a pipeline
    * @see {@link let_ let} — add a plain computed value
    *
+   * @stability stable
    * @category sequencing
    * @since 3.2.0
    */
@@ -9973,6 +10304,7 @@ export const bind: {
  * @see {@link Do} — start with an empty scope
  * @see {@link bind} — add another array variable to the scope
  *
+ * @stability stable
  * @category mapping
  * @since 3.2.0
  */
@@ -10001,6 +10333,7 @@ export const bindTo: {
    * @see {@link Do} — start with an empty scope
    * @see {@link bind} — add another array variable to the scope
    *
+   * @stability stable
    * @category mapping
    * @since 3.2.0
    */
@@ -10029,6 +10362,7 @@ export const bindTo: {
    * @see {@link Do} — start with an empty scope
    * @see {@link bind} — add another array variable to the scope
    *
+   * @stability stable
    * @category mapping
    * @since 3.2.0
    */
@@ -10077,24 +10411,34 @@ export {
    * @see {@link Do} — start a do-notation pipeline
    * @see {@link bind} — introduce an array variable (produces cartesian product)
    *
+   * @stability stable
    * @category mapping
    * @since 3.2.0
    */
   let_ as let
 }
 
-const reducer = Reducer.make((a, b) => a.concat(b), [] as any)
+const combineConcat = <A>(a: ReadonlyArray<A>, b: ReadonlyArray<A>): Array<A> => a.concat(b)
+
+const combineAllConcat = <A>(collection: Iterable<ReadonlyArray<A>>): Array<A> => {
+  let out: Array<A> = []
+  for (const value of collection) {
+    out = out.concat(value)
+  }
+  return out
+}
 
 /**
  * Returns a `Reducer` that combines `ReadonlyArray` values by concatenation.
  *
  * @see {@link makeReducerConcat} — mutable `Array` variant
  *
+ * @stability stable
  * @category folding
  * @since 4.0.0
  */
 export function getReadonlyReducerConcat<A>(): Reducer.Reducer<ReadonlyArray<A>> {
-  return reducer
+  return Reducer.make<ReadonlyArray<A>>(combineConcat, [], combineAllConcat)
 }
 
 /**
@@ -10102,11 +10446,12 @@ export function getReadonlyReducerConcat<A>(): Reducer.Reducer<ReadonlyArray<A>>
  *
  * @see {@link getReadonlyReducerConcat} — readonly variant
  *
+ * @stability stable
  * @category folding
  * @since 4.0.0
  */
 export function makeReducerConcat<A>(): Reducer.Reducer<Array<A>> {
-  return reducer
+  return Reducer.make<Array<A>>(combineConcat, [], combineAllConcat)
 }
 
 /**
@@ -10132,6 +10477,7 @@ export function makeReducerConcat<A>(): Reducer.Reducer<Array<A>> {
  *
  * @see {@link filter} — when you need the matching elements, not just the count
  *
+ * @stability stable
  * @category folding
  * @since 3.16.0
  */
@@ -10159,6 +10505,7 @@ export const countBy: {
    *
    * @see {@link filter} — when you need the matching elements, not just the count
    *
+   * @stability stable
    * @category folding
    * @since 3.16.0
    */
@@ -10186,6 +10533,7 @@ export const countBy: {
    *
    * @see {@link filter} — when you need the matching elements, not just the count
    *
+   * @stability stable
    * @category folding
    * @since 3.16.0
    */