effect 4.0.1 → 4.0.2

package/src/Chunk.ts

@@ -7,6 +7,7 @@
  * creating, reading, slicing, mapping, filtering, sorting, zipping, combining,
  * and converting chunks to and from arrays and iterables.
  *
+ * @stability stable
  * @since 2.0.0
  */
 import * as RA from "./Array.ts"
@@ -46,6 +47,7 @@ const TypeId = "~effect/Chunk"
  * Chunk.toArray(chunk) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -73,6 +75,7 @@ export interface Chunk<out A> extends Iterable<A>, Equal.Equal, Pipeable, Inspec
  * Chunk.lastNonEmpty(nonEmptyChunk) // => 3
  * ```
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -91,6 +94,7 @@ export interface NonEmptyChunk<out A> extends Chunk<A>, NonEmptyIterable<A> {}
  * // Equivalent to: Chunk<number>
  * ```
  *
+ * @stability stable
  * @category utility types
  * @since 2.0.0
  */
@@ -165,6 +169,7 @@ const emptyArray: ReadonlyArray<never> = []
  * eq(chunk1, chunk3) // => false
  * ```
  *
+ * @stability stable
  * @category instances
  * @since 4.0.0
  */
@@ -284,6 +289,7 @@ const makeChunk = <A>(backing: Backing<A>): Chunk<A> => {
  * Chunk.isChunk("string") // => false
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 2.0.0
  */
@@ -304,6 +310,7 @@ export const isChunk: {
    * Chunk.isChunk("string") // => false
    * ```
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -324,6 +331,7 @@ export const isChunk: {
    * Chunk.isChunk("string") // => false
    * ```
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -343,6 +351,7 @@ const _empty = makeChunk<never>({ _tag: "IEmpty" })
  * Chunk.size(Chunk.empty()) // => 0
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -359,6 +368,7 @@ export const empty: <A = never>() => Chunk<A> = () => _empty
  * Chunk.toArray(Chunk.make(1, 2, 3, 4)) // => [1, 2, 3, 4]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -376,6 +386,7 @@ export const make = <As extends readonly [any, ...Array<any>]>(...as: As): NonEm
  * Chunk.toArray(Chunk.of("hello")) // => ["hello"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -392,6 +403,7 @@ export const of = <A>(a: A): NonEmptyChunk<A> => makeChunk({ _tag: "ISingleton",
  * Chunk.toArray(Chunk.fromIterable([1, 2, 3])) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -441,6 +453,7 @@ const toArray_ = <A>(self: Chunk<A>): Array<A> => toReadonlyArray(self).slice()
  * Chunk.toArray(Chunk.empty<number>()) // => []
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 2.0.0
  */
@@ -492,6 +505,7 @@ const toReadonlyArray_ = <A>(self: Chunk<A>): ReadonlyArray<A> => {
  * Chunk.toReadonlyArray(Chunk.empty<number>()) // => []
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 2.0.0
  */
@@ -537,6 +551,7 @@ const reverseChunk = <A>(self: Chunk<A>): Chunk<A> => {
  * Chunk.toArray(Chunk.reverse(chunk)) // => [3, 2, 1]
  * ```
  *
+ * @stability stable
  * @category transforming
  * @since 2.0.0
  */
@@ -561,6 +576,7 @@ export const reverse: <S extends Chunk<any>>(self: S) => Chunk.With<S, Chunk.Inf
  * chunk.pipe(Chunk.get(2)) // => Option.some("c")
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -584,6 +600,7 @@ export const get: {
    * chunk.pipe(Chunk.get(2)) // => Option.some("c")
    * ```
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -607,6 +624,7 @@ export const get: {
    * chunk.pipe(Chunk.get(2)) // => Option.some("c")
    * ```
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -643,6 +661,7 @@ export const get: {
  * Chunk.toArray(chunk) // => [999, 2, 3, 4, 5]
  * ```
  *
+ * @stability stable
  * @category unsafe
  * @since 4.0.0
  */
@@ -674,6 +693,7 @@ export const fromArrayUnsafe = <A>(self: ReadonlyArray<A>): Chunk<A> =>
  * Chunk.isNonEmpty(chunk) // => true
  * ```
  *
+ * @stability stable
  * @category unsafe
  * @since 4.0.0
  */
@@ -706,6 +726,7 @@ export const fromNonEmptyArrayUnsafe = <A>(self: NonEmptyReadonlyArray<A>): NonE
  * Option.isNone(Chunk.get(chunk, 10)) // => true
  * ```
  *
+ * @stability stable
  * @category unsafe
  * @since 4.0.0
  */
@@ -736,6 +757,7 @@ export const getUnsafe: {
    * Option.isNone(Chunk.get(chunk, 10)) // => true
    * ```
    *
+   * @stability stable
    * @category unsafe
    * @since 4.0.0
    */
@@ -766,6 +788,7 @@ export const getUnsafe: {
    * Option.isNone(Chunk.get(chunk, 10)) // => true
    * ```
    *
+   * @stability stable
    * @category unsafe
    * @since 4.0.0
    */
@@ -823,6 +846,7 @@ export const getUnsafe: {
  * @see {@link prepend} for adding one element before the existing elements
  * @see {@link appendAll} for appending all elements from another chunk
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -851,6 +875,7 @@ export const append: {
    * @see {@link prepend} for adding one element before the existing elements
    * @see {@link appendAll} for appending all elements from another chunk
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -879,6 +904,7 @@ export const append: {
    * @see {@link prepend} for adding one element before the existing elements
    * @see {@link appendAll} for appending all elements from another chunk
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -901,6 +927,7 @@ export const append: {
  * Chunk.toArray(Chunk.prepend(emptyChunk, "first")) // => ["first"]
  * ```
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -921,6 +948,7 @@ export const prepend: {
    * Chunk.toArray(Chunk.prepend(emptyChunk, "first")) // => ["first"]
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -941,6 +969,7 @@ export const prepend: {
    * Chunk.toArray(Chunk.prepend(emptyChunk, "first")) // => ["first"]
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -960,6 +989,7 @@ export const prepend: {
  * Chunk.toArray(Chunk.take(chunk, 3)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -977,6 +1007,7 @@ export const take: {
    * Chunk.toArray(Chunk.take(chunk, 3)) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -994,6 +1025,7 @@ export const take: {
    * Chunk.toArray(Chunk.take(chunk, 3)) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1050,6 +1082,7 @@ export const take: {
  * Chunk.toArray(Chunk.drop(chunk, 2)) // => [3, 4, 5]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -1067,6 +1100,7 @@ export const drop: {
    * Chunk.toArray(Chunk.drop(chunk, 2)) // => [3, 4, 5]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1084,6 +1118,7 @@ export const drop: {
    * Chunk.toArray(Chunk.drop(chunk, 2)) // => [3, 4, 5]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1139,6 +1174,7 @@ export const drop: {
  * Chunk.toArray(Chunk.dropRight(chunk, 2)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -1156,6 +1192,7 @@ export const dropRight: {
    * Chunk.toArray(Chunk.dropRight(chunk, 2)) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1173,6 +1210,7 @@ export const dropRight: {
    * Chunk.toArray(Chunk.dropRight(chunk, 2)) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1194,6 +1232,7 @@ export const dropRight: {
  * Chunk.toArray(Chunk.dropWhile(chunk, (n) => n < 3)) // => [3, 4, 5]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -1210,6 +1249,7 @@ export const dropWhile: {
    * Chunk.toArray(Chunk.dropWhile(chunk, (n) => n < 3)) // => [3, 4, 5]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1226,6 +1266,7 @@ export const dropWhile: {
    * Chunk.toArray(Chunk.dropWhile(chunk, (n) => n < 3)) // => [3, 4, 5]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1255,6 +1296,7 @@ export const dropWhile: {
  * ) // => ["a", "b", 1, 2]
  * ```
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -1274,6 +1316,7 @@ export const prependAll: {
    * ) // => ["a", "b", 1, 2]
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1293,6 +1336,7 @@ export const prependAll: {
    * ) // => ["a", "b", 1, 2]
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1312,6 +1356,7 @@ export const prependAll: {
    * ) // => ["a", "b", 1, 2]
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1331,6 +1376,7 @@ export const prependAll: {
    * ) // => ["a", "b", 1, 2]
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1360,6 +1406,7 @@ export const prependAll: {
  * @see {@link prependAll} for concatenating chunks in the opposite order
  * @see {@link append} for adding a single element to the end
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -1387,6 +1434,7 @@ export const appendAll: {
    * @see {@link prependAll} for concatenating chunks in the opposite order
    * @see {@link append} for adding a single element to the end
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1414,6 +1462,7 @@ export const appendAll: {
    * @see {@link prependAll} for concatenating chunks in the opposite order
    * @see {@link append} for adding a single element to the end
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1441,6 +1490,7 @@ export const appendAll: {
    * @see {@link prependAll} for concatenating chunks in the opposite order
    * @see {@link append} for adding a single element to the end
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1468,6 +1518,7 @@ export const appendAll: {
    * @see {@link prependAll} for concatenating chunks in the opposite order
    * @see {@link append} for adding a single element to the end
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1504,6 +1555,7 @@ export const appendAll: {
      * @see {@link prependAll} for concatenating chunks in the opposite order
      * @see {@link append} for adding a single element to the end
      *
+     * @stability stable
      * @category combining
      * @since 2.0.0
      */
@@ -1562,6 +1614,7 @@ export const appendAll: {
  * Chunk.toArray(evenIndexNumbers) // => [1]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -1589,6 +1642,7 @@ export const filterMap: {
    * Chunk.toArray(evenIndexNumbers) // => [1]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1616,6 +1670,7 @@ export const filterMap: {
    * Chunk.toArray(evenIndexNumbers) // => [1]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1653,6 +1708,7 @@ export const filterMap: {
  * Chunk.toArray(numbers) // => [42, 100]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -1675,6 +1731,7 @@ export const filter: {
    * Chunk.toArray(numbers) // => [42, 100]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1697,6 +1754,7 @@ export const filter: {
    * Chunk.toArray(numbers) // => [42, 100]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1719,6 +1777,7 @@ export const filter: {
    * Chunk.toArray(numbers) // => [42, 100]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1741,6 +1800,7 @@ export const filter: {
    * Chunk.toArray(numbers) // => [42, 100]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1770,6 +1830,7 @@ export const filter: {
  * })) // => [1, 2, 3, 4]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -1794,6 +1855,7 @@ export const filterMapWhile: {
    * })) // => [1, 2, 3, 4]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1818,6 +1880,7 @@ export const filterMapWhile: {
    * })) // => [1, 2, 3, 4]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1847,6 +1910,7 @@ export const filterMapWhile: {
  * Chunk.toArray(Chunk.compact(chunk)) // => [1, 3]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -1885,6 +1949,7 @@ export const compact = <A>(self: Chunk<Option<A>>): Chunk<A> => {
  * Chunk.toArray(indexed) // => [1, 3, 5]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1914,6 +1979,7 @@ export const flatMap: {
    * Chunk.toArray(indexed) // => [1, 3, 5]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -1943,6 +2009,7 @@ export const flatMap: {
    * Chunk.toArray(indexed) // => [1, 3, 5]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -1972,6 +2039,7 @@ export const flatMap: {
    * Chunk.toArray(indexed) // => [1, 3, 5]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -2020,6 +2088,7 @@ export const flatMap: {
  * indexed // => ["Index 0: 1", "Index 1: 2", "Index 2: 3", "Index 3: 4"]
  * ```
  *
+ * @stability stable
  * @category combinators
  * @since 2.0.0
  */
@@ -2051,6 +2120,7 @@ export const forEach: {
    * indexed // => ["Index 0: 1", "Index 1: 2", "Index 2: 3", "Index 3: 4"]
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 2.0.0
    */
@@ -2082,6 +2152,7 @@ export const forEach: {
    * indexed // => ["Index 0: 1", "Index 1: 2", "Index 2: 3", "Index 3: 4"]
    * ```
    *
+   * @stability stable
    * @category combinators
    * @since 2.0.0
    */
@@ -2112,6 +2183,7 @@ export const forEach: {
  * Chunk.toArray(Chunk.flatten(withEmpty)) // => [1, 2, 3, 4]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -2153,6 +2225,7 @@ export const flatten: <S extends Chunk<Chunk<any>>>(self: S) => Chunk.Flatten<S>
  *
  * @see {@link split} for splitting into a target number of chunks instead of a fixed chunk size
  *
+ * @stability stable
  * @category splitting
  * @since 2.0.0
  */
@@ -2193,6 +2266,7 @@ export const chunksOf: {
    *
    * @see {@link split} for splitting into a target number of chunks instead of a fixed chunk size
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -2233,6 +2307,7 @@ export const chunksOf: {
    *
    * @see {@link split} for splitting into a target number of chunks instead of a fixed chunk size
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -2281,6 +2356,7 @@ export const chunksOf: {
  * Chunk.toArray(Chunk.intersection(chunk3, chunk4)) // => []
  * ```
  *
+ * @stability stable
  * @category set operations
  * @since 2.0.0
  */
@@ -2312,6 +2388,7 @@ export const intersection: {
    * Chunk.toArray(Chunk.intersection(chunk3, chunk4)) // => []
    * ```
    *
+   * @stability stable
    * @category set operations
    * @since 2.0.0
    */
@@ -2343,6 +2420,7 @@ export const intersection: {
    * Chunk.toArray(Chunk.intersection(chunk3, chunk4)) // => []
    * ```
    *
+   * @stability stable
    * @category set operations
    * @since 2.0.0
    */
@@ -2365,6 +2443,7 @@ export const intersection: {
  * Chunk.isEmpty(Chunk.make(1, 2, 3)) // => false
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -2382,6 +2461,7 @@ export const isEmpty = <A>(self: Chunk<A>): boolean => self.length === 0
  * Chunk.isNonEmpty(Chunk.make(1, 2, 3)) // => true
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 2.0.0
  */
@@ -2399,6 +2479,7 @@ export const isNonEmpty = <A>(self: Chunk<A>): self is NonEmptyChunk<A> => self.
  * Chunk.head(Chunk.make(1, 2, 3)) // => Option.some(1)
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -2431,6 +2512,7 @@ export const head: <A>(self: Chunk<A>) => Option<A> = get(0)
  * Option.isNone(Chunk.head(Chunk.empty())) // => true
  * ```
  *
+ * @stability stable
  * @category unsafe
  * @since 4.0.0
  */
@@ -2454,6 +2536,7 @@ export const headUnsafe = <A>(self: Chunk<A>): A => getUnsafe(self, 0)
  * // Chunk.headNonEmpty(Chunk.empty()) // TypeScript error
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -2471,6 +2554,7 @@ export const headNonEmpty: <A>(self: NonEmptyChunk<A>) => A = headUnsafe
  * Chunk.last(Chunk.make(1, 2, 3)) // => Option.some(3)
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -2503,6 +2587,7 @@ export const last = <A>(self: Chunk<A>): Option<A> => get(self, self.length - 1)
  * Option.isNone(Chunk.last(Chunk.empty())) // => true
  * ```
  *
+ * @stability stable
  * @category unsafe
  * @since 4.0.0
  */
@@ -2526,6 +2611,7 @@ export const lastUnsafe = <A>(self: Chunk<A>): A => getUnsafe(self, self.length
  * // Chunk.lastNonEmpty(Chunk.empty()) // TypeScript error
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 3.4.0
  */
@@ -2548,6 +2634,7 @@ export const lastNonEmpty: <A>(self: NonEmptyChunk<A>) => A = lastUnsafe
  * type WithString = Chunk.Chunk.With<typeof nonEmptyChunk, string> // Chunk.NonEmptyChunk<string>
  * ```
  *
+ * @stability stable
  * @since 2.0.0
  */
 export declare namespace Chunk {
@@ -2698,6 +2785,7 @@ export declare namespace Chunk {
  * Chunk.toArray(Chunk.map(Chunk.make(1, 2), (n) => n + 1)) // => [2, 3]
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -2714,6 +2802,7 @@ export const map: {
    * Chunk.toArray(Chunk.map(Chunk.make(1, 2), (n) => n + 1)) // => [2, 3]
    * ```
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -2730,6 +2819,7 @@ export const map: {
    * Chunk.toArray(Chunk.map(Chunk.make(1, 2), (n) => n + 1)) // => [2, 3]
    * ```
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -2746,6 +2836,7 @@ export const map: {
    * Chunk.toArray(Chunk.map(Chunk.make(1, 2), (n) => n + 1)) // => [2, 3]
    * ```
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -2782,6 +2873,7 @@ export const map: {
  * Chunk.toArray(indexed) // => ["0: hello", "1: world", "2: effect"]
  * ```
  *
+ * @stability stable
  * @category folding
  * @since 2.0.0
  */
@@ -2813,6 +2905,7 @@ export const mapAccum: {
    * Chunk.toArray(indexed) // => ["0: hello", "1: world", "2: effect"]
    * ```
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -2844,6 +2937,7 @@ export const mapAccum: {
    * Chunk.toArray(indexed) // => ["0: hello", "1: world", "2: effect"]
    * ```
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -2873,6 +2967,7 @@ export const mapAccum: {
  * Chunk.toArray(fails) // => ["negative:-2"]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -2897,6 +2992,7 @@ export const partition: {
    * Chunk.toArray(fails) // => ["negative:-2"]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -2921,6 +3017,7 @@ export const partition: {
    * Chunk.toArray(fails) // => ["negative:-2"]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -2969,6 +3066,7 @@ export const partition: {
  * Chunk.toArray(noErrors) // => []
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -2989,6 +3087,7 @@ export const separate = <A, B>(self: Chunk<Result<B, A>>): [Chunk<B>, Chunk<A>]
  * Chunk.size(Chunk.make(1, 2, 3)) // => 3
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -3013,6 +3112,7 @@ export const size = <A>(self: Chunk<A>): number => self.length
  * Chunk.toArray(Chunk.sort(words, Order.String)) // => ["apple", "banana", "cherry"]
  * ```
  *
+ * @stability stable
  * @category sorting
  * @since 2.0.0
  */
@@ -3036,6 +3136,7 @@ export const sort: {
    * Chunk.toArray(Chunk.sort(words, Order.String)) // => ["apple", "banana", "cherry"]
    * ```
    *
+   * @stability stable
    * @category sorting
    * @since 2.0.0
    */
@@ -3059,6 +3160,7 @@ export const sort: {
    * Chunk.toArray(Chunk.sort(words, Order.String)) // => ["apple", "banana", "cherry"]
    * ```
    *
+   * @stability stable
    * @category sorting
    * @since 2.0.0
    */
@@ -3095,6 +3197,7 @@ export const sort: {
  * Chunk.toArray(Chunk.sortWith(words, (word) => word.length, Order.Number)) // => ["a", "ab", "abc"]
  * ```
  *
+ * @stability stable
  * @category sorting
  * @since 2.0.0
  */
@@ -3126,6 +3229,7 @@ export const sortWith: {
    * Chunk.toArray(Chunk.sortWith(words, (word) => word.length, Order.Number)) // => ["a", "ab", "abc"]
    * ```
    *
+   * @stability stable
    * @category sorting
    * @since 2.0.0
    */
@@ -3157,6 +3261,7 @@ export const sortWith: {
    * Chunk.toArray(Chunk.sortWith(words, (word) => word.length, Order.Number)) // => ["a", "ab", "abc"]
    * ```
    *
+   * @stability stable
    * @category sorting
    * @since 2.0.0
    */
@@ -3190,6 +3295,7 @@ export const sortWith: {
  * Chunk.toArray(empty2) // => []
  * ```
  *
+ * @stability stable
  * @category splitting
  * @since 2.0.0
  */
@@ -3218,6 +3324,7 @@ export const splitAt: {
    * Chunk.toArray(empty2) // => []
    * ```
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -3246,6 +3353,7 @@ export const splitAt: {
    * Chunk.toArray(empty2) // => []
    * ```
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -3281,6 +3389,7 @@ export const splitAt: {
  * // while the second part may be empty
  * ```
  *
+ * @stability stable
  * @category splitting
  * @since 2.0.0
  */
@@ -3314,6 +3423,7 @@ export const splitNonEmptyAt: {
    * // while the second part may be empty
    * ```
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -3347,6 +3457,7 @@ export const splitNonEmptyAt: {
    * // while the second part may be empty
    * ```
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -3386,6 +3497,7 @@ export const splitNonEmptyAt: {
  * Chunk.toArray(chunks3).map(Chunk.toArray) // => [[1, 2, 3, 4, 5, 6, 7, 8, 9]]
  * ```
  *
+ * @stability stable
  * @category splitting
  * @since 2.0.0
  */
@@ -3418,6 +3530,7 @@ export const split: {
    * Chunk.toArray(chunks3).map(Chunk.toArray) // => [[1, 2, 3, 4, 5, 6, 7, 8, 9]]
    * ```
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -3450,6 +3563,7 @@ export const split: {
    * Chunk.toArray(chunks3).map(Chunk.toArray) // => [[1, 2, 3, 4, 5, 6, 7, 8, 9]]
    * ```
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -3481,6 +3595,7 @@ export const split: {
  * Chunk.toArray(allFromFirst) // => [1, 2, 3, 4, 5, 6]
  * ```
  *
+ * @stability stable
  * @category splitting
  * @since 2.0.0
  */
@@ -3510,6 +3625,7 @@ export const splitWhere: {
    * Chunk.toArray(allFromFirst) // => [1, 2, 3, 4, 5, 6]
    * ```
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -3539,6 +3655,7 @@ export const splitWhere: {
    * Chunk.toArray(allFromFirst) // => [1, 2, 3, 4, 5, 6]
    * ```
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -3572,6 +3689,7 @@ export const splitWhere: {
  * Chunk.tail(Chunk.empty<number>()) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -3595,6 +3713,7 @@ export const tail = <A>(self: Chunk<A>): O.Option<Chunk<A>> => self.length > 0 ?
  * // Chunk.tailNonEmpty(Chunk.empty()) // TypeScript error
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -3619,6 +3738,7 @@ export const tailNonEmpty = <A>(self: NonEmptyChunk<A>): Chunk<A> => drop(self,
  * Chunk.toArray(Chunk.takeRight(chunk, 0)) // => []
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -3642,6 +3762,7 @@ export const takeRight: {
    * Chunk.toArray(Chunk.takeRight(chunk, 0)) // => []
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -3665,6 +3786,7 @@ export const takeRight: {
    * Chunk.toArray(Chunk.takeRight(chunk, 0)) // => []
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -3693,6 +3815,7 @@ export const takeRight: {
  * Chunk.toArray(Chunk.takeWhile(small, (n) => n < 10)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -3716,6 +3839,7 @@ export const takeWhile: {
    * Chunk.toArray(Chunk.takeWhile(small, (n) => n < 10)) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -3739,6 +3863,7 @@ export const takeWhile: {
    * Chunk.toArray(Chunk.takeWhile(small, (n) => n < 10)) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -3762,6 +3887,7 @@ export const takeWhile: {
    * Chunk.toArray(Chunk.takeWhile(small, (n) => n < 10)) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -3785,6 +3911,7 @@ export const takeWhile: {
    * Chunk.toArray(Chunk.takeWhile(small, (n) => n < 10)) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -3819,6 +3946,7 @@ export const takeWhile: {
  * Chunk.toArray(Chunk.union(withDupes1, withDupes2)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category set operations
  * @since 2.0.0
  */
@@ -3841,6 +3969,7 @@ export const union: {
    * Chunk.toArray(Chunk.union(withDupes1, withDupes2)) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category set operations
    * @since 2.0.0
    */
@@ -3863,6 +3992,7 @@ export const union: {
    * Chunk.toArray(Chunk.union(withDupes1, withDupes2)) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category set operations
    * @since 2.0.0
    */
@@ -3893,6 +4023,7 @@ export const union: {
  * Chunk.toArray(Chunk.dedupe(unique)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category deduplication
  * @since 2.0.0
  */
@@ -3914,6 +4045,7 @@ export const dedupe = <A>(self: Chunk<A>): Chunk<A> => fromArrayUnsafe(RA.dedupe
  * Chunk.toArray(Chunk.dedupeAdjacent(mixed)) // => ["a", "b", "a"]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -3947,6 +4079,7 @@ export const dedupeAdjacent = <A>(self: Chunk<A>): Chunk<A> => fromArrayUnsafe(R
  * Chunk.toArray(emptyStrs) // => []
  * ```
  *
+ * @stability stable
  * @category splitting
  * @since 2.0.0
  */
@@ -3973,6 +4106,7 @@ export const unzip = <A, B>(self: Chunk<readonly [A, B]>): [Chunk<A>, Chunk<B>]
  * Chunk.toArray(Chunk.zipWith(short, long, (n, l) => [n, l])) // => [[1, "a"], [2, "b"]]
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -3995,6 +4129,7 @@ export const zipWith: {
    * Chunk.toArray(Chunk.zipWith(short, long, (n, l) => [n, l])) // => [[1, "a"], [2, "b"]]
    * ```
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -4017,6 +4152,7 @@ export const zipWith: {
    * Chunk.toArray(Chunk.zipWith(short, long, (n, l) => [n, l])) // => [[1, "a"], [2, "b"]]
    * ```
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -4045,6 +4181,7 @@ export const zipWith: {
  * Chunk.toArray(Chunk.zip(short, long)) // => [[1, "a"], [2, "b"]]
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -4067,6 +4204,7 @@ export const zip: {
    * Chunk.toArray(Chunk.zip(short, long)) // => [[1, "a"], [2, "b"]]
    * ```
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -4089,6 +4227,7 @@ export const zip: {
    * Chunk.toArray(Chunk.zip(short, long)) // => [[1, "a"], [2, "b"]]
    * ```
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -4116,6 +4255,7 @@ export const zip: {
  * Chunk.toArray(Chunk.remove(chunk, 10)) // => ["a", "b", "c", "d"]
  * ```
  *
+ * @stability stable
  * @category transforming
  * @since 2.0.0
  */
@@ -4138,6 +4278,7 @@ export const remove: {
    * Chunk.toArray(Chunk.remove(chunk, 10)) // => ["a", "b", "c", "d"]
    * ```
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -4160,6 +4301,7 @@ export const remove: {
    * Chunk.toArray(Chunk.remove(chunk, 10)) // => ["a", "b", "c", "d"]
    * ```
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -4188,6 +4330,7 @@ export const remove: {
  * chunk.pipe(Chunk.modify(-1, (n) => n * 10)) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category transforming
  * @since 2.0.0
  */
@@ -4211,6 +4354,7 @@ export const modify: {
    * chunk.pipe(Chunk.modify(-1, (n) => n * 10)) // => Option.none()
    * ```
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -4234,6 +4378,7 @@ export const modify: {
    * chunk.pipe(Chunk.modify(-1, (n) => n * 10)) // => Option.none()
    * ```
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -4263,6 +4408,7 @@ export const modify: {
  * chunk.pipe(Chunk.replace(-1, "Z")) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category transforming
  * @since 2.0.0
  */
@@ -4286,6 +4432,7 @@ export const replace: {
    * chunk.pipe(Chunk.replace(-1, "Z")) // => Option.none()
    * ```
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -4309,6 +4456,7 @@ export const replace: {
    * chunk.pipe(Chunk.replace(-1, "Z")) // => Option.none()
    * ```
    *
+   * @stability stable
    * @category transforming
    * @since 2.0.0
    */
@@ -4331,6 +4479,7 @@ export const replace: {
  * Chunk.toArray(Chunk.makeBy(5, (i) => i * 2)) // => [0, 2, 4, 6, 8]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -4351,6 +4500,7 @@ export const makeBy: {
    * Chunk.toArray(Chunk.makeBy(5, (i) => i * 2)) // => [0, 2, 4, 6, 8]
    * ```
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -4371,6 +4521,7 @@ export const makeBy: {
    * Chunk.toArray(Chunk.makeBy(5, (i) => i * 2)) // => [0, 2, 4, 6, 8]
    * ```
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -4394,6 +4545,7 @@ export const makeBy: {
  * Chunk.toArray(Chunk.range(1, 5)) // => [1, 2, 3, 4, 5]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -4425,6 +4577,7 @@ export const range = (start: number, end: number): NonEmptyChunk<number> =>
  * Chunk.contains(Chunk.empty<number>(), 1) // => false
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -4454,6 +4607,7 @@ export const contains: {
    * Chunk.contains(Chunk.empty<number>(), 1) // => false
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -4483,6 +4637,7 @@ export const contains: {
    * Chunk.contains(Chunk.empty<number>(), 1) // => false
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -4515,6 +4670,7 @@ export const contains: {
  * containsCaseInsensitive(words, "grape") // => false
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -4549,6 +4705,7 @@ export const containsWith: <A>(
  * firstString // => Option.some("hello")
  * ```
  *
+ * @stability stable
  * @category searching
  * @since 2.0.0
  */
@@ -4577,6 +4734,7 @@ export const findFirst: {
    * firstString // => Option.some("hello")
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -4605,6 +4763,7 @@ export const findFirst: {
    * firstString // => Option.some("hello")
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -4633,6 +4792,7 @@ export const findFirst: {
    * firstString // => Option.some("hello")
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -4661,6 +4821,7 @@ export const findFirst: {
    * firstString // => Option.some("hello")
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -4685,6 +4846,7 @@ export const findFirst: {
  * Chunk.findFirstIndex(chunk, (n) => n % 2 === 0) // => Option.some(1)
  * ```
  *
+ * @stability stable
  * @category searching
  * @since 2.0.0
  */
@@ -4707,6 +4869,7 @@ export const findFirstIndex: {
    * Chunk.findFirstIndex(chunk, (n) => n % 2 === 0) // => Option.some(1)
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -4729,6 +4892,7 @@ export const findFirstIndex: {
    * Chunk.findFirstIndex(chunk, (n) => n % 2 === 0) // => Option.some(1)
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -4756,6 +4920,7 @@ export const findFirstIndex: {
  * Chunk.findLast(chunk, (n) => n % 2 === 0) // => Option.some(4)
  * ```
  *
+ * @stability stable
  * @category searching
  * @since 2.0.0
  */
@@ -4778,6 +4943,7 @@ export const findLast: {
    * Chunk.findLast(chunk, (n) => n % 2 === 0) // => Option.some(4)
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -4800,6 +4966,7 @@ export const findLast: {
    * Chunk.findLast(chunk, (n) => n % 2 === 0) // => Option.some(4)
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -4822,6 +4989,7 @@ export const findLast: {
    * Chunk.findLast(chunk, (n) => n % 2 === 0) // => Option.some(4)
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -4844,6 +5012,7 @@ export const findLast: {
    * Chunk.findLast(chunk, (n) => n % 2 === 0) // => Option.some(4)
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -4868,6 +5037,7 @@ export const findLast: {
  * Chunk.findLastIndex(chunk, (n) => n % 2 === 0) // => Option.some(3)
  * ```
  *
+ * @stability stable
  * @category searching
  * @since 2.0.0
  */
@@ -4890,6 +5060,7 @@ export const findLastIndex: {
    * Chunk.findLastIndex(chunk, (n) => n % 2 === 0) // => Option.some(3)
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -4912,6 +5083,7 @@ export const findLastIndex: {
    * Chunk.findLastIndex(chunk, (n) => n % 2 === 0) // => Option.some(3)
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -4943,6 +5115,7 @@ export const findLastIndex: {
  * }
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 2.0.0
  */
@@ -4969,6 +5142,7 @@ export const every: {
    * }
    * ```
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -4995,6 +5169,7 @@ export const every: {
    * }
    * ```
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -5021,6 +5196,7 @@ export const every: {
    * }
    * ```
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -5047,6 +5223,7 @@ export const every: {
    * }
    * ```
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -5084,6 +5261,7 @@ export const every: {
  * Chunk.some(words, (word) => word.includes("ban")) // => true
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 2.0.0
  */
@@ -5108,6 +5286,7 @@ export const some: {
    * Chunk.some(words, (word) => word.includes("ban")) // => true
    * ```
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -5132,6 +5311,7 @@ export const some: {
    * Chunk.some(words, (word) => word.includes("ban")) // => true
    * ```
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -5170,6 +5350,7 @@ export const some: {
  * Chunk.join(Chunk.make("hello"), ", ") // => "hello"
  * ```
  *
+ * @stability stable
  * @category folding
  * @since 2.0.0
  */
@@ -5195,6 +5376,7 @@ export const join: {
    * Chunk.join(Chunk.make("hello"), ", ") // => "hello"
    * ```
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -5220,6 +5402,7 @@ export const join: {
    * Chunk.join(Chunk.make("hello"), ", ") // => "hello"
    * ```
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -5245,6 +5428,7 @@ export const join: {
  * Chunk.reduce(chunk, -Infinity, (acc, n) => Math.max(acc, n)) // => 5
  * ```
  *
+ * @stability stable
  * @category folding
  * @since 2.0.0
  */
@@ -5268,6 +5452,7 @@ export const reduce: {
    * Chunk.reduce(chunk, -Infinity, (acc, n) => Math.max(acc, n)) // => 5
    * ```
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -5291,6 +5476,7 @@ export const reduce: {
    * Chunk.reduce(chunk, -Infinity, (acc, n) => Math.max(acc, n)) // => 5
    * ```
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -5320,6 +5506,7 @@ export const reduce: {
  * Chunk.reduceRight(chunk, 0, (acc, n) => n - acc) // => -2
  * ```
  *
+ * @stability stable
  * @category folding
  * @since 2.0.0
  */
@@ -5347,6 +5534,7 @@ export const reduceRight: {
    * Chunk.reduceRight(chunk, 0, (acc, n) => n - acc) // => -2
    * ```
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -5374,6 +5562,7 @@ export const reduceRight: {
    * Chunk.reduceRight(chunk, 0, (acc, n) => n - acc) // => -2
    * ```
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -5407,6 +5596,7 @@ export const reduceRight: {
  * Chunk.toArray(caseInsensitive(words1, words2)) // => ["Banana", "Cherry"]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 3.2.0
  */
@@ -5442,6 +5632,7 @@ export const differenceWith = <A>(isEquivalent: (self: A, that: A) => boolean):
  * Chunk.toArray(Chunk.difference(chunk1, Chunk.empty<number>())) // => [1, 2, 3, 4, 5]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 3.2.0
  */
@@ -5468,6 +5659,7 @@ export const difference: {
    * Chunk.toArray(Chunk.difference(chunk1, Chunk.empty<number>())) // => [1, 2, 3, 4, 5]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 3.2.0
    */
@@ -5494,6 +5686,7 @@ export const difference: {
    * Chunk.toArray(Chunk.difference(chunk1, Chunk.empty<number>())) // => [1, 2, 3, 4, 5]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 3.2.0
    */