effect 4.0.0 → 4.0.2

package/src/Iterable.ts

@@ -6,6 +6,7 @@
  * fold iterable values while preserving the input as an iterable instead of
  * forcing an array first.
  *
+ * @stability stable
  * @since 2.0.0
  */
 
@@ -51,6 +52,7 @@ import type { NoInfer } from "./Types.ts"
  * Array.from(first10) // => [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -90,6 +92,7 @@ export const makeBy = <A>(f: (i: number) => A, options?: {
  * Array.from(Iterable.range(1, 3)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -118,6 +121,7 @@ export const range = (start: number, end?: number): Iterable<number> => {
  * Array.from(Iterable.replicate("a", 3)) // => ["a", "a", "a"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -138,6 +142,7 @@ export const replicate: {
    * Array.from(Iterable.replicate("a", 3)) // => ["a", "a", "a"]
    * ```
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -158,6 +163,7 @@ export const replicate: {
    * Array.from(Iterable.replicate("a", 3)) // => ["a", "a", "a"]
    * ```
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -179,6 +185,7 @@ export const replicate: {
  *
  * @see {@link forever} for repeating without an upper bound
  * @see {@link replicate} for repeating a single value
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -198,6 +205,7 @@ export const repeat: {
    *
    * @see {@link forever} for repeating without an upper bound
    * @see {@link replicate} for repeating a single value
+   * @stability stable
    * @category constructors
    * @since 4.0.0
    */
@@ -217,6 +225,7 @@ export const repeat: {
    *
    * @see {@link forever} for repeating without an upper bound
    * @see {@link replicate} for repeating a single value
+   * @stability stable
    * @category constructors
    * @since 4.0.0
    */
@@ -239,6 +248,7 @@ export const repeat: {
  * @see {@link repeat} for repeating an iterable a specific number of times
  * @see {@link take} for bounding the unbounded result before materializing it
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -256,6 +266,7 @@ export const forever = <A>(self: Iterable<A>): Iterable<A> => repeat(self, Infin
  * Array.from(Iterable.fromRecord(x)) // => [["a", 1], ["b", 2], ["c", 3]]
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 2.0.0
  */
@@ -287,6 +298,7 @@ export const fromRecord = <K extends string, A>(self: Readonly<Record<K, A>>): I
  * Array.from(withZ) // => ["z", "a", "b", "c"]
  * ```
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -309,6 +321,7 @@ export const prepend: {
    * Array.from(withZ) // => ["z", "a", "b", "c"]
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -331,6 +344,7 @@ export const prepend: {
    * Array.from(withZ) // => ["z", "a", "b", "c"]
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -348,6 +362,7 @@ export const prepend: {
  * Array.from(Iterable.prependAll([1, 2], ["a", "b"])) // => ["a", "b", 1, 2]
  * ```
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -363,6 +378,7 @@ export const prependAll: {
    * Array.from(Iterable.prependAll([1, 2], ["a", "b"])) // => ["a", "b", 1, 2]
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -378,6 +394,7 @@ export const prependAll: {
    * Array.from(Iterable.prependAll([1, 2], ["a", "b"])) // => ["a", "b", 1, 2]
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -417,6 +434,7 @@ export const prependAll: {
  * @see {@link prepend} for adding one element before the existing elements
  * @see {@link appendAll} for appending all elements from another iterable
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -451,6 +469,7 @@ export const append: {
    * @see {@link prepend} for adding one element before the existing elements
    * @see {@link appendAll} for appending all elements from another iterable
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -485,6 +504,7 @@ export const append: {
    * @see {@link prepend} for adding one element before the existing elements
    * @see {@link appendAll} for appending all elements from another iterable
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -530,6 +550,7 @@ export const append: {
  * @see {@link append} for appending one value instead of another iterable
  * @see {@link prependAll} for yielding another iterable before `self`
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -573,6 +594,7 @@ export const appendAll: {
    * @see {@link append} for appending one value instead of another iterable
    * @see {@link prependAll} for yielding another iterable before `self`
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -616,6 +638,7 @@ export const appendAll: {
    * @see {@link append} for appending one value instead of another iterable
    * @see {@link prependAll} for yielding another iterable before `self`
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -669,6 +692,7 @@ export const appendAll: {
  * Array.from(runningMax) // => [-Infinity, 3, 3, 4, 4, 5, 9, 9]
  * ```
  *
+ * @stability stable
  * @category folding
  * @since 2.0.0
  */
@@ -697,6 +721,7 @@ export const scan: {
    * Array.from(runningMax) // => [-Infinity, 3, 3, 4, 4, 5, 9, 9]
    * ```
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -725,6 +750,7 @@ export const scan: {
    * Array.from(runningMax) // => [-Infinity, 3, 3, 4, 4, 5, 9, 9]
    * ```
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -761,6 +787,7 @@ export const scan: {
  * Iterable.isEmpty([1, 2, 3]) // => false
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 2.0.0
  */
@@ -792,6 +819,7 @@ export const isEmpty = <A>(self: Iterable<A>): self is Iterable<never> => {
  * Iterable.size(range) // => 100
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -829,6 +857,7 @@ export const size = <A>(self: Iterable<A>): number => {
  * doubled // => Option.some(10)
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -869,6 +898,7 @@ export const head = <A>(self: Iterable<A>): Option<A> => {
  * Iterable.headUnsafe(nonEmpty) // => 1
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 4.0.0
  */
@@ -910,6 +940,7 @@ export const headUnsafe = <A>(self: Iterable<A>): A => {
  * Array.from(firstFive) // => [1, 2, 3, 4, 5]
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -945,6 +976,7 @@ export const take: {
    * Array.from(firstFive) // => [1, 2, 3, 4, 5]
    * ```
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -980,6 +1012,7 @@ export const take: {
    * Array.from(firstFive) // => [1, 2, 3, 4, 5]
    * ```
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -1035,6 +1068,7 @@ export const take: {
  * Array.from(stringPrefix) // => ["a", "b", "c"]
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -1071,6 +1105,7 @@ export const takeWhile: {
    * Array.from(stringPrefix) // => ["a", "b", "c"]
    * ```
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -1107,6 +1142,7 @@ export const takeWhile: {
    * Array.from(stringPrefix) // => ["a", "b", "c"]
    * ```
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -1143,6 +1179,7 @@ export const takeWhile: {
    * Array.from(stringPrefix) // => ["a", "b", "c"]
    * ```
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -1179,6 +1216,7 @@ export const takeWhile: {
    * Array.from(stringPrefix) // => ["a", "b", "c"]
    * ```
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -1229,6 +1267,7 @@ export const takeWhile: {
  * Array.from(slice) // => [2, 3, 4]
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -1263,6 +1302,7 @@ export const drop: {
    * Array.from(slice) // => [2, 3, 4]
    * ```
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -1297,6 +1337,7 @@ export const drop: {
    * Array.from(slice) // => [2, 3, 4]
    * ```
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -1360,6 +1401,7 @@ export const drop: {
  * findSquareRoot // => Option.some(1)
  * ```
  *
+ * @stability stable
  * @category searching
  * @since 2.0.0
  */
@@ -1401,6 +1443,7 @@ export const findFirst: {
    * findSquareRoot // => Option.some(1)
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -1442,6 +1485,7 @@ export const findFirst: {
    * findSquareRoot // => Option.some(1)
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -1483,6 +1527,7 @@ export const findFirst: {
    * findSquareRoot // => Option.some(1)
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -1524,6 +1569,7 @@ export const findFirst: {
    * findSquareRoot // => Option.some(1)
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -1565,6 +1611,7 @@ export const findFirst: {
    * findSquareRoot // => Option.some(1)
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -1606,6 +1653,7 @@ export const findFirst: {
    * findSquareRoot // => Option.some(1)
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -1660,6 +1708,7 @@ export const findFirst: {
  * lastString // => Option.some("world")
  * ```
  *
+ * @stability stable
  * @category searching
  * @since 2.0.0
  */
@@ -1693,6 +1742,7 @@ export const findLast: {
    * lastString // => Option.some("world")
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -1726,6 +1776,7 @@ export const findLast: {
    * lastString // => Option.some("world")
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -1759,6 +1810,7 @@ export const findLast: {
    * lastString // => Option.some("world")
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -1792,6 +1844,7 @@ export const findLast: {
    * lastString // => Option.some("world")
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -1825,6 +1878,7 @@ export const findLast: {
    * lastString // => Option.some("world")
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -1858,6 +1912,7 @@ export const findLast: {
    * lastString // => Option.some("world")
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 2.0.0
    */
@@ -1916,6 +1971,7 @@ export const findLast: {
  * Array.from(indexed) // => [[0, "apple"], [1, "banana"], [2, "cherry"]]
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -1952,6 +2008,7 @@ export const zip: {
    * Array.from(indexed) // => [[0, "apple"], [1, "banana"], [2, "cherry"]]
    * ```
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -1988,6 +2045,7 @@ export const zip: {
    * Array.from(indexed) // => [[0, "apple"], [1, "banana"], [2, "cherry"]]
    * ```
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -2041,6 +2099,7 @@ export const zip: {
  * Array.from(totals) // => [21.98, 25.5, 15]
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -2089,6 +2148,7 @@ export const zipWith: {
    * Array.from(totals) // => [21.98, 25.5, 15]
    * ```
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -2137,6 +2197,7 @@ export const zipWith: {
    * Array.from(totals) // => [21.98, 25.5, 15]
    * ```
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -2200,6 +2261,7 @@ export const zipWith: {
  * Array.from(css).join("") // => "color: red; font-size: 14px; margin: 10px"
  * ```
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -2246,6 +2308,7 @@ export const intersperse: {
    * Array.from(css).join("") // => "color: red; font-size: 14px; margin: 10px"
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -2292,6 +2355,7 @@ export const intersperse: {
    * Array.from(css).join("") // => "color: red; font-size: 14px; margin: 10px"
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -2352,6 +2416,7 @@ export const intersperse: {
  * hasAlmostTwo // => true
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -2401,6 +2466,7 @@ export const containsWith = <A>(isEquivalent: (self: A, that: A) => boolean): {
  * containsThree([4, 5, 6]) // => false
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -2438,6 +2504,7 @@ export const contains: {
    * containsThree([4, 5, 6]) // => false
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -2475,6 +2542,7 @@ export const contains: {
    * containsThree([4, 5, 6]) // => false
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -2516,6 +2584,7 @@ export const contains: {
  * Array.from(Iterable.take(batchSums, 3)) // => [55, 155, 255]
  * ```
  *
+ * @stability stable
  * @category splitting
  * @since 2.0.0
  */
@@ -2555,6 +2624,7 @@ export const chunksOf: {
    * Array.from(Iterable.take(batchSums, 3)) // => [55, 155, 255]
    * ```
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -2594,6 +2664,7 @@ export const chunksOf: {
    * Array.from(Iterable.take(batchSums, 3)) // => [55, 155, 255]
    * ```
    *
+   * @stability stable
    * @category splitting
    * @since 2.0.0
    */
@@ -2658,6 +2729,7 @@ export const chunksOf: {
  * Array.from(scatteredGroups) // => [[1], [2], [1], [2], [1]]
  * ```
  *
+ * @stability stable
  * @category grouping
  * @since 2.0.0
  */
@@ -2694,6 +2766,7 @@ export const groupWith: {
    * Array.from(scatteredGroups) // => [[1], [2], [1], [2], [1]]
    * ```
    *
+   * @stability stable
    * @category grouping
    * @since 2.0.0
    */
@@ -2730,6 +2803,7 @@ export const groupWith: {
    * Array.from(scatteredGroups) // => [[1], [2], [1], [2], [1]]
    * ```
    *
+   * @stability stable
    * @category grouping
    * @since 2.0.0
    */
@@ -2799,6 +2873,7 @@ export const groupWith: {
  * // Note: Only consecutive equal objects are grouped together
  * ```
  *
+ * @stability stable
  * @category grouping
  * @since 2.0.0
  */
@@ -2853,6 +2928,7 @@ export const group: <A>(self: Iterable<A>) => Iterable<NonEmptyArray<A>> = group
  * evenOdd // => { odd: [1, 3, 5], even: [2, 4, 6] }
  * ```
  *
+ * @stability stable
  * @category grouping
  * @since 2.0.0
  */
@@ -2904,6 +2980,7 @@ export const groupBy: {
    * evenOdd // => { odd: [1, 3, 5], even: [2, 4, 6] }
    * ```
    *
+   * @stability stable
    * @category grouping
    * @since 2.0.0
    */
@@ -2955,6 +3032,7 @@ export const groupBy: {
    * evenOdd // => { odd: [1, 3, 5], even: [2, 4, 6] }
    * ```
    *
+   * @stability stable
    * @category grouping
    * @since 2.0.0
    */
@@ -3002,6 +3080,7 @@ const constEmptyIterator: Iterator<never> = {
  * Array.from(Iterable.empty<string>()) // => []
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -3039,6 +3118,7 @@ export const empty = <A = never>(): Iterable<A> => constEmpty
  * Array.from(evensOnly) // => [2, 4]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -3074,6 +3154,7 @@ export const of = <A>(a: A): Iterable<A> => [a]
  * )) // => [3, 5, 7]
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -3108,6 +3189,7 @@ export const map: {
    * )) // => [3, 5, 7]
    * ```
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -3142,6 +3224,7 @@ export const map: {
    * )) // => [3, 5, 7]
    * ```
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -3197,6 +3280,7 @@ export const map: {
  * Array.from(indexed) // => ["a", "b", "b", "c", "c", "c"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -3236,6 +3320,7 @@ export const flatMap: {
    * Array.from(indexed) // => ["a", "b", "b", "c", "c", "c"]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -3275,6 +3360,7 @@ export const flatMap: {
    * Array.from(indexed) // => ["a", "b", "b", "c", "c", "c"]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -3314,6 +3400,7 @@ export const flatMap: {
  * Array.from(flatWithEmpty) // => [1, 2, 3, 4]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -3386,6 +3473,7 @@ export const flatten = <A>(self: Iterable<Iterable<A>>): Iterable<A> => ({
  * Array.from(evenIndexItems) // => ["0: a", "2: c", "4: e"]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -3435,6 +3523,7 @@ export const filterMap: {
    * Array.from(evenIndexItems) // => ["0: a", "2: c", "4: e"]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -3484,6 +3573,7 @@ export const filterMap: {
    * Array.from(evenIndexItems) // => ["0: a", "2: c", "4: e"]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -3544,6 +3634,7 @@ export const filterMap: {
  * Array.from(indexedUntilC) // => ["0: a", "1: b"]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -3581,6 +3672,7 @@ export const filterMapWhile: {
    * Array.from(indexedUntilC) // => ["0: a", "1: b"]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -3618,6 +3710,7 @@ export const filterMapWhile: {
    * Array.from(indexedUntilC) // => ["0: a", "1: b"]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -3653,6 +3746,7 @@ export const filterMapWhile: {
  * Array.from(Iterable.getSomes([Option.some(1), Option.none(), Option.some(2)])) // => [1, 2]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -3692,6 +3786,7 @@ export const getSomes = <A>(self: Iterable<Option<A>>): Iterable<A> => {
  * ])) // => ["err"]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -3731,6 +3826,7 @@ export const getFailures = <R0, L>(self: Iterable<Result<R0, L>>): Iterable<L> =
  * ])) // => [1, 2]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -3794,6 +3890,7 @@ export const getSuccesses = <R0, L>(self: Iterable<Result<R0, L>>): Iterable<R0>
  * Array.from(processed) // => [30, 40, 50]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -3838,6 +3935,7 @@ export const filter: {
    * Array.from(processed) // => [30, 40, 50]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -3882,6 +3980,7 @@ export const filter: {
    * Array.from(processed) // => [30, 40, 50]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -3926,6 +4025,7 @@ export const filter: {
    * Array.from(processed) // => [30, 40, 50]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -3970,6 +4070,7 @@ export const filter: {
    * Array.from(processed) // => [30, 40, 50]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -4038,6 +4139,7 @@ export const filter: {
  * Array.from(foundValues) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -4084,6 +4186,7 @@ export const flatMapNullishOr: {
    * Array.from(foundValues) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -4130,6 +4233,7 @@ export const flatMapNullishOr: {
    * Array.from(foundValues) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -4181,6 +4285,7 @@ export const flatMapNullishOr: {
  * hasString // => true
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -4223,6 +4328,7 @@ export const some: {
    * hasString // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -4265,6 +4371,7 @@ export const some: {
    * hasString // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -4319,6 +4426,7 @@ export const some: {
  * Array.from(collatz) // => [7, 22, 11, 34, 17, 52, 26, 13, 40, 20, 10, 5, 16, 8, 4, 2]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -4377,6 +4485,7 @@ export const unfold = <B, A>(b: B, f: (b: B) => Option<readonly [A, B]>): Iterab
  * processed // => [[1, 2], [3, 4], [5, 6]]
  * ```
  *
+ * @stability stable
  * @category traversing
  * @since 2.0.0
  */
@@ -4419,6 +4528,7 @@ export const forEach: {
    * processed // => [[1, 2], [3, 4], [5, 6]]
    * ```
    *
+   * @stability stable
    * @category traversing
    * @since 2.0.0
    */
@@ -4461,6 +4571,7 @@ export const forEach: {
    * processed // => [[1, 2], [3, 4], [5, 6]]
    * ```
    *
+   * @stability stable
    * @category traversing
    * @since 2.0.0
    */
@@ -4519,6 +4630,7 @@ export const forEach: {
  * indexed // => ["0: a", "1: b", "2: c"]
  * ```
  *
+ * @stability stable
  * @category folding
  * @since 2.0.0
  */
@@ -4570,6 +4682,7 @@ export const reduce: {
    * indexed // => ["0: a", "1: b", "2: c"]
    * ```
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -4621,6 +4734,7 @@ export const reduce: {
    * indexed // => ["0: a", "1: b", "2: c"]
    * ```
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -4676,6 +4790,7 @@ export const reduce: {
  * Array.from(dedupedFloats) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -4719,6 +4834,7 @@ export const dedupeAdjacentWith: {
    * Array.from(dedupedFloats) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -4762,6 +4878,7 @@ export const dedupeAdjacentWith: {
    * Array.from(dedupedFloats) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -4827,6 +4944,7 @@ export const dedupeAdjacentWith: {
  * Array.from(cleanedData) // => [100, 101, 102, 100]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -4873,6 +4991,7 @@ export const dedupeAdjacent: <A>(self: Iterable<A>) => Iterable<A> = dedupeAdjac
  * Array.from(testCases) // => ["admin_can_read", "admin_can_write", "admin_can_delete", "user_can_read", "user_can_write", "user_can_delete"]
  * ```
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -4918,6 +5037,7 @@ export const cartesianWith: {
    * Array.from(testCases) // => ["admin_can_read", "admin_can_write", "admin_can_delete", "user_can_read", "user_can_write", "user_can_delete"]
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -4963,6 +5083,7 @@ export const cartesianWith: {
    * Array.from(testCases) // => ["admin_can_read", "admin_can_write", "admin_can_delete", "user_can_read", "user_can_write", "user_can_delete"]
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -5035,6 +5156,7 @@ export const cartesianWith: {
  * Array.from(withEmpty) // => []
  * ```
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -5071,6 +5193,7 @@ export const cartesian: {
    * Array.from(withEmpty) // => []
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -5107,6 +5230,7 @@ export const cartesian: {
    * Array.from(withEmpty) // => []
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -5127,6 +5251,7 @@ export const cartesian: {
  * Iterable.countBy([1, 2, 3, 4, 5], (n) => n % 2 === 0) // => 2
  * ```
  *
+ * @stability stable
  * @category folding
  * @since 3.16.0
  */
@@ -5142,6 +5267,7 @@ export const countBy: {
    * Iterable.countBy([1, 2, 3, 4, 5], (n) => n % 2 === 0) // => 2
    * ```
    *
+   * @stability stable
    * @category folding
    * @since 3.16.0
    */
@@ -5157,6 +5283,7 @@ export const countBy: {
    * Iterable.countBy([1, 2, 3, 4, 5], (n) => n % 2 === 0) // => 2
    * ```
    *
+   * @stability stable
    * @category folding
    * @since 3.16.0
    */