effect 4.0.1 → 4.0.2

package/src/Record.ts

@@ -7,6 +7,7 @@
  * entries. Helpers that change values return new records instead of mutating the
  * input.
  *
+ * @stability stable
  * @since 2.0.0
  */
 
@@ -41,6 +42,7 @@ import type { NoInfer } from "./Types.ts"
  * user // => { name: "John", age: 30 }
  * ```
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -67,6 +69,7 @@ export type ReadonlyRecord<in out K extends string | symbol, out A> = {
  * "b" satisfies CommonKeys
  * ```
  *
+ * @stability stable
  * @since 2.0.0
  */
 export declare namespace ReadonlyRecord {
@@ -167,6 +170,7 @@ export declare namespace ReadonlyRecord {
  * defaults // => { port: 3000, retries: 3 }
  * ```
  *
+ * @stability stable
  * @category utility types
  * @since 2.0.0
  */
@@ -190,6 +194,7 @@ export interface ReadonlyRecordTypeLambda<K extends string = string> extends Typ
  * Record.set(emptyRecord, "count", 42) // => { count: 42 }
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -210,6 +215,7 @@ export const empty = <K extends string | symbol = never, V = never>(): Record<
  * Record.isEmptyRecord({ a: 3 }) // => false
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 2.0.0
  */
@@ -228,6 +234,7 @@ export const isEmptyRecord = <K extends string, A>(self: Record<K, A>): self is
  * Record.isEmptyReadonlyRecord({ a: 3 }) // => false
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 2.0.0
  */
@@ -247,6 +254,7 @@ export const isEmptyReadonlyRecord: <K extends string, A>(
  * Record.fromIterableWith([1, 2, 3, 4], (a) => [String(a), a * 2]) // => { "1": 2, "2": 4, "3": 6, "4": 8 }
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -263,6 +271,7 @@ export const fromIterableWith: {
    * Record.fromIterableWith([1, 2, 3, 4], (a) => [String(a), a * 2]) // => { "1": 2, "2": 4, "3": 6, "4": 8 }
    * ```
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -279,6 +288,7 @@ export const fromIterableWith: {
    * Record.fromIterableWith([1, 2, 3, 4], (a) => [String(a), a * 2]) // => { "1": 2, "2": 4, "3": 6, "4": 8 }
    * ```
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -317,6 +327,7 @@ export const fromIterableWith: {
  * ) // => { "1": { id: "1", name: "name1" }, "2": { id: "2", name: "name2" } }
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -340,6 +351,7 @@ export const fromIterableBy: {
    * ) // => { "1": { id: "1", name: "name1" }, "2": { id: "2", name: "name2" } }
    * ```
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -363,6 +375,7 @@ export const fromIterableBy: {
    * ) // => { "1": { id: "1", name: "name1" }, "2": { id: "2", name: "name2" } }
    * ```
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -391,6 +404,7 @@ export const fromIterableBy: {
  * Record.fromEntries([["a", 1], ["b", 2]]) // => { a: 1, b: 2 }
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -410,6 +424,7 @@ export const fromEntries: <Entry extends readonly [string | symbol, any]>(
  * Record.collect(x, (key, n) => [key, n]) // => [["a", 1], ["b", 2], ["c", 3]]
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 2.0.0
  */
@@ -426,6 +441,7 @@ export const collect: {
    * Record.collect(x, (key, n) => [key, n]) // => [["a", 1], ["b", 2], ["c", 3]]
    * ```
    *
+   * @stability stable
    * @category converting
    * @since 2.0.0
    */
@@ -442,6 +458,7 @@ export const collect: {
    * Record.collect(x, (key, n) => [key, n]) // => [["a", 1], ["b", 2], ["c", 3]]
    * ```
    *
+   * @stability stable
    * @category converting
    * @since 2.0.0
    */
@@ -469,6 +486,7 @@ export const collect: {
  * Record.toEntries(x) // => [["a", 1], ["b", 2], ["c", 3]]
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 2.0.0
  */
@@ -488,6 +506,7 @@ export const toEntries: <K extends string, A>(self: ReadonlyRecord<K, A>) => Arr
  * Record.size({ a: "a", b: 1, c: true }) // => 3
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -505,6 +524,7 @@ export const size = <K extends string, A>(self: ReadonlyRecord<K, A>): number =>
  * Record.has(Record.empty<string>(), "c") // => false
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -521,6 +541,7 @@ export const has: {
    * Record.has(Record.empty<string>(), "c") // => false
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -537,6 +558,7 @@ export const has: {
    * Record.has(Record.empty<string>(), "c") // => false
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -563,6 +585,7 @@ export const has: {
  * R.get(person, "email") // => Option.none()
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -581,6 +604,7 @@ export const get: {
    * R.get(person, "email") // => Option.none()
    * ```
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -599,6 +623,7 @@ export const get: {
    * R.get(person, "email") // => Option.none()
    * ```
    *
+   * @stability stable
    * @category getters
    * @since 2.0.0
    */
@@ -626,6 +651,7 @@ export const get: {
  * Record.modify(input, "b", f) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category mutations
  * @since 2.0.0
  */
@@ -647,6 +673,7 @@ export const modify: {
    * Record.modify(input, "b", f) // => Option.none()
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -668,6 +695,7 @@ export const modify: {
    * Record.modify(input, "b", f) // => Option.none()
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -702,6 +730,7 @@ export const modify: {
  * Record.replace(Record.empty<string>(), "a", 10) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category mutations
  * @since 2.0.0
  */
@@ -724,6 +753,7 @@ export const replace: {
    * Record.replace(Record.empty<string>(), "a", 10) // => Option.none()
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -746,6 +776,7 @@ export const replace: {
    * Record.replace(Record.empty<string>(), "a", 10) // => Option.none()
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -779,6 +810,7 @@ export const replace: {
  * Record.remove({ a: 1, b: 2 }, "a") // => { b: 2 }
  * ```
  *
+ * @stability stable
  * @category mutations
  * @since 2.0.0
  */
@@ -803,6 +835,7 @@ export const remove: {
    * Record.remove({ a: 1, b: 2 }, "a") // => { b: 2 }
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -827,6 +860,7 @@ export const remove: {
    * Record.remove({ a: 1, b: 2 }, "a") // => { b: 2 }
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -859,6 +893,7 @@ export const remove: {
  * Record.pop(input, "c") // => Option.none()
  * ```
  *
+ * @stability stable
  * @category mutations
  * @since 2.0.0
  */
@@ -879,6 +914,7 @@ export const pop: {
    * Record.pop(input, "c") // => Option.none()
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -899,6 +935,7 @@ export const pop: {
    * Record.pop(input, "c") // => Option.none()
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -926,6 +963,7 @@ export const pop: {
  * Record.map({ a: 3, b: 5 }, g) // => { a: "A-3", b: "B-5" }
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -947,6 +985,7 @@ export const map: {
    * Record.map({ a: 3, b: 5 }, g) // => { a: "A-3", b: "B-5" }
    * ```
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -968,6 +1007,7 @@ export const map: {
    * Record.map({ a: 3, b: 5 }, g) // => { a: "A-3", b: "B-5" }
    * ```
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -994,6 +1034,7 @@ export const map: {
  * Record.mapKeys({ a: 3, b: 5 }, (key) => key.toUpperCase()) // => { A: 3, B: 5 }
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -1009,6 +1050,7 @@ export const mapKeys: {
    * Record.mapKeys({ a: 3, b: 5 }, (key) => key.toUpperCase()) // => { A: 3, B: 5 }
    * ```
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -1024,6 +1066,7 @@ export const mapKeys: {
    * Record.mapKeys({ a: 3, b: 5 }, (key) => key.toUpperCase()) // => { A: 3, B: 5 }
    * ```
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -1054,6 +1097,7 @@ export const mapKeys: {
  * Record.mapEntries({ a: 3, b: 5 }, (a, key) => [key.toUpperCase(), a + 1]) // => { A: 4, B: 6 }
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -1069,6 +1113,7 @@ export const mapEntries: {
    * Record.mapEntries({ a: 3, b: 5 }, (a, key) => [key.toUpperCase(), a + 1]) // => { A: 4, B: 6 }
    * ```
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -1084,6 +1129,7 @@ export const mapEntries: {
    * Record.mapEntries({ a: 3, b: 5 }, (a, key) => [key.toUpperCase(), a + 1]) // => { A: 4, B: 6 }
    * ```
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -1117,6 +1163,7 @@ export const mapEntries: {
  * Record.filterMap(x, f) // => { c: 6 }
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -1135,6 +1182,7 @@ export const filterMap: {
    * Record.filterMap(x, f) // => { c: 6 }
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1153,6 +1201,7 @@ export const filterMap: {
    * Record.filterMap(x, f) // => { c: 6 }
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1186,6 +1235,7 @@ export const filterMap: {
  * Record.filter(x, (n) => n > 2) // => { c: 3, d: 4 }
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -1202,6 +1252,7 @@ export const filter: {
    * Record.filter(x, (n) => n > 2) // => { c: 3, d: 4 }
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1218,6 +1269,7 @@ export const filter: {
    * Record.filter(x, (n) => n > 2) // => { c: 3, d: 4 }
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1234,6 +1286,7 @@ export const filter: {
    * Record.filter(x, (n) => n > 2) // => { c: 3, d: 4 }
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1250,6 +1303,7 @@ export const filter: {
    * Record.filter(x, (n) => n > 2) // => { c: 3, d: 4 }
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1282,6 +1336,7 @@ export const filter: {
  * Record.getSomes({ a: Option.some(1), b: Option.none(), c: Option.some(2) }) // => { a: 1, c: 2 }
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -1316,6 +1371,7 @@ export const getSomes: <K extends string, A>(
  * }) // => { b: "err" }
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -1349,6 +1405,7 @@ export const getFailures = <K extends string, A, E>(
  * }) // => { a: 1, c: 2 }
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -1385,6 +1442,7 @@ export const getSuccesses = <K extends string, A, E>(
  * Record.partition(x, f) // => [{ b: 2 }, { a: 1, c: 3 }]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -1408,6 +1466,7 @@ export const partition: {
    * Record.partition(x, f) // => [{ b: 2 }, { a: 1, c: 3 }]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1433,6 +1492,7 @@ export const partition: {
    * Record.partition(x, f) // => [{ b: 2 }, { a: 1, c: 3 }]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -1469,6 +1529,7 @@ export const partition: {
  * Record.separate({ a: Result.fail("e"), b: Result.succeed(1) }) // => [{ b: 1 }, { a: "e" }]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -1487,6 +1548,7 @@ export const separate: <K extends string, A, B>(
  * Record.keys({ a: 1, b: 2, c: 3 }) // => ["a", "b", "c"]
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -1504,6 +1566,7 @@ export const keys = <K extends string | symbol, A>(self: ReadonlyRecord<K, A>):
  * Record.values({ a: 1, b: 2, c: 3 }) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -1521,6 +1584,7 @@ export const values = <K extends string, A>(self: ReadonlyRecord<K, A>): Array<A
  * Record.set("c", 5)({ a: 1, b: 2 }) // => { a: 1, b: 2, c: 5 }
  * ```
  *
+ * @stability stable
  * @category mutations
  * @since 2.0.0
  */
@@ -1537,6 +1601,7 @@ export const set: {
    * Record.set("c", 5)({ a: 1, b: 2 }) // => { a: 1, b: 2, c: 5 }
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -1553,6 +1618,7 @@ export const set: {
    * Record.set("c", 5)({ a: 1, b: 2 }) // => { a: 1, b: 2, c: 5 }
    * ```
    *
+   * @stability stable
    * @category mutations
    * @since 2.0.0
    */
@@ -1600,6 +1666,7 @@ export const set: {
  * ```
  *
  * @see {@link set} for an immutable update
+ * @stability stable
  * @category mutations
  * @since 4.0.0
  */
@@ -1629,6 +1696,7 @@ export const assignProperty: (self: object, key: PropertyKey, value: unknown) =>
  * isSubrecord(required, { role: "editor", status: "active" }) // => false
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -1662,6 +1730,7 @@ export const isSubrecordBy = <A>(equivalence: Equivalence<A>): {
  * Record.isSubrecord({ a: 1, b: 2 }, { a: 1 } as Record<string, number>) // => false
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -1683,6 +1752,7 @@ export const isSubrecord: {
    * Record.isSubrecord({ a: 1, b: 2 }, { a: 1 } as Record<string, number>) // => false
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -1704,6 +1774,7 @@ export const isSubrecord: {
    * Record.isSubrecord({ a: 1, b: 2 }, { a: 1 } as Record<string, number>) // => false
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -1721,6 +1792,7 @@ export const isSubrecord: {
  * Record.reduce({ a: 1, b: 2, c: 3 }, 0, (acc, value) => acc + value) // => 6
  * ```
  *
+ * @stability stable
  * @category folding
  * @since 2.0.0
  */
@@ -1736,6 +1808,7 @@ export const reduce: {
    * Record.reduce({ a: 1, b: 2, c: 3 }, 0, (acc, value) => acc + value) // => 6
    * ```
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -1751,6 +1824,7 @@ export const reduce: {
    * Record.reduce({ a: 1, b: 2, c: 3 }, 0, (acc, value) => acc + value) // => 6
    * ```
    *
+   * @stability stable
    * @category folding
    * @since 2.0.0
    */
@@ -1786,6 +1860,7 @@ export const reduce: {
  * Record.every({ a: 1, b: -1 }, (n) => n > 0) // => false
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 2.0.0
  */
@@ -1802,6 +1877,7 @@ export const every: {
    * Record.every({ a: 1, b: -1 }, (n) => n > 0) // => false
    * ```
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -1818,6 +1894,7 @@ export const every: {
    * Record.every({ a: 1, b: -1 }, (n) => n > 0) // => false
    * ```
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -1834,6 +1911,7 @@ export const every: {
    * Record.every({ a: 1, b: -1 }, (n) => n > 0) // => false
    * ```
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -1850,6 +1928,7 @@ export const every: {
    * Record.every({ a: 1, b: -1 }, (n) => n > 0) // => false
    * ```
    *
+   * @stability stable
    * @category guards
    * @since 2.0.0
    */
@@ -1881,6 +1960,7 @@ export const every: {
  * Record.some({ a: 1, b: 2 }, (n) => n > 2) // => false
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -1897,6 +1977,7 @@ export const some: {
    * Record.some({ a: 1, b: 2 }, (n) => n > 2) // => false
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -1913,6 +1994,7 @@ export const some: {
    * Record.some({ a: 1, b: 2 }, (n) => n > 2) // => false
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -1941,6 +2023,7 @@ export const some: {
  * Record.union({ a: 1, b: 2 }, { b: 3, c: 4 }, (a, b) => a + b) // => { a: 1, b: 5, c: 4 }
  * ```
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -1957,6 +2040,7 @@ export const union: {
    * Record.union({ a: 1, b: 2 }, { b: 3, c: 4 }, (a, b) => a + b) // => { a: 1, b: 5, c: 4 }
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -1973,6 +2057,7 @@ export const union: {
    * Record.union({ a: 1, b: 2 }, { b: 3, c: 4 }, (a, b) => a + b) // => { a: 1, b: 5, c: 4 }
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -2023,6 +2108,7 @@ export const union: {
  * Record.intersection({ a: 1, b: 2 }, { b: 3, c: 4 }, (a, b) => a + b) // => { b: 5 }
  * ```
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -2039,6 +2125,7 @@ export const intersection: {
    * Record.intersection({ a: 1, b: 2 }, { b: 3, c: 4 }, (a, b) => a + b) // => { b: 5 }
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -2055,6 +2142,7 @@ export const intersection: {
    * Record.intersection({ a: 1, b: 2 }, { b: 3, c: 4 }, (a, b) => a + b) // => { b: 5 }
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -2095,6 +2183,7 @@ export const intersection: {
  * Record.difference({ a: 1, b: 2 }, { b: 3, c: 4 }) // => { a: 1, c: 4 }
  * ```
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -2111,6 +2200,7 @@ export const difference: {
    * Record.difference({ a: 1, b: 2 }, { b: 3, c: 4 }) // => { a: 1, c: 4 }
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -2127,6 +2217,7 @@ export const difference: {
    * Record.difference({ a: 1, b: 2 }, { b: 3, c: 4 }) // => { a: 1, c: 4 }
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -2170,6 +2261,7 @@ export const difference: {
  * recordEquivalence({ a: 1, b: 2 }, { a: 1, b: 3 }) // => false
  * ```
  *
+ * @stability stable
  * @category instances
  * @since 4.0.0
  */
@@ -2191,6 +2283,7 @@ export const makeEquivalence = <K extends string, A>(
  * Record.singleton("a", 1) // => { a: 1 }
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -2217,6 +2310,7 @@ export const singleton = <K extends string | symbol, A>(key: K, value: A): Recor
  * @see {@link union} for one-off record merging with the same union semantics
  * @see {@link makeReducerIntersection} for a reducer that keeps only keys present on both sides
  *
+ * @stability stable
  * @category combining
  * @since 4.0.0
  */
@@ -2245,6 +2339,7 @@ export function makeReducerUnion<K extends string, A>(combiner: Combiner.Combine
  * @see {@link makeReducerUnion} for a reducer that preserves keys from either input record
  * @see {@link intersection} for applying the shared-key merge to one pair of records
  *
+ * @stability stable
  * @category combining
  * @since 4.0.0
  */
@@ -2273,6 +2368,7 @@ export function makeReducerIntersection<K extends string, A>(
  * ) // => Option.some(["c", 3])
  * ```
  *
+ * @stability stable
  * @category searching
  * @since 3.14.0
  */
@@ -2293,6 +2389,7 @@ export const findFirst: {
    * ) // => Option.some(["c", 3])
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 3.14.0
    */
@@ -2313,6 +2410,7 @@ export const findFirst: {
    * ) // => Option.some(["c", 3])
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 3.14.0
    */
@@ -2333,6 +2431,7 @@ export const findFirst: {
    * ) // => Option.some(["c", 3])
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 3.14.0
    */
@@ -2356,6 +2455,7 @@ export const findFirst: {
    * ) // => Option.some(["c", 3])
    * ```
    *
+   * @stability stable
    * @category searching
    * @since 3.14.0
    */