effect 4.0.1 → 4.0.3

package/src/Channel.ts

@@ -7,6 +7,7 @@
  * higher-level modules instead. This module is useful when implementing stream
  * operators or specialized streaming workflows.
  *
+ * @stability stable
  * @since 2.0.0
  */
 // @effect-diagnostics returnEffectInGen:off
@@ -50,6 +51,7 @@ import type * as Unify from "./Unify.ts"
 /**
  * String literal type used as the unique brand for `Channel` values.
  *
+ * @stability stable
  * @category type IDs
  * @since 4.0.0
  */
@@ -59,6 +61,7 @@ export type TypeId = "~effect/Channel"
  * Runtime identifier stored on `Channel` values and used by `isChannel` to
  * recognize them.
  *
+ * @stability stable
  * @category type IDs
  * @since 4.0.0
  */
@@ -77,6 +80,7 @@ export const TypeId: TypeId = "~effect/Channel"
  * Channel.isChannel("not a channel") // => false
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 3.5.4
  */
@@ -135,6 +139,7 @@ export const isChannel = (
  * Effect.runSync(Channel.runCollect(channel)) // => [1]
  * ```
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -161,6 +166,7 @@ export interface Channel<
  * or generic return types that include channels. Users normally do not need to
  * reference this interface directly.
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -181,6 +187,7 @@ export interface ChannelUnify<A extends { [Unify.typeSymbol]?: any }> extends Ef
  * environment type parameters. Users normally do not need to reference this
  * interface directly.
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -202,6 +209,7 @@ type TagsWithReason<E> = {
  * contravariant. This is type-level machinery and is not used directly at
  * runtime.
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -226,6 +234,7 @@ export interface Variance<
  * `_InElem`, `_InErr`, and `_InDone` fields are contravariant. Users normally
  * do not need to reference this interface directly.
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -278,6 +287,7 @@ const ChannelProto = {
  * await Effect.runPromise(Channel.runCollect(channel)) // => []
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -322,6 +332,7 @@ export const fromTransform = <OutElem, OutErr, OutDone, InElem, InErr, InDone, E
  * await Effect.runPromise(Channel.runCollect(transformedChannel)) // => [2, 4, 6]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -374,6 +385,7 @@ export const transformPull = <
  * await Effect.runPromise(Channel.runCollect(channel)) // => [42]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -394,6 +406,7 @@ export const fromPull = <OutElem, OutErr, OutDone, EX, EnvX, Env>(
  * when the channel completes.
  *
  * @see {@link fromTransform} for a simpler transformation without a forked scope
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -431,6 +444,7 @@ export const fromTransformBracket = <OutElem, OutErr, OutDone, InElem, InErr, In
  * Effect.runSync(Channel.runCollect(channel)) // => [42]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -452,6 +466,7 @@ export const toTransform = <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env
  * Channel.DefaultChunkSize // => 4096
  * ```
  *
+ * @stability stable
  * @category constants
  * @since 4.0.0
  */
@@ -470,7 +485,12 @@ const asyncQueue = <A, E = never, R = never>(
     strategy: options?.strategy
   }).pipe(
     Effect.tap((queue) => Scope.addFinalizer(scope, Queue.shutdown(queue))),
-    Effect.tap((queue) => Effect.forkIn(Scope.provide(f(queue), scope), scope))
+    Effect.tap((queue) =>
+      Scope.provide(f(queue), scope).pipe(
+        Effect.catchCause((cause) => Queue.failCause(queue, cause)),
+        Effect.forkIn(scope)
+      )
+    )
   )
 
 /**
@@ -492,6 +512,7 @@ const asyncQueue = <A, E = never, R = never>(
  * await Effect.runPromise(Channel.runCollect(channel)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -520,6 +541,7 @@ export const callback = <A, E = never, R = never>(
  * await Effect.runPromise(Channel.runCollect(channel)) // => [[1, 2]]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -544,6 +566,7 @@ export const callbackArray = <A, E = never, R = never>(
  * Effect.runSync(Channel.runCollect(channel)) // => [42]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -576,6 +599,7 @@ export const suspend = <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(
  * const observed = [await Effect.runPromise(Channel.runCollect(channel)), released] // => [["RESOURCE"], ["resource"]]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -591,8 +615,10 @@ export const acquireUseRelease = <A, E, R, OutElem, OutErr, OutDone, InElem, InE
         Option.isSome(option)
           ? release(option.value, exit as any)
           : Effect.void)
-      const value = yield* Effect.uninterruptible(acquire)
-      option = Option.some(value)
+      const value = yield* Effect.uninterruptible(Effect.map(acquire, (value) => {
+        option = Option.some(value)
+        return value
+      }))
       return yield* toTransform(use(value))(upstream, scope)
     })
   )
@@ -620,6 +646,7 @@ export const acquireUseRelease = <A, E, R, OutElem, OutErr, OutDone, InElem, InE
  * const observed = [await Effect.runPromise(Channel.runCollect(channel)), released] // => [["resource"], ["resource"]]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -647,6 +674,7 @@ export const acquireRelease: {
    * const observed = [await Effect.runPromise(Channel.runCollect(channel)), released] // => [["resource"], ["resource"]]
    * ```
    *
+   * @stability stable
    * @category constructors
    * @since 4.0.0
    */
@@ -674,6 +702,7 @@ export const acquireRelease: {
    * const observed = [await Effect.runPromise(Channel.runCollect(channel)), released] // => [["resource"], ["resource"]]
    * ```
    *
+   * @stability stable
    * @category constructors
    * @since 4.0.0
    */
@@ -703,6 +732,7 @@ export const acquireRelease: {
  * Effect.runSync(Channel.runCollect(channel)) // => [1, 2, 3, 4, 5]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -729,6 +759,7 @@ export const fromIterator = <A, L>(iterator: LazyArg<Iterator<A, L>>): Channel<A
  * Effect.runSync(Channel.runCollect(channel)) // => [1, 2, 3, 4, 5]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -751,6 +782,7 @@ export const fromArray = <A>(array: ReadonlyArray<A>): Channel<A> =>
  * Effect.runSync(Channel.runCollect(channel)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -804,6 +836,7 @@ export const fromChunk = <A>(chunk: Chunk.Chunk<A>): Channel<A> => fromArray(Chu
  * Effect.runSync(Channel.runCollect(fibChannel)) // => [[0, 1, 1], [2, 3]]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -849,6 +882,7 @@ export const fromIteratorArray = <A, L>(
  * Effect.runSync(Channel.runCollect(channel)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -873,6 +907,7 @@ export const fromIterable = <A, L>(iterable: Iterable<A, L>): Channel<A, never,
  * Effect.runSync(Channel.runCollect(channel)) // => [[1, 2, 3, 4], [5]]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -893,6 +928,7 @@ export const fromIterableArray = <A, L>(
  * Effect.runSync(Channel.runCollect(channel)) // => [42]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -910,6 +946,7 @@ export const succeed = <A>(value: A): Channel<A> => fromEffect(Effect.succeed(va
  * Effect.runSync(Channel.runCollect(channel)) // => []
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -918,6 +955,7 @@ export const end = <A>(value: A): Channel<never, never, A> => fromPull(Effect.su
 /**
  * Creates a `Channel` that immediately ends with the lazily evaluated value.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -941,6 +979,7 @@ export const endSync = <A>(evaluate: LazyArg<A>): Channel<never, never, A> =>
  * Effect.runSync(Channel.runCollect(channel)) // => ["request-1"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -968,6 +1007,7 @@ export const sync = <A>(evaluate: LazyArg<A>): Channel<A> => fromEffect(Effect.s
  * Effect.runSync(Channel.runCollect(conditionalChannel(true))) // => ["data"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -997,6 +1037,7 @@ export const empty: Channel<never> = fromPull(Effect.succeed(Cause.done()))
  * Channel.isChannel(conditionalChannel(false)) // => true
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1014,6 +1055,7 @@ export const never: Channel<never, never, never> = fromPull(Effect.succeed(Effec
  * Effect.runSync(Effect.exit(Channel.runCollect(failedChannel))) // => Exit.fail("Something went wrong")
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1044,6 +1086,7 @@ export const fail = <E>(error: E): Channel<never, E, never> => fromPull(Effect.s
  * ] // => [Exit.fail("Error after attempt 1"), 1]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1067,6 +1110,7 @@ export const failSync = <E>(evaluate: LazyArg<E>): Channel<never, E, never> => f
  * Effect.runSync(Effect.exit(Channel.runCollect(failedChannel))) // => Exit.failCause(simpleCause)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1094,6 +1138,7 @@ export const failCause = <E>(cause: Cause.Cause<E>): Channel<never, E, never> =>
  * ] // => [Exit.fail("Runtime error after attempt 1"), 1]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1114,6 +1159,7 @@ export const failCauseSync = <E>(
  * Effect.runSync(Effect.exit(Channel.runCollect(diedChannel))) // => Exit.failCause(Cause.die(defect))
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1133,6 +1179,7 @@ export const die = (defect: unknown): Channel<never, never, never> => failCause(
  * Effect.runSync(Channel.runCollect(successChannel)) // => ["Hello from effect!"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1158,6 +1205,7 @@ export const fromEffect = <A, E, R>(
  *
  * If the effect fails, the channel fails with the effect's error.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1169,6 +1217,7 @@ export const fromEffectDone = <A, E, R>(
 /**
  * Uses an effect and discards its result.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1185,6 +1234,7 @@ export const fromEffectDrain = <A, E, R>(
  * `Take` fails the channel. A done `Take` completes the channel with its done
  * value.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1211,6 +1261,7 @@ export const fromEffectTake = <A, E, Done, E2, R>(
  * await Effect.runPromise(program) // => ["item1", "item2", "item3"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1236,6 +1287,7 @@ export const fromQueue = <A, E>(
  * await Effect.runPromise(program) // => [[1, 2, 3, 4]]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1247,6 +1299,7 @@ export const fromQueueArray = <A, E>(
  * Creates a channel that forwards upstream input elements, input errors, and
  * the upstream done value unchanged.
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1296,6 +1349,7 @@ export const identity = <Elem, Err, Done>(): Channel<Elem, Err, Done, Elem, Err,
  * })
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1410,6 +1464,7 @@ export const fromSubscription = <A>(
  * Option.map(result, ({ count, sum, average, min, max }) => ({ count, sum, average, min, max })) // => Option.some({ count: 1, sum: 10, average: 10, min: 10, max: 10 })
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1516,6 +1571,7 @@ export const fromSubscriptionArray = <A>(
  * const result = await Effect.runPromise(event) // => Option.some({ type: "user.created", payload: {}, timestamp: 1, processed: true, processedAt: 2 })
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1658,6 +1714,7 @@ export const fromPubSub = <A>(
  * Option.map(result, (batch) => [batch.batchId, batch.totalEntries, batch.infoCount]) // => Option.some(["1-1", 1, 1])
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1672,6 +1729,7 @@ export const fromPubSubArray = <A>(pubsub: PubSub.PubSub<A>): Channel<Arr.NonEmp
  * Output `Take` values are emitted as non-empty arrays. Failed `Take` values
  * fail the channel. Done `Take` values complete the channel.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1683,6 +1741,7 @@ export const fromPubSubTake = <A, E, Done>(
 /**
  * Creates a Channel from a Schedule.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1712,6 +1771,7 @@ export const fromSchedule = <O, E, R>(
  * await Effect.runPromise(Channel.runCollect(channel)) // => [[1]]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1802,6 +1862,7 @@ export const pullIntoWritableStream = <A, IE, E>(options: {
  * written // => [1, 2]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1841,6 +1902,7 @@ export const fromWritableStream = <IE, E, A>(options: {
  * await Effect.runPromise(program) // => [[2], [4]]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1924,6 +1986,7 @@ const readableStreamToPullUnsafe = <A, E, E2 = never>(options: {
  * are converted with `onError`. If the channel scope closes early and the
  * iterator has a `return` method, that method is called.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1955,6 +2018,7 @@ export const fromAsyncIterable = <A, D, E>(
  * rejected iterator errors are converted with `onError`. If the channel scope
  * closes early and the iterator has a `return` method, that method is called.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -2000,6 +2064,7 @@ export const fromAsyncIterableArray = <A, D, E>(
  * Effect.runSync(Channel.runCollect(displayChannel)) // => [{ displayName: "User: Alice", isActive: true }, { displayName: "User: Bob", isActive: true }]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -2041,6 +2106,7 @@ export const map: {
    * Effect.runSync(Channel.runCollect(displayChannel)) // => [{ displayName: "User: Alice", isActive: true }, { displayName: "User: Bob", isActive: true }]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -2084,6 +2150,7 @@ export const map: {
    * Effect.runSync(Channel.runCollect(displayChannel)) // => [{ displayName: "User: Alice", isActive: true }, { displayName: "User: Bob", isActive: true }]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -2107,6 +2174,7 @@ export const map: {
 /**
  * Maps the done value of this channel using the specified function.
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -2114,6 +2182,7 @@ export const mapDone: {
   /**
    * Maps the done value of this channel using the specified function.
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -2123,6 +2192,7 @@ export const mapDone: {
   /**
    * Maps the done value of this channel using the specified function.
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -2146,6 +2216,7 @@ export const mapDone: {
  * Use when the terminal done value transformation needs services or can fail,
  * while emitted elements should pass through unchanged.
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -2158,6 +2229,7 @@ export const mapDoneEffect: {
    * Use when the terminal done value transformation needs services or can fail,
    * while emitted elements should pass through unchanged.
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -2172,6 +2244,7 @@ export const mapDoneEffect: {
    * Use when the terminal done value transformation needs services or can fail,
    * while emitted elements should pass through unchanged.
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -2225,6 +2298,7 @@ const concurrencyIsSequential = (
  * await Effect.runPromise(Channel.runCollect(processedChannel)) // => [1, 4, 9, 16, 25]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -2258,6 +2332,7 @@ export const mapEffect: {
    * await Effect.runPromise(Channel.runCollect(processedChannel)) // => [1, 4, 9, 16, 25]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -2299,6 +2374,7 @@ export const mapEffect: {
    * await Effect.runPromise(Channel.runCollect(processedChannel)) // => [1, 4, 9, 16, 25]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -2450,6 +2526,7 @@ const mapEffectConcurrent = <
  * Returns a new channel which is the same as this one but applies the given
  * function to the input channel’s input elements.
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -2458,16 +2535,18 @@ export const mapInput: {
    * Returns a new channel which is the same as this one but applies the given
    * function to the input channel’s input elements.
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
   <InElem, InElem2, InErr, R = never>(f: (i: InElem2) => Effect.Effect<InElem, InErr, R>): <OutElem, OutErr, OutDone, InErr, InDone, Env>(
-    self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env | R>
-  ) => Channel<OutElem, OutErr, OutDone, InElem2, InErr, InDone, Env>
+    self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>
+  ) => Channel<OutElem, OutErr, OutDone, InElem2, InErr, InDone, Env | R>
   /**
    * Returns a new channel which is the same as this one but applies the given
    * function to the input channel’s input elements.
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -2490,6 +2569,7 @@ export const mapInput: {
  * Returns a new channel which is the same as this one but applies the given
  * function to the input errors.
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -2498,6 +2578,7 @@ export const mapInputError: {
    * Returns a new channel which is the same as this one but applies the given
    * function to the input errors.
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -2508,6 +2589,7 @@ export const mapInputError: {
    * Returns a new channel which is the same as this one but applies the given
    * function to the input errors.
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -2561,6 +2643,7 @@ export const mapInputError: {
  * const observed = [await Effect.runPromise(Channel.runCollect(tappedChannel)), processed] // => [[1, 2, 3], [1, 2, 3]]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -2597,6 +2680,7 @@ export const tap: {
    * const observed = [await Effect.runPromise(Channel.runCollect(tappedChannel)), processed] // => [[1, 2, 3], [1, 2, 3]]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -2640,6 +2724,7 @@ export const tap: {
    * const observed = [await Effect.runPromise(Channel.runCollect(tappedChannel)), processed] // => [[1, 2, 3], [1, 2, 3]]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -2695,6 +2780,7 @@ export const tap: {
  * Effect.runSync(Channel.runCollect(flatMappedChannel)) // => ["item-1-0", "item-2-0", "item-2-1", "item-3-0", "item-3-1", "item-3-2"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -2732,6 +2818,7 @@ export const flatMap: {
    * Effect.runSync(Channel.runCollect(flatMappedChannel)) // => ["item-1-0", "item-2-0", "item-2-1", "item-3-0", "item-3-1", "item-3-2"]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -2785,6 +2872,7 @@ export const flatMap: {
    * Effect.runSync(Channel.runCollect(flatMappedChannel)) // => ["item-1-0", "item-2-0", "item-2-1", "item-3-0", "item-3-1", "item-3-2"]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -2967,6 +3055,7 @@ const flatMapConcurrent = <
  * Effect.runSync(Channel.runCollect(numberChannel)) // => [1, 2, 3, "Completed processing"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -2992,6 +3081,7 @@ export const concatWith: {
    * Effect.runSync(Channel.runCollect(numberChannel)) // => [1, 2, 3, "Completed processing"]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -3029,6 +3119,7 @@ export const concatWith: {
    * Effect.runSync(Channel.runCollect(numberChannel)) // => [1, 2, 3, "Completed processing"]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -3129,6 +3220,7 @@ export const concatWith: {
  * Effect.runSync(Channel.runCollect(concatenatedChannel)) // => [1, 2, 3, "a", "b", "c"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -3156,6 +3248,7 @@ export const concat: {
    * Effect.runSync(Channel.runCollect(concatenatedChannel)) // => [1, 2, 3, "a", "b", "c"]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -3193,6 +3286,7 @@ export const concat: {
    * Effect.runSync(Channel.runCollect(concatenatedChannel)) // => [1, 2, 3, "a", "b", "c"]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -3265,6 +3359,7 @@ export const concat: {
  * left and right channels. It returns the next output element together with the
  * next state.
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -3283,6 +3378,7 @@ export const combine: {
    * left and right channels. It returns the next output element together with the
    * next state.
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -3317,6 +3413,7 @@ export const combine: {
    * left and right channels. It returns the next output element together with the
    * next state.
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -3417,6 +3514,7 @@ export const combine: {
  * the source completes before emitting an element, the fallback function
  * receives the source done value and returns the replacement channel.
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -3431,6 +3529,7 @@ export const orElseIfEmpty: {
    * the source completes before emitting an element, the fallback function
    * receives the source done value and returns the replacement channel.
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -3457,6 +3556,7 @@ export const orElseIfEmpty: {
    * the source completes before emitting an element, the fallback function
    * receives the source done value and returns the replacement channel.
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -3566,6 +3666,7 @@ export const orElseIfEmpty: {
  * Effect.runSync(Channel.runCollect(flattenedChannel)) // => [1, 2, 3, 4, 5, 6]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -3621,6 +3722,7 @@ export const flatten = <
  * Effect.runSync(Channel.runCollect(flattenedChannel)) // => [1, 2, 3, 4, 5, 6, 7, 8, 9]
  * ```
  *
+ * @stability stable
  * @category transforming
  * @since 4.0.0
  */
@@ -3672,6 +3774,7 @@ export const flattenArray = <
  * Output `Take` values are emitted as non-empty arrays. Failed `Take` values
  * fail the returned channel. Done `Take` values complete the returned channel.
  *
+ * @stability stable
  * @category transforming
  * @since 4.0.0
  */
@@ -3708,6 +3811,7 @@ export const flattenTake = <
  * Effect.runSync(Channel.runCollect(drainedChannel)) // => []
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -3735,6 +3839,7 @@ export const drain = <
 /**
  * Repeats this channel according to the provided schedule.
  *
+ * @stability stable
  * @category repetition
  * @since 4.0.0
  */
@@ -3742,6 +3847,7 @@ export const repeat: {
   /**
    * Repeats this channel according to the provided schedule.
    *
+   * @stability stable
    * @category repetition
    * @since 4.0.0
    */
@@ -3757,6 +3863,7 @@ export const repeat: {
   /**
    * Repeats this channel according to the provided schedule.
    *
+   * @stability stable
    * @category repetition
    * @since 4.0.0
    */
@@ -3818,6 +3925,7 @@ const repeatLoop = <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, E, Out
 /**
  * Repeats this channel forever.
  *
+ * @stability stable
  * @category repetition
  * @since 4.0.0
  */
@@ -3836,6 +3944,7 @@ export const forever = <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(
  * fails. If the schedule finishes, the returned channel completes with the
  * schedule output.
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -3851,6 +3960,7 @@ export const schedule: {
    * fails. If the schedule finishes, the returned channel completes with the
    * schedule output.
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -3868,6 +3978,7 @@ export const schedule: {
    * fails. If the schedule finishes, the returned channel completes with the
    * schedule output.
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -3921,6 +4032,7 @@ export const schedule: {
  * Effect.runSync(Channel.runCollect(numbersOnlyChannel)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -3950,6 +4062,7 @@ export const filter: {
    * Effect.runSync(Channel.runCollect(numbersOnlyChannel)) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -3981,6 +4094,7 @@ export const filter: {
    * Effect.runSync(Channel.runCollect(numbersOnlyChannel)) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4012,6 +4126,7 @@ export const filter: {
    * Effect.runSync(Channel.runCollect(numbersOnlyChannel)) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4044,6 +4159,7 @@ export const filter: {
    * Effect.runSync(Channel.runCollect(numbersOnlyChannel)) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4085,6 +4201,7 @@ export const filter: {
  * @see {@link filterMapEffect} for using an effectful `Filter`
  * @see {@link filterMapArray} for filtering arrays of output elements
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -4107,6 +4224,7 @@ export const filterMap: {
    * @see {@link filterMapEffect} for using an effectful `Filter`
    * @see {@link filterMapArray} for filtering arrays of output elements
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4131,6 +4249,7 @@ export const filterMap: {
    * @see {@link filterMapEffect} for using an effectful `Filter`
    * @see {@link filterMapArray} for filtering arrays of output elements
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4169,6 +4288,7 @@ export const filterMap: {
  * for which the predicate succeeds with `false` are discarded. Predicate
  * failures fail the returned channel.
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -4187,6 +4307,7 @@ export const filterEffect: {
    * for which the predicate succeeds with `false` are discarded. Predicate
    * failures fail the returned channel.
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4207,6 +4328,7 @@ export const filterEffect: {
    * for which the predicate succeeds with `false` are discarded. Predicate
    * failures fail the returned channel.
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4253,6 +4375,7 @@ export const filterEffect: {
  * @see {@link mapEffect} for effectfully transforming every output element
  * @see {@link filterMapArrayEffect} for effectful filtering of array outputs
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -4276,6 +4399,7 @@ export const filterMapEffect: {
    * @see {@link mapEffect} for effectfully transforming every output element
    * @see {@link filterMapArrayEffect} for effectful filtering of array outputs
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4301,6 +4425,7 @@ export const filterMapEffect: {
    * @see {@link mapEffect} for effectfully transforming every output element
    * @see {@link filterMapArrayEffect} for effectful filtering of array outputs
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4361,6 +4486,7 @@ export const filterMapEffect: {
  * Effect.runSync(Channel.runCollect(filteredOddChannel)) // => [[2, 4]]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -4398,6 +4524,7 @@ export const filterArray: {
    * Effect.runSync(Channel.runCollect(filteredOddChannel)) // => [[2, 4]]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4437,6 +4564,7 @@ export const filterArray: {
    * Effect.runSync(Channel.runCollect(filteredOddChannel)) // => [[2, 4]]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4476,6 +4604,7 @@ export const filterArray: {
    * Effect.runSync(Channel.runCollect(filteredOddChannel)) // => [[2, 4]]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4516,6 +4645,7 @@ export const filterArray: {
    * Effect.runSync(Channel.runCollect(filteredOddChannel)) // => [[2, 4]]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4552,6 +4682,7 @@ export const filterArray: {
  * Successful filter results are kept as mapped values. Failed filter results
  * are removed from the array. Arrays that become empty are discarded.
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -4565,6 +4696,7 @@ export const filterMapArray: {
    * Successful filter results are kept as mapped values. Failed filter results
    * are removed from the array. Arrays that become empty are discarded.
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4580,6 +4712,7 @@ export const filterMapArray: {
    * Successful filter results are kept as mapped values. Failed filter results
    * are removed from the array. Arrays that become empty are discarded.
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4623,6 +4756,7 @@ export const filterMapArray: {
  * for which the predicate succeeds with `true` are kept. Arrays that become
  * empty are discarded. Predicate failures fail the returned channel.
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -4642,6 +4776,7 @@ export const filterArrayEffect: {
    * for which the predicate succeeds with `true` are kept. Arrays that become
    * empty are discarded. Predicate failures fail the returned channel.
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4665,6 +4800,7 @@ export const filterArrayEffect: {
    * for which the predicate succeeds with `true` are kept. Arrays that become
    * empty are discarded. Predicate failures fail the returned channel.
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4701,6 +4837,7 @@ export const filterArrayEffect: {
  * are removed from the array. Arrays that become empty are discarded. Failures
  * from the effectful filter fail the returned channel.
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -4720,6 +4857,7 @@ export const filterMapArrayEffect: {
    * are removed from the array. Arrays that become empty are discarded. Failures
    * from the effectful filter fail the returned channel.
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4741,6 +4879,7 @@ export const filterMapArrayEffect: {
    * are removed from the array. Arrays that become empty are discarded. Failures
    * from the effectful filter fail the returned channel.
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -4801,6 +4940,7 @@ export const filterMapArrayEffect: {
  * Effect.runSync(Channel.runCollect(asyncMapAccum)) // => ["1-processed", "1", "2-processed", "12", "3-processed", "123", "4-processed", "1234"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -4840,6 +4980,7 @@ export const mapAccum: {
    * Effect.runSync(Channel.runCollect(asyncMapAccum)) // => ["1-processed", "1", "2-processed", "12", "3-processed", "123", "4-processed", "1234"]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -4905,6 +5046,7 @@ export const mapAccum: {
    * Effect.runSync(Channel.runCollect(asyncMapAccum)) // => ["1-processed", "1", "2-processed", "12", "3-processed", "123", "4-processed", "1234"]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -5010,6 +5152,7 @@ export const mapAccum: {
  * Effect.runSync(Channel.runCollect(sentenceChannel)) // => ["", "hello", "hello world", "hello world from", "hello world from effect"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -5041,6 +5184,7 @@ export const scan: {
    * Effect.runSync(Channel.runCollect(sentenceChannel)) // => ["", "hello", "hello world", "hello world from", "hello world from effect"]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -5087,6 +5231,7 @@ export const scan: {
    * Effect.runSync(Channel.runCollect(sentenceChannel)) // => ["", "hello", "hello world", "hello world from", "hello world from effect"]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -5148,6 +5293,7 @@ export const scan: {
  * await Effect.runPromise(Channel.runCollect(errorHandlingScan)) // => [0, 1, 3, 6, 10]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -5198,6 +5344,7 @@ export const scanEffect: {
    * await Effect.runPromise(Channel.runCollect(errorHandlingScan)) // => [0, 1, 3, 6, 10]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -5263,6 +5410,7 @@ export const scanEffect: {
    * await Effect.runPromise(Channel.runCollect(errorHandlingScan)) // => [0, 1, 3, 6, 10]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -5329,6 +5477,7 @@ export const scanEffect: {
  * Effect.runSync(Channel.runCollect(recoveredChannel)) // => ["Recovered from failure"]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -5366,6 +5515,7 @@ export const catchCause: {
    * Effect.runSync(Channel.runCollect(recoveredChannel)) // => ["Recovered from failure"]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -5420,6 +5570,7 @@ export const catchCause: {
    * Effect.runSync(Channel.runCollect(recoveredChannel)) // => ["Recovered from failure"]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -5519,6 +5670,7 @@ export const catchCause: {
  * Effect.runSync(Channel.runCollect(channel)) // => ["recovered: boom"]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -5542,6 +5694,7 @@ export const catchDefect: {
    * Effect.runSync(Channel.runCollect(channel)) // => ["recovered: boom"]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -5577,6 +5730,7 @@ export const catchDefect: {
    * Effect.runSync(Channel.runCollect(channel)) // => ["recovered: boom"]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -5649,6 +5803,7 @@ export const catchDefect: {
  * Use this for observing failures, such as logging or metrics. If the observer
  * effect fails, that failure can fail the returned channel.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -5667,6 +5822,7 @@ export const tapCause: {
    * Use this for observing failures, such as logging or metrics. If the observer
    * effect fails, that failure can fail the returned channel.
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -5700,6 +5856,7 @@ export const tapCause: {
    * Use this for observing failures, such as logging or metrics. If the observer
    * effect fails, that failure can fail the returned channel.
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -5769,6 +5926,7 @@ export const tapCause: {
  * @see {@link catchCause} for recovering from every cause
  * @see {@link catchIf} for recovering from typed channel errors
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -5792,6 +5950,7 @@ export const catchCauseIf: {
    * @see {@link catchCause} for recovering from every cause
    * @see {@link catchIf} for recovering from typed channel errors
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -5842,6 +6001,7 @@ export const catchCauseIf: {
    * @see {@link catchCause} for recovering from every cause
    * @see {@link catchIf} for recovering from typed channel errors
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -5939,6 +6099,7 @@ export const catchCauseIf: {
  * @see {@link catchFilter} for selecting typed errors with a `Filter`
  * @see {@link catchCause} for recovering from every cause
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -5962,6 +6123,7 @@ export const catchCauseFilter: {
    * @see {@link catchFilter} for selecting typed errors with a `Filter`
    * @see {@link catchCause} for recovering from every cause
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6017,6 +6179,7 @@ export const catchCauseFilter: {
    * @see {@link catchFilter} for selecting typed errors with a `Filter`
    * @see {@link catchCause} for recovering from every cause
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6184,6 +6347,7 @@ export {
   /**
    * Recovers from typed channel errors by running a fallback channel.
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6199,6 +6363,7 @@ export {
  * The effect is not run for normal channel completion. If the observer effect
  * fails, that failure can fail the returned channel.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -6212,6 +6377,7 @@ export const tapError: {
    * The effect is not run for normal channel completion. If the observer effect
    * fails, that failure can fail the returned channel.
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6240,6 +6406,7 @@ export const tapError: {
    * The effect is not run for normal channel completion. If the observer effect
    * fails, that failure can fail the returned channel.
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6317,6 +6484,7 @@ export const tapError: {
  * @see {@link catchTag} for selecting tagged typed errors
  * @see {@link catchCauseFilter} for selecting full causes with a `Filter`
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -6340,6 +6508,7 @@ export const catchIf: {
    * @see {@link catchTag} for selecting tagged typed errors
    * @see {@link catchCauseFilter} for selecting full causes with a `Filter`
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6403,6 +6572,7 @@ export const catchIf: {
    * @see {@link catchTag} for selecting tagged typed errors
    * @see {@link catchCauseFilter} for selecting full causes with a `Filter`
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6465,6 +6635,7 @@ export const catchIf: {
    * @see {@link catchTag} for selecting tagged typed errors
    * @see {@link catchCauseFilter} for selecting full causes with a `Filter`
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6528,6 +6699,7 @@ export const catchIf: {
    * @see {@link catchTag} for selecting tagged typed errors
    * @see {@link catchCauseFilter} for selecting full causes with a `Filter`
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6648,6 +6820,7 @@ export const catchIf: {
  * @see {@link catchTag} for selecting tagged typed errors
  * @see {@link catchCauseFilter} for selecting full causes with a `Filter`
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -6670,6 +6843,7 @@ export const catchFilter: {
    * @see {@link catchTag} for selecting tagged typed errors
    * @see {@link catchCauseFilter} for selecting full causes with a `Filter`
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6733,6 +6907,7 @@ export const catchFilter: {
    * @see {@link catchTag} for selecting tagged typed errors
    * @see {@link catchCauseFilter} for selecting full causes with a `Filter`
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6849,6 +7024,7 @@ export const catchFilter: {
  * errors are handled by `orElse` when provided. Without `orElse`,
  * non-matching errors are re-failed.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -6862,6 +7038,7 @@ export const catchTag: {
    * errors are handled by `orElse` when provided. Without `orElse`,
    * non-matching errors are re-failed.
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6921,6 +7098,7 @@ export const catchTag: {
    * errors are handled by `orElse` when provided. Without `orElse`,
    * non-matching errors are re-failed.
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -7051,6 +7229,7 @@ export const catchTag: {
  * Effect.runSync(Channel.runCollect(recovered)) // => ["retry: 60"]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -7086,6 +7265,7 @@ export const catchReason: {
    * Effect.runSync(Channel.runCollect(recovered)) // => ["retry: 60"]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -7172,6 +7352,7 @@ export const catchReason: {
    * Effect.runSync(Channel.runCollect(recovered)) // => ["retry: 60"]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -7300,6 +7481,7 @@ export const catchReason: {
 /**
  * Catches multiple reasons within a tagged error using an object of handlers.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -7307,6 +7489,7 @@ export const catchReasons: {
   /**
    * Catches multiple reasons within a tagged error using an object of handlers.
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -7385,6 +7568,7 @@ export const catchReasons: {
   /**
    * Catches multiple reasons within a tagged error using an object of handlers.
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -7512,6 +7696,7 @@ export const catchReasons: {
  * Effect.runSync(Effect.exit(Channel.runCollect(unwrapped))) // => Exit.fail(reason)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -7543,6 +7728,7 @@ export const unwrapReason: {
    * Effect.runSync(Effect.exit(Channel.runCollect(unwrapped))) // => Exit.fail(reason)
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -7587,6 +7773,7 @@ export const unwrapReason: {
    * Effect.runSync(Effect.exit(Channel.runCollect(unwrapped))) // => Exit.fail(reason)
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -7644,6 +7831,7 @@ export const unwrapReason: {
  * value of the returned channel is created by applying the specified function
  * to the failure value of this channel.
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -7653,6 +7841,7 @@ export const mapError: {
    * value of the returned channel is created by applying the specified function
    * to the failure value of this channel.
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -7664,6 +7853,7 @@ export const mapError: {
    * value of the returned channel is created by applying the specified function
    * to the failure value of this channel.
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -7699,6 +7889,7 @@ export const mapError: {
  * Effect.runSync(Effect.exit(Channel.runCollect(fatalChannel))) // => Exit.failCause(Cause.die(error))
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -7721,6 +7912,7 @@ export const orDie = <
  *
  * Use the `log` option to emit the full {@link Cause} when the channel fails.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -7783,6 +7975,7 @@ const ignoreCause_ = <
  *
  * Use the `log` option to emit the full {@link Cause} when the channel fails.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -7818,6 +8011,7 @@ export const ignoreCause: <
  * Returns a new channel that retries this channel according to the specified
  * schedule whenever it fails.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -7826,6 +8020,7 @@ export const retry: {
    * Returns a new channel that retries this channel according to the specified
    * schedule whenever it fails.
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -7844,6 +8039,7 @@ export const retry: {
    * Returns a new channel that retries this channel according to the specified
    * schedule whenever it fails.
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -7930,6 +8126,7 @@ export const retry: {
  * await Effect.runPromise(Channel.runCollect(switchedChannel)) // => ["value-3"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -7965,6 +8162,7 @@ export const switchMap: {
    * await Effect.runPromise(Channel.runCollect(switchedChannel)) // => ["value-3"]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -8016,6 +8214,7 @@ export const switchMap: {
    * await Effect.runPromise(Channel.runCollect(switchedChannel)) // => ["value-3"]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -8126,6 +8325,7 @@ export const switchMap: {
  * await Effect.runPromise(Channel.runCollect(mergedChannel)) // => [1, 2, 3, 4, 5, 6]
  * ```
  *
+ * @stability stable
  * @category combining
  * @since 2.0.0
  */
@@ -8163,6 +8363,7 @@ export const mergeAll: {
    * await Effect.runPromise(Channel.runCollect(mergedChannel)) // => [1, 2, 3, 4, 5, 6]
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -8224,6 +8425,7 @@ export const mergeAll: {
    * await Effect.runPromise(Channel.runCollect(mergedChannel)) // => [1, 2, 3, 4, 5, 6]
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 2.0.0
    */
@@ -8319,6 +8521,7 @@ export const mergeAll: {
          * await Effect.runPromise(Channel.runCollect(mergedChannel)) // => [1, 2, 3, 4, 5, 6]
          * ```
          *
+         * @stability stable
          * @category combining
          * @since 2.0.0
          */
@@ -8355,6 +8558,7 @@ export const mergeAll: {
          * await Effect.runPromise(Channel.runCollect(mergedChannel)) // => [1, 2, 3, 4, 5, 6]
          * ```
          *
+         * @stability stable
          * @category combining
          * @since 2.0.0
          */
@@ -8397,17 +8601,17 @@ export const mergeAll: {
               Effect.flatMap((value) => Queue.offer(queue, value)),
               Effect.forever({ disableYield: true }),
               Effect.onError(Effect.fnUntraced(function*(cause) {
-                const halt = Pull.filterDone(cause)
-                yield* Effect.exit(Scope.close(
-                  childScope,
-                  !Result.isFailure(halt) ? Exit.succeed(halt.success.value) : Exit.failCause(halt.failure)
-                ))
+                const exit = Pull.doneExitFromCause(cause)
+                const closeExit = yield* Effect.exit(Scope.close(childScope, exit))
                 if (!fibers.has(fiber)) return
+                // Publish usage and finalizer failures before releasing the
+                // permit or opening the latch, so the outer channel cannot
+                // complete ahead of them.
+                const failure = Exit.asVoidAll([exit, closeExit])
+                if (Exit.isFailure(failure)) yield* Queue.failCause(queue, failure.cause)
                 fibers.delete(fiber)
                 if (semaphore) yield* semaphore.release(1)
                 if (fibers.size === 0) yield* doneLatch.open
-                if (Result.isSuccess(halt)) return
-                return yield* Queue.failCause(queue, cause as any)
               })),
               Effect.forkChild
             )
@@ -8443,6 +8647,7 @@ export const mergeAll: {
  * const strategies: Array<Channel.HaltStrategy> = ["left", "right", "both", "either"] // => ["left", "right", "both", "either"]
  * ```
  *
+ * @stability stable
  * @category models
  * @since 4.0.0
  */
@@ -8468,6 +8673,7 @@ export type HaltStrategy = "left" | "right" | "both" | "either"
  * values.map(String).sort() // => ["1", "2", "3", "a", "b", "c"]
  * ```
  *
+ * @stability stable
  * @category combining
  * @since 4.0.0
  */
@@ -8492,6 +8698,7 @@ export const merge: {
    * values.map(String).sort() // => ["1", "2", "3", "a", "b", "c"]
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 4.0.0
    */
@@ -8531,6 +8738,7 @@ export const merge: {
    * values.map(String).sort() // => ["1", "2", "3", "a", "b", "c"]
    * ```
    *
+   * @stability stable
    * @category combining
    * @since 4.0.0
    */
@@ -8616,6 +8824,7 @@ export const merge: {
      * values.map(String).sort() // => ["1", "2", "3", "a", "b", "c"]
      * ```
      *
+     * @stability stable
      * @category combining
      * @since 4.0.0
      */
@@ -8639,6 +8848,7 @@ export const merge: {
      * values.map(String).sort() // => ["1", "2", "3", "a", "b", "c"]
      * ```
      *
+     * @stability stable
      * @category combining
      * @since 4.0.0
      */
@@ -8687,9 +8897,11 @@ export const merge: {
           )
         ),
         Effect.onError((cause) =>
-          Effect.andThen(
-            Scope.close(scope, Pull.doneExitFromCause(cause)),
-            onExit(side, cause)
+          Effect.onExitPrimitive(Pull.doneExitFromCause(cause), (exit) => Scope.close(scope, exit)).pipe(
+            Effect.matchCauseEffect({
+              onFailure: (cause) => onExit(side, cause),
+              onSuccess: () => onExit(side, cause)
+            })
           )
         ),
         Effect.forkIn(forkedScope)
@@ -8713,6 +8925,7 @@ export const merge: {
  * The effect's successful value is ignored. If the effect fails while the
  * channel is running, the returned channel fails with that error.
  *
+ * @stability stable
  * @category combining
  * @since 4.0.0
  */
@@ -8731,6 +8944,7 @@ export const mergeEffect: {
    * The effect's successful value is ignored. If the effect fails while the
    * channel is running, the returned channel fails with that error.
    *
+   * @stability stable
    * @category combining
    * @since 4.0.0
    */
@@ -8751,6 +8965,7 @@ export const mergeEffect: {
    * The effect's successful value is ignored. If the effect fails while the
    * channel is running, the returned channel fails with that error.
    *
+   * @stability stable
    * @category combining
    * @since 4.0.0
    */
@@ -8791,6 +9006,7 @@ export const mergeEffect: {
  * result // => ["hello", "world"]
  * ```
  *
+ * @stability stable
  * @category splitting
  * @since 2.0.0
  */
@@ -8902,10 +9118,14 @@ export const splitLines = <Err, Done>(): Channel<
  * span `Uint8Array` boundaries. The optional `encoding` and `options` are
  * passed to `TextDecoder`.
  *
+ * @stability stable
  * @category decoding
  * @since 4.0.0
  */
-export const decodeText = <Err, Done>(encoding?: string, options?: TextDecoderOptions): Channel<
+export const decodeText = <Err, Done>(
+  encoding?: string,
+  options?: ConstructorParameters<typeof TextDecoder>[1]
+): Channel<
   Arr.NonEmptyReadonlyArray<string>,
   Err,
   Done,
@@ -8928,6 +9148,7 @@ export const decodeText = <Err, Done>(encoding?: string, options?: TextDecoderOp
  *
  * Each string inside an emitted array is encoded independently.
  *
+ * @stability stable
  * @category encoding
  * @since 4.0.0
  */
@@ -8971,6 +9192,7 @@ export const encodeText = <Err, Done>(): Channel<
  * Effect.runSync(Channel.runCollect(pipedChannel)) // => [2, 4, 6]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -9000,6 +9222,7 @@ export const pipeTo: {
    * Effect.runSync(Channel.runCollect(pipedChannel)) // => [2, 4, 6]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -9031,6 +9254,7 @@ export const pipeTo: {
    * Effect.runSync(Channel.runCollect(pipedChannel)) // => [2, 4, 6]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -9074,6 +9298,7 @@ export const pipeTo: {
  * Effect.runSync(Effect.exit(Channel.runCollect(safePipedChannel))) // => Exit.fail(error)
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -9103,6 +9328,7 @@ export const pipeToOrFail: {
    * Effect.runSync(Effect.exit(Channel.runCollect(safePipedChannel))) // => Exit.fail(error)
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -9134,6 +9360,7 @@ export const pipeToOrFail: {
    * Effect.runSync(Effect.exit(Channel.runCollect(safePipedChannel))) // => Exit.fail(error)
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -9191,6 +9418,7 @@ export const pipeToOrFail: {
  * Effect.runSync(Channel.runCollect(unwrappedChannel)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -9213,6 +9441,7 @@ export const unwrap = <OutElem, OutErr, OutDone, InElem, InErr, InDone, R2, E, R
  * Runs a channel with a scope provided for the duration of the channel
  * execution, removing the channel's `Scope` requirement.
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -9255,6 +9484,7 @@ export const scoped = <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(
  * await Effect.runPromise(Channel.runCollect(embeddedChannel)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -9288,6 +9518,7 @@ export const embedInput: {
    * await Effect.runPromise(Channel.runCollect(embeddedChannel)) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -9327,6 +9558,7 @@ export const embedInput: {
    * await Effect.runPromise(Channel.runCollect(embeddedChannel)) // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -9374,6 +9606,7 @@ export const embedInput: {
  *
  * @see {@link bufferArray} for buffering elements from array outputs
  *
+ * @stability stable
  * @category buffering
  * @since 2.0.0
  */
@@ -9400,6 +9633,7 @@ export const buffer: {
    *
    * @see {@link bufferArray} for buffering elements from array outputs
    *
+   * @stability stable
    * @category buffering
    * @since 2.0.0
    */
@@ -9433,6 +9667,7 @@ export const buffer: {
    *
    * @see {@link bufferArray} for buffering elements from array outputs
    *
+   * @stability stable
    * @category buffering
    * @since 2.0.0
    */
@@ -9474,6 +9709,7 @@ export const buffer: {
      *
      * @see {@link bufferArray} for buffering elements from array outputs
      *
+     * @stability stable
      * @category buffering
      * @since 2.0.0
      */
@@ -9499,6 +9735,7 @@ export const buffer: {
      *
      * @see {@link bufferArray} for buffering elements from array outputs
      *
+     * @stability stable
      * @category buffering
      * @since 2.0.0
      */
@@ -9540,6 +9777,7 @@ export const buffer: {
  *
  * @see {@link buffer} for buffering output elements without flattening arrays
  *
+ * @stability stable
  * @category buffering
  * @since 4.0.0
  */
@@ -9568,6 +9806,7 @@ export const bufferArray: {
    *
    * @see {@link buffer} for buffering output elements without flattening arrays
    *
+   * @stability stable
    * @category buffering
    * @since 4.0.0
    */
@@ -9603,6 +9842,7 @@ export const bufferArray: {
    *
    * @see {@link buffer} for buffering output elements without flattening arrays
    *
+   * @stability stable
    * @category buffering
    * @since 4.0.0
    */
@@ -9646,6 +9886,7 @@ export const bufferArray: {
      *
      * @see {@link buffer} for buffering output elements without flattening arrays
      *
+     * @stability stable
      * @category buffering
      * @since 4.0.0
      */
@@ -9673,6 +9914,7 @@ export const bufferArray: {
      *
      * @see {@link buffer} for buffering output elements without flattening arrays
      *
+     * @stability stable
      * @category buffering
      * @since 4.0.0
      */
@@ -9704,6 +9946,7 @@ export const bufferArray: {
  * channel's done value. If the channel completes first, the original channel's
  * done value is preserved.
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -9722,6 +9965,7 @@ export const interruptWhen: {
    * channel's done value. If the channel completes first, the original channel's
    * done value is preserved.
    *
+   * @stability stable
    * @category interruption
    * @since 2.0.0
    */
@@ -9742,6 +9986,7 @@ export const interruptWhen: {
    * channel's done value. If the channel completes first, the original channel's
    * done value is preserved.
    *
+   * @stability stable
    * @category interruption
    * @since 2.0.0
    */
@@ -9769,6 +10014,7 @@ export const interruptWhen: {
  * fails with that error. If the channel completes first, the channel's done
  * value is preserved.
  *
+ * @stability stable
  * @category interruption
  * @since 4.0.0
  */
@@ -9783,6 +10029,7 @@ export const haltWhen: {
    * fails with that error. If the channel completes first, the channel's done
    * value is preserved.
    *
+   * @stability stable
    * @category interruption
    * @since 4.0.0
    */
@@ -9799,6 +10046,7 @@ export const haltWhen: {
    * fails with that error. If the channel completes first, the channel's done
    * value is preserved.
    *
+   * @stability stable
    * @category interruption
    * @since 4.0.0
    */
@@ -9832,6 +10080,7 @@ export const haltWhen: {
  * The finalizer receives the failure `Cause`. The original channel failure is
  * preserved. The finalizer itself must not fail.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -9844,6 +10093,7 @@ export const onError: {
    * The finalizer receives the failure `Cause`. The original channel failure is
    * preserved. The finalizer itself must not fail.
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -9860,6 +10110,7 @@ export const onError: {
    * The finalizer receives the failure `Cause`. The original channel failure is
    * preserved. The finalizer itself must not fail.
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -9898,6 +10149,7 @@ export const onError: {
  * const observed = [await Effect.runPromise(Channel.runCollect(channelWithExit)), exits] // => [[1, 2, 3], [Exit.void]]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -9927,6 +10179,7 @@ export const onExit: {
    * const observed = [await Effect.runPromise(Channel.runCollect(channelWithExit)), exits] // => [[1, 2, 3], [Exit.void]]
    * ```
    *
+   * @stability stable
    * @category resource management
    * @since 4.0.0
    */
@@ -9960,6 +10213,7 @@ export const onExit: {
    * const observed = [await Effect.runPromise(Channel.runCollect(channelWithExit)), exits] // => [[1, 2, 3], [Exit.void]]
    * ```
    *
+   * @stability stable
    * @category resource management
    * @since 4.0.0
    */
@@ -9985,6 +10239,7 @@ export const onExit: {
  * The effect's successful value is ignored. If the effect fails, the returned
  * channel fails before running the source channel.
  *
+ * @stability stable
  * @category hooks
  * @since 4.0.0
  */
@@ -9997,6 +10252,7 @@ export const onStart: {
    * The effect's successful value is ignored. If the effect fails, the returned
    * channel fails before running the source channel.
    *
+   * @stability stable
    * @category hooks
    * @since 4.0.0
    */
@@ -10011,6 +10267,7 @@ export const onStart: {
    * The effect's successful value is ignored. If the effect fails, the returned
    * channel fails before running the source channel.
    *
+   * @stability stable
    * @category hooks
    * @since 4.0.0
    */
@@ -10037,6 +10294,7 @@ export const onStart: {
  * emitted unchanged. The effect is not run if the channel completes without
  * emitting an element.
  *
+ * @stability stable
  * @category hooks
  * @since 4.0.0
  */
@@ -10055,6 +10313,7 @@ export const onFirst: {
    * emitted unchanged. The effect is not run if the channel completes without
    * emitting an element.
    *
+   * @stability stable
    * @category hooks
    * @since 4.0.0
    */
@@ -10075,6 +10334,7 @@ export const onFirst: {
    * emitted unchanged. The effect is not run if the channel completes without
    * emitting an element.
    *
+   * @stability stable
    * @category hooks
    * @since 4.0.0
    */
@@ -10105,6 +10365,7 @@ export const onFirst: {
  * not run when the channel fails. If the effect fails, the returned channel
  * fails with that error.
  *
+ * @stability stable
  * @category hooks
  * @since 4.0.0
  */
@@ -10118,6 +10379,7 @@ export const onEnd: {
    * not run when the channel fails. If the effect fails, the returned channel
    * fails with that error.
    *
+   * @stability stable
    * @category hooks
    * @since 4.0.0
    */
@@ -10133,6 +10395,7 @@ export const onEnd: {
    * not run when the channel fails. If the effect fails, the returned channel
    * fails with that error.
    *
+   * @stability stable
    * @category hooks
    * @since 4.0.0
    */
@@ -10175,6 +10438,7 @@ export const onEnd: {
  * const observed = [await Effect.runPromise(Channel.runCollect(channelWithCleanup)), events] // => [[1, 2, 3], ["cleanup"]]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -10204,6 +10468,7 @@ export const ensuring: {
    * const observed = [await Effect.runPromise(Channel.runCollect(channelWithCleanup)), events] // => [[1, 2, 3], ["cleanup"]]
    * ```
    *
+   * @stability stable
    * @category resource management
    * @since 2.0.0
    */
@@ -10235,6 +10500,7 @@ export const ensuring: {
    * const observed = [await Effect.runPromise(Channel.runCollect(channelWithCleanup)), events] // => [[1, 2, 3], ["cleanup"]]
    * ```
    *
+   * @stability stable
    * @category resource management
    * @since 2.0.0
    */
@@ -10273,6 +10539,7 @@ const runWith = <
 /**
  * Creates a channel from the specified services.
  *
+ * @stability stable
  * @category accessors
  * @since 2.0.0
  */
@@ -10287,6 +10554,7 @@ export const contextWith = <Env, OutElem, OutErr, OutDone, InElem, InErr, InDone
  * Provides a `Context` to the channel, removing the corresponding service
  * requirements from the returned channel.
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -10295,6 +10563,7 @@ export const provideContext: {
    * Provides a `Context` to the channel, removing the corresponding service
    * requirements from the returned channel.
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -10305,6 +10574,7 @@ export const provideContext: {
    * Provides a `Context` to the channel, removing the corresponding service
    * requirements from the returned channel.
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -10327,6 +10597,7 @@ export const provideContext: {
  * Provides a concrete service for a context key, removing that service
  * requirement from the returned channel.
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -10335,6 +10606,7 @@ export const provideService: {
    * Provides a concrete service for a context key, removing that service
    * requirement from the returned channel.
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -10345,6 +10617,7 @@ export const provideService: {
    * Provides a concrete service for a context key, removing that service
    * requirement from the returned channel.
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -10378,6 +10651,7 @@ export const provideService: {
  * If the service effect fails, the returned channel fails. The provided service
  * removes the corresponding service requirement from the returned channel.
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -10395,6 +10669,7 @@ export const provideServiceEffect: {
    * If the service effect fails, the returned channel fails. The provided service
    * removes the corresponding service requirement from the returned channel.
    *
+   * @stability stable
    * @category providing services
    * @since 4.0.0
    */
@@ -10414,6 +10689,7 @@ export const provideServiceEffect: {
    * If the service effect fails, the returned channel fails. The provided service
    * removes the corresponding service requirement from the returned channel.
    *
+   * @stability stable
    * @category providing services
    * @since 4.0.0
    */
@@ -10444,6 +10720,7 @@ export const provideServiceEffect: {
  * builds the layer in the channel scope. Use `options.local` to build a fresh
  * layer instance for this provision.
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -10458,6 +10735,7 @@ export const provide: {
    * builds the layer in the channel scope. Use `options.local` to build a fresh
    * layer instance for this provision.
    *
+   * @stability stable
    * @category providing services
    * @since 4.0.0
    */
@@ -10479,6 +10757,7 @@ export const provide: {
    * builds the layer in the channel scope. Use `options.local` to build a fresh
    * layer instance for this provision.
    *
+   * @stability stable
    * @category providing services
    * @since 4.0.0
    */
@@ -10518,6 +10797,7 @@ export const provide: {
  * provide to the channel. The returned channel requires the services needed to
  * build that context.
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -10531,6 +10811,7 @@ export const updateContext: {
    * provide to the channel. The returned channel requires the services needed to
    * build that context.
    *
+   * @stability stable
    * @category providing services
    * @since 4.0.0
    */
@@ -10546,6 +10827,7 @@ export const updateContext: {
    * provide to the channel. The returned channel requires the services needed to
    * build that context.
    *
+   * @stability stable
    * @category providing services
    * @since 4.0.0
    */
@@ -10572,6 +10854,7 @@ export const updateContext: {
  * The existing service is read from the context. The updated service is
  * provided to the channel under the same key.
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -10584,6 +10867,7 @@ export const updateService: {
    * The existing service is read from the context. The updated service is
    * provided to the channel under the same key.
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -10598,6 +10882,7 @@ export const updateService: {
    * The existing service is read from the context. The updated service is
    * provided to the channel under the same key.
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -10626,6 +10911,7 @@ export const updateService: {
  * The created span is provided as the current parent span while the channel
  * runs. The span is ended with the channel's exit value.
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -10638,6 +10924,7 @@ export const withSpan: {
    * The created span is provided as the current parent span while the channel
    * runs. The span is ended with the channel's exit value.
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -10652,6 +10939,7 @@ export const withSpan: {
    * The created span is provided as the current parent span while the channel
    * runs. The span is ended with the channel's exit value.
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -10690,6 +10978,7 @@ const withSpanImpl = <OutElem, OutErr, OutDone, InElem, InErr, InDone, R>(
 /**
  * The starting channel for Do notation, emitting an empty object.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -10744,6 +11033,7 @@ export {
   /**
    * Adds a computed field to each object emitted by a channel.
    *
+   * @stability stable
    * @category mapping
    * @since 4.0.0
    */
@@ -10760,6 +11050,7 @@ export {
  * channel's output becomes the value of the new field. `options.concurrency`
  * and `options.bufferSize` control how derived channels are flattened.
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -10774,6 +11065,7 @@ export const bind: {
    * channel's output becomes the value of the new field. `options.concurrency`
    * and `options.bufferSize` control how derived channels are flattened.
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -10805,6 +11097,7 @@ export const bind: {
    * channel's output becomes the value of the new field. `options.concurrency`
    * and `options.bufferSize` control how derived channels are flattened.
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -10892,6 +11185,7 @@ export const bind: {
  * @see {@link bind} for adding a field produced by another channel
  * @see {@link let_ let} for adding a computed field
  *
+ * @stability stable
  * @category mapping
  * @since 4.0.0
  */
@@ -10908,6 +11202,7 @@ export const bindTo: {
    * @see {@link bind} for adding a field produced by another channel
    * @see {@link let_ let} for adding a computed field
    *
+   * @stability stable
    * @category mapping
    * @since 4.0.0
    */
@@ -10934,6 +11229,7 @@ export const bindTo: {
    * @see {@link bind} for adding a field produced by another channel
    * @see {@link let_ let} for adding a computed field
    *
+   * @stability stable
    * @category mapping
    * @since 4.0.0
    */
@@ -10983,6 +11279,7 @@ export const bindTo: {
  * Effect.runSync(countEffect) // => 5
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -11012,6 +11309,7 @@ export const runCount = <OutElem, OutErr, OutDone, Env>(
  * Effect.runSync(drainEffect) // => "completed"
  * ```
  *
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -11045,6 +11343,7 @@ export const runDrain = <OutElem, OutErr, OutDone, Env>(
  * processed // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -11075,6 +11374,7 @@ export const runForEach: {
    * processed // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category running
    * @since 4.0.0
    */
@@ -11107,6 +11407,7 @@ export const runForEach: {
    * processed // => [1, 2, 3]
    * ```
    *
+   * @stability stable
    * @category running
    * @since 4.0.0
    */
@@ -11132,6 +11433,7 @@ export const runForEach: {
  * Returning `true` continues consuming the channel. Returning `false` stops
  * consumption early. The returned effect completes with `void`.
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -11145,6 +11447,7 @@ export const runForEachWhile: {
    * Returning `true` continues consuming the channel. Returning `false` stops
    * consumption early. The returned effect completes with `void`.
    *
+   * @stability stable
    * @category running
    * @since 4.0.0
    */
@@ -11160,6 +11463,7 @@ export const runForEachWhile: {
    * Returning `true` continues consuming the channel. Returning `false` stops
    * consumption early. The returned effect completes with `void`.
    *
+   * @stability stable
    * @category running
    * @since 4.0.0
    */
@@ -11203,6 +11507,7 @@ export const runForEachWhile: {
  * Array.from(bytes) // => [1, 2, 3, 4]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -11260,6 +11565,7 @@ export const mkUint8Array = <OutErr, OutDone, Env>(
  * Effect.runSync(collectEffect) // => [1, 2, 3, 4, 5]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -11280,6 +11586,7 @@ export const runCollect = <OutElem, OutErr, OutDone, Env>(
  * Returns `Option.some` with the first output element, or `Option.none` if the
  * channel completes without emitting output.
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -11307,6 +11614,7 @@ export const runHead = <OutElem, OutErr, OutDone, Env>(
  * Returns `Option.some` with the last emitted element, or `Option.none` if the
  * channel completes without emitting output.
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -11351,6 +11659,7 @@ export const runLast = <OutElem, OutErr, OutDone, Env>(
  * Effect.runSync(sumEffect) // => 15
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -11376,6 +11685,7 @@ export const runFold: {
    * Effect.runSync(sumEffect) // => 15
    * ```
    *
+   * @stability stable
    * @category running
    * @since 4.0.0
    */
@@ -11403,6 +11713,7 @@ export const runFold: {
    * Effect.runSync(sumEffect) // => 15
    * ```
    *
+   * @stability stable
    * @category running
    * @since 4.0.0
    */
@@ -11446,6 +11757,7 @@ export const runFold: {
  * the effectful accumulator function. The returned effect succeeds with the
  * final accumulator value.
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -11464,6 +11776,7 @@ export const runFoldEffect: {
    * the effectful accumulator function. The returned effect succeeds with the
    * final accumulator value.
    *
+   * @stability stable
    * @category running
    * @since 4.0.0
    */
@@ -11484,6 +11797,7 @@ export const runFoldEffect: {
    * the effectful accumulator function. The returned effect succeeds with the
    * final accumulator value.
    *
+   * @stability stable
    * @category running
    * @since 4.0.0
    */
@@ -11544,6 +11858,7 @@ export const runFoldEffect: {
  * await Effect.runPromise(program) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -11594,6 +11909,7 @@ export const toPull: <OutElem, OutErr, OutDone, Env>(
  * await Effect.runPromise(Effect.scoped(scopedPullEffect)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -11611,6 +11927,7 @@ export const toPullScoped = <OutElem, OutErr, OutDone, Env>(
  * queue is failed with the channel's cause. The returned effect itself
  * completes with `void`.
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -11624,6 +11941,7 @@ export const runIntoQueue: {
    * queue is failed with the channel's cause. The returned effect itself
    * completes with `void`.
    *
+   * @stability stable
    * @category destructors
    * @since 4.0.0
    */
@@ -11639,6 +11957,7 @@ export const runIntoQueue: {
    * queue is failed with the channel's cause. The returned effect itself
    * completes with `void`.
    *
+   * @stability stable
    * @category destructors
    * @since 4.0.0
    */
@@ -11678,6 +11997,7 @@ export const runIntoQueue: {
  * queue is failed with the channel's cause. The returned effect itself
  * completes with `void`.
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -11692,6 +12012,7 @@ export const runIntoQueueArray: {
    * queue is failed with the channel's cause. The returned effect itself
    * completes with `void`.
    *
+   * @stability stable
    * @category destructors
    * @since 4.0.0
    */
@@ -11708,6 +12029,7 @@ export const runIntoQueueArray: {
    * queue is failed with the channel's cause. The returned effect itself
    * completes with `void`.
    *
+   * @stability stable
    * @category destructors
    * @since 4.0.0
    */
@@ -11767,6 +12089,7 @@ export const runIntoQueueArray: {
  * await Effect.runPromise(program) // => [1, 2, 3, 4, 5]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -11801,6 +12124,7 @@ export const toQueue: {
    * await Effect.runPromise(program) // => [1, 2, 3, 4, 5]
    * ```
    *
+   * @stability stable
    * @category destructors
    * @since 2.0.0
    */
@@ -11844,6 +12168,7 @@ export const toQueue: {
    * await Effect.runPromise(program) // => [1, 2, 3, 4, 5]
    * ```
    *
+   * @stability stable
    * @category destructors
    * @since 2.0.0
    */
@@ -11898,6 +12223,7 @@ export const toQueue: {
      * await Effect.runPromise(program) // => [1, 2, 3, 4, 5]
      * ```
      *
+     * @stability stable
      * @category destructors
      * @since 2.0.0
      */
@@ -11931,6 +12257,7 @@ export const toQueue: {
      * await Effect.runPromise(program) // => [1, 2, 3, 4, 5]
      * ```
      *
+     * @stability stable
      * @category destructors
      * @since 2.0.0
      */
@@ -11953,6 +12280,7 @@ export const toQueue: {
  * completion and failure are signaled through the queue. The queue is shut down
  * when the surrounding scope closes.
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -11966,6 +12294,7 @@ export const toQueueArray: {
    * completion and failure are signaled through the queue. The queue is shut down
    * when the surrounding scope closes.
    *
+   * @stability stable
    * @category destructors
    * @since 4.0.0
    */
@@ -11988,6 +12317,7 @@ export const toQueueArray: {
    * completion and failure are signaled through the queue. The queue is shut down
    * when the surrounding scope closes.
    *
+   * @stability stable
    * @category destructors
    * @since 4.0.0
    */
@@ -12021,6 +12351,7 @@ export const toQueueArray: {
      * completion and failure are signaled through the queue. The queue is shut down
      * when the surrounding scope closes.
      *
+     * @stability stable
      * @category destructors
      * @since 4.0.0
      */
@@ -12033,6 +12364,7 @@ export const toQueueArray: {
      * completion and failure are signaled through the queue. The queue is shut down
      * when the surrounding scope closes.
      *
+     * @stability stable
      * @category destructors
      * @since 4.0.0
      */
@@ -12054,6 +12386,7 @@ export const toQueueArray: {
  * `shutdownOnEnd` indicates whether the PubSub should be shut down when the
  * channel ends. By default this is `true`.
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -12066,6 +12399,7 @@ export const toPubSub: {
    * `shutdownOnEnd` indicates whether the PubSub should be shut down when the
    * channel ends. By default this is `true`.
    *
+   * @stability stable
    * @category destructors
    * @since 2.0.0
    */
@@ -12091,6 +12425,7 @@ export const toPubSub: {
    * `shutdownOnEnd` indicates whether the PubSub should be shut down when the
    * channel ends. By default this is `true`.
    *
+   * @stability stable
    * @category destructors
    * @since 2.0.0
    */
@@ -12130,6 +12465,7 @@ export const toPubSub: {
      * `shutdownOnEnd` indicates whether the PubSub should be shut down when the
      * channel ends. By default this is `true`.
      *
+     * @stability stable
      * @category destructors
      * @since 2.0.0
      */
@@ -12149,6 +12485,7 @@ export const toPubSub: {
  * The channel's output values are published as individual PubSub messages. Use
  * `options.shutdownOnEnd` to shut down the PubSub when channel execution ends.
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -12161,6 +12498,7 @@ export const runIntoPubSub: {
    * The channel's output values are published as individual PubSub messages. Use
    * `options.shutdownOnEnd` to shut down the PubSub when channel execution ends.
    *
+   * @stability stable
    * @category destructors
    * @since 4.0.0
    */
@@ -12171,7 +12509,7 @@ export const runIntoPubSub: {
     } | undefined
   ): <OutErr, OutDone, Env>(
     self: Channel<OutElem, OutErr, OutDone, unknown, unknown, unknown, Env>
-  ) => Effect.Effect<void, never, Env>
+  ) => Effect.Effect<void, OutErr, Env>
   /**
    * Runs a channel and publishes each output element to a `PubSub`.
    *
@@ -12180,6 +12518,7 @@ export const runIntoPubSub: {
    * The channel's output values are published as individual PubSub messages. Use
    * `options.shutdownOnEnd` to shut down the PubSub when channel execution ends.
    *
+   * @stability stable
    * @category destructors
    * @since 4.0.0
    */
@@ -12189,7 +12528,7 @@ export const runIntoPubSub: {
     options?: {
       readonly shutdownOnEnd?: boolean | undefined
     } | undefined
-  ): Effect.Effect<void, never, Env>
+  ): Effect.Effect<void, OutErr, Env>
 } = dual(
   (args) => isChannel(args[0]),
   <OutElem, OutErr, OutDone, Env>(
@@ -12235,6 +12574,7 @@ const makePubSub = <A>(
  * PubSub message. `shutdownOnEnd` indicates whether the PubSub should be shut
  * down when the channel ends. By default this is `true`.
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -12249,6 +12589,7 @@ export const toPubSubArray: {
    * PubSub message. `shutdownOnEnd` indicates whether the PubSub should be shut
    * down when the channel ends. By default this is `true`.
    *
+   * @stability stable
    * @category destructors
    * @since 4.0.0
    */
@@ -12276,6 +12617,7 @@ export const toPubSubArray: {
    * PubSub message. `shutdownOnEnd` indicates whether the PubSub should be shut
    * down when the channel ends. By default this is `true`.
    *
+   * @stability stable
    * @category destructors
    * @since 4.0.0
    */
@@ -12317,6 +12659,7 @@ export const toPubSubArray: {
      * PubSub message. `shutdownOnEnd` indicates whether the PubSub should be shut
      * down when the channel ends. By default this is `true`.
      *
+     * @stability stable
      * @category destructors
      * @since 4.0.0
      */
@@ -12338,6 +12681,7 @@ export const toPubSubArray: {
  * PubSub message. Use `options.shutdownOnEnd` to shut down the PubSub when
  * channel execution ends.
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -12352,6 +12696,7 @@ export const runIntoPubSubArray: {
    * PubSub message. Use `options.shutdownOnEnd` to shut down the PubSub when
    * channel execution ends.
    *
+   * @stability stable
    * @category destructors
    * @since 4.0.0
    */
@@ -12373,6 +12718,7 @@ export const runIntoPubSubArray: {
    * PubSub message. Use `options.shutdownOnEnd` to shut down the PubSub when
    * channel execution ends.
    *
+   * @stability stable
    * @category destructors
    * @since 4.0.0
    */
@@ -12407,6 +12753,7 @@ export const runIntoPubSubArray: {
  * subscriber, including one that subscribes later, observes completion or
  * failure once it has consumed its buffered values.
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -12421,6 +12768,7 @@ export const toPubSubTake: {
    * subscriber, including one that subscribes later, observes completion or
    * failure once it has consumed its buffered values.
    *
+   * @stability stable
    * @category destructors
    * @since 4.0.0
    */
@@ -12450,6 +12798,7 @@ export const toPubSubTake: {
    * subscriber, including one that subscribes later, observes completion or
    * failure once it has consumed its buffered values.
    *
+   * @stability stable
    * @category destructors
    * @since 4.0.0
    */
@@ -12491,6 +12840,7 @@ export const toPubSubTake: {
      * subscriber, including one that subscribes later, observes completion or
      * failure once it has consumed its buffered values.
      *
+     * @stability stable
      * @category destructors
      * @since 4.0.0
      */