effect 4.0.0-beta.67 → 4.0.0-beta.68

package/src/Channel.ts

@@ -472,7 +472,7 @@ export const toTransform = <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env
  * ```
  *
  * @category constants
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const DefaultChunkSize: number = 4096
 
@@ -510,7 +510,7 @@ const asyncQueue = <A, E = never, R = never>(
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const callback = <A, E = never, R = never>(
   f: (queue: Queue.Queue<A, E | Cause.Done>) => Effect.Effect<unknown, E, R | Scope.Scope>,
@@ -629,7 +629,7 @@ export const acquireUseRelease = <A, E, R, OutElem, OutErr, OutDone, InElem, InE
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const acquireRelease: {
   /**
@@ -652,7 +652,7 @@ export const acquireRelease: {
    * ```
    *
    * @category constructors
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <Z>(release: (z: Z, e: Exit.Exit<unknown, unknown>) => Effect.Effect<unknown>): <E, R>(self: Effect.Effect<Z, E, R>) => Channel<Z, E, void, unknown, unknown, unknown, R>
   /**
@@ -675,7 +675,7 @@ export const acquireRelease: {
    * ```
    *
    * @category constructors
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <Z, E, R>(
     self: Effect.Effect<Z, E, R>,
@@ -704,7 +704,7 @@ export const acquireRelease: {
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const fromIterator = <A, L>(iterator: LazyArg<Iterator<A, L>>): Channel<A, never, L> =>
   fromPull(
@@ -730,7 +730,7 @@ export const fromIterator = <A, L>(iterator: LazyArg<Iterator<A, L>>): Channel<A
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const fromArray = <A>(array: ReadonlyArray<A>): Channel<A> =>
   fromPull(Effect.sync(() => {
@@ -752,7 +752,7 @@ export const fromArray = <A>(array: ReadonlyArray<A>): Channel<A> =>
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const fromChunk = <A>(chunk: Chunk.Chunk<A>): Channel<A> => fromArray(Chunk.toReadonlyArray(chunk))
 
@@ -800,7 +800,7 @@ export const fromChunk = <A>(chunk: Chunk.Chunk<A>): Channel<A> => fromArray(Chu
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const fromIteratorArray = <A, L>(
   iterator: LazyArg<Iterator<A, L>>,
@@ -843,7 +843,7 @@ export const fromIteratorArray = <A, L>(
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const fromIterable = <A, L>(iterable: Iterable<A, L>): Channel<A, never, L> =>
   fromIterator(() => iterable[Symbol.iterator]())
@@ -862,7 +862,7 @@ export const fromIterable = <A, L>(iterable: Iterable<A, L>): Channel<A, never,
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const fromIterableArray = <A, L>(
   iterable: Iterable<A, L>,
@@ -955,7 +955,7 @@ export const sync = <A>(evaluate: LazyArg<A>): Channel<A> => fromEffect(Effect.s
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const empty: Channel<never> = fromPull(Effect.succeed(Cause.done()))
 
@@ -1130,7 +1130,7 @@ export const failCauseSync = <E>(
  * ```
  *
  * @category constructors
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const die = (defect: unknown): Channel<never, never, never> => failCause(Cause.die(defect))
 
@@ -1261,7 +1261,7 @@ export const fromEffectTake = <A, E, Done, E2, R>(
  * ```
  *
  * @category constructors
- * @since 4.0.0
+ * @since 2.0.0
  */
 export const fromQueue = <A, E>(
   queue: Queue.Dequeue<A, E>
@@ -1318,7 +1318,7 @@ export const fromQueueArray = <A, E>(
  * Creates a channel that forwards upstream input elements, input errors, and
  * the upstream done value unchanged.
  *
- * @category Constructors
+ * @category constructors
  * @since 2.0.0
  */
 export const identity = <Elem, Err, Done>(): Channel<Elem, Err, Done, Elem, Err, Done> =>
@@ -1379,9 +1379,6 @@ export const fromSubscription = <A>(
  * arrays of values in chunks. It's useful when you want to process multiple values at once
  * for better performance.
  *
- * @param subscription - The PubSub subscription to read from
- * @param chunkSize - The maximum number of elements to read in each chunk (default: 4096)
- *
  * **Example** (Batching subscription values)
  *
  * ```ts
@@ -1487,8 +1484,6 @@ export const fromSubscriptionArray = <A>(
  * subscribing to it. The channel outputs individual values as they are published
  * to the PubSub, making it ideal for real-time streaming scenarios.
  *
- * @param pubsub - The PubSub to read from
- *
  * **Example** (Creating channels from PubSubs)
  *
  * ```ts
@@ -1571,7 +1566,7 @@ export const fromSubscriptionArray = <A>(
  * ```
  *
  * @category constructors
- * @since 4.0.0
+ * @since 2.0.0
  */
 export const fromPubSub = <A>(
   pubsub: PubSub.PubSub<A>
@@ -1584,9 +1579,6 @@ export const fromPubSub = <A>(
  * subscribing to it and collecting values into arrays. The channel outputs
  * arrays of values in chunks, making it ideal for batch processing scenarios.
  *
- * @param pubsub - The PubSub to read from
- * @param chunkSize - The maximum number of elements to collect in each array (default: 4096)
- *
  * **Example** (Batching PubSub values)
  *
  * ```ts
@@ -1808,7 +1800,7 @@ export const fromAsyncIterableArray = <A, D, E>(
  * }))
  * ```
  *
- * @category Sequencing
+ * @category sequencing
  * @since 2.0.0
  */
 export const map: {
@@ -1848,7 +1840,7 @@ export const map: {
    * }))
    * ```
    *
-   * @category Sequencing
+   * @category sequencing
    * @since 2.0.0
    */
   <OutElem, OutElem2>(f: (o: OutElem, i: number) => OutElem2): <OutErr, OutDone, InElem, InErr, InDone, Env>(
@@ -1890,7 +1882,7 @@ export const map: {
    * }))
    * ```
    *
-   * @category Sequencing
+   * @category sequencing
    * @since 2.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, OutElem2>(
@@ -1913,15 +1905,15 @@ export const map: {
 /**
  * Maps the done value of this channel using the specified function.
  *
- * @category Sequencing
- * @since 2.0.0
+ * @category sequencing
+ * @since 4.0.0
  */
 export const mapDone: {
   /**
    * Maps the done value of this channel using the specified function.
    *
-   * @category Sequencing
-   * @since 2.0.0
+   * @category sequencing
+   * @since 4.0.0
    */
   <OutDone, OutDone2>(f: (o: OutDone) => OutDone2): <OutElem, OutErr, InElem, InErr, InDone, Env>(
     self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>
@@ -1929,8 +1921,8 @@ export const mapDone: {
   /**
    * Maps the done value of this channel using the specified function.
    *
-   * @category Sequencing
-   * @since 2.0.0
+   * @category sequencing
+   * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, OutDone2>(
     self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>,
@@ -1947,15 +1939,15 @@ export const mapDone: {
 /**
  * Maps the done value of this channel using the specified effectful function.
  *
- * @category Sequencing
- * @since 2.0.0
+ * @category sequencing
+ * @since 4.0.0
  */
 export const mapDoneEffect: {
   /**
    * Maps the done value of this channel using the specified effectful function.
    *
-   * @category Sequencing
-   * @since 2.0.0
+   * @category sequencing
+   * @since 4.0.0
    */
   <OutDone, OutDone2, E, R>(f: (o: OutDone) => Effect.Effect<OutDone2, E, R>): <OutElem, OutErr, InElem, InErr, InDone, Env>(
     self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>
@@ -1963,8 +1955,8 @@ export const mapDoneEffect: {
   /**
    * Maps the done value of this channel using the specified effectful function.
    *
-   * @category Sequencing
-   * @since 2.0.0
+   * @category sequencing
+   * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, OutDone2, E, R>(
     self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>,
@@ -2803,7 +2795,7 @@ const flatMapConcurrent = <
  * ```
  *
  * @category sequencing
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const concatWith: {
   /**
@@ -2829,7 +2821,7 @@ export const concatWith: {
    * ```
    *
    * @category sequencing
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <OutDone, OutElem1, OutErr1, OutDone1, InElem1, InErr1, InDone1, Env1>(
     f: (leftover: Types.NoInfer<OutDone>) => Channel<OutElem1, OutErr1, OutDone1, InElem1, InErr1, InDone1, Env1>
@@ -2867,7 +2859,7 @@ export const concatWith: {
    * ```
    *
    * @category sequencing
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <
     OutElem,
@@ -2967,7 +2959,7 @@ export const concatWith: {
  * ```
  *
  * @category sequencing
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const concat: {
   /**
@@ -2994,7 +2986,7 @@ export const concat: {
    * ```
    *
    * @category sequencing
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <OutElem1, OutErr1, OutDone1, InElem1, InErr1, InDone1, Env1>(that: Channel<OutElem1, OutErr1, OutDone1, InElem1, InErr1, InDone1, Env1>): <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(
     self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>
@@ -3031,7 +3023,7 @@ export const concat: {
    * ```
    *
    * @category sequencing
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <
     OutElem,
@@ -3232,7 +3224,7 @@ export const combine: {
  * receives the source done value and returns the replacement channel.
  *
  * @category sequencing
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const orElseIfEmpty: {
   /**
@@ -3244,7 +3236,7 @@ export const orElseIfEmpty: {
    * receives the source done value and returns the replacement channel.
    *
    * @category sequencing
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <OutDone, OutElem1, OutErr1, OutDone1, InElem1, InErr1, InDone1, Env1>(
     f: (leftover: Types.NoInfer<OutDone>) => Channel<OutElem1, OutErr1, OutDone1, InElem1, InErr1, InDone1, Env1>
@@ -3268,7 +3260,7 @@ export const orElseIfEmpty: {
    * receives the source done value and returns the replacement channel.
    *
    * @category sequencing
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <
     OutElem,
@@ -3713,8 +3705,8 @@ export const schedule: {
  * // Outputs: 1, 2, 3 (all typed as numbers)
  * ```
  *
- * @category Filtering
- * @since 2.0.0
+ * @category filtering
+ * @since 4.0.0
  */
 export const filter: {
   /**
@@ -3742,8 +3734,8 @@ export const filter: {
    * // Outputs: 1, 2, 3 (all typed as numbers)
    * ```
    *
-   * @category Filtering
-   * @since 2.0.0
+   * @category filtering
+   * @since 4.0.0
    */
   <OutElem, B extends OutElem>(refinement: Predicate.Refinement<OutElem, B>): <OutErr, OutDone, InElem, InErr, InDone, Env>(
     self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>
@@ -3773,8 +3765,8 @@ export const filter: {
    * // Outputs: 1, 2, 3 (all typed as numbers)
    * ```
    *
-   * @category Filtering
-   * @since 2.0.0
+   * @category filtering
+   * @since 4.0.0
    */
   <OutElem>(predicate: Predicate.Predicate<OutElem>): <OutErr, OutDone, InElem, InErr, InDone, Env>(
     self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>
@@ -3804,8 +3796,8 @@ export const filter: {
    * // Outputs: 1, 2, 3 (all typed as numbers)
    * ```
    *
-   * @category Filtering
-   * @since 2.0.0
+   * @category filtering
+   * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, B extends OutElem>(
     self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>,
@@ -3836,8 +3828,8 @@ export const filter: {
    * // Outputs: 1, 2, 3 (all typed as numbers)
    * ```
    *
-   * @category Filtering
-   * @since 2.0.0
+   * @category filtering
+   * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(
     self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>,
@@ -3866,7 +3858,7 @@ export const filter: {
  * results are discarded. The source channel's errors and done value are
  * preserved.
  *
- * @category Filtering
+ * @category filtering
  * @since 4.0.0
  */
 export const filterMap: {
@@ -3877,7 +3869,7 @@ export const filterMap: {
    * results are discarded. The source channel's errors and done value are
    * preserved.
    *
-   * @category Filtering
+   * @category filtering
    * @since 4.0.0
    */
   <OutElem, B, X>(filter: Filter.Filter<OutElem, B, X>): <OutErr, OutDone, InElem, InErr, InDone, Env>(
@@ -3890,7 +3882,7 @@ export const filterMap: {
    * results are discarded. The source channel's errors and done value are
    * preserved.
    *
-   * @category Filtering
+   * @category filtering
    * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, B, X>(
@@ -3921,7 +3913,7 @@ export const filterMap: {
  * for which the predicate succeeds with `false` are discarded. Predicate
  * failures fail the returned channel.
  *
- * @category Filtering
+ * @category filtering
  * @since 4.0.0
  */
 export const filterEffect: {
@@ -3932,7 +3924,7 @@ export const filterEffect: {
    * for which the predicate succeeds with `false` are discarded. Predicate
    * failures fail the returned channel.
    *
-   * @category Filtering
+   * @category filtering
    * @since 4.0.0
    */
   <OutElem, E, R>(predicate: (a: OutElem) => Effect.Effect<boolean, E, R>): <OutErr, OutDone, InElem, InErr, InDone, Env>(
@@ -3945,7 +3937,7 @@ export const filterEffect: {
    * for which the predicate succeeds with `false` are discarded. Predicate
    * failures fail the returned channel.
    *
-   * @category Filtering
+   * @category filtering
    * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, E, R>(
@@ -3979,7 +3971,7 @@ export const filterEffect: {
  * results are discarded. Failures from the effectful filter fail the returned
  * channel.
  *
- * @category Filtering
+ * @category filtering
  * @since 4.0.0
  */
 export const filterMapEffect: {
@@ -3990,7 +3982,7 @@ export const filterMapEffect: {
    * results are discarded. Failures from the effectful filter fail the returned
    * channel.
    *
-   * @category Filtering
+   * @category filtering
    * @since 4.0.0
    */
   <OutElem, B, X, EX, RX>(filter: Filter.FilterEffect<OutElem, B, X, EX, RX>): <OutErr, OutDone, InElem, InErr, InDone, Env>(
@@ -4003,7 +3995,7 @@ export const filterMapEffect: {
    * results are discarded. Failures from the effectful filter fail the returned
    * channel.
    *
-   * @category Filtering
+   * @category filtering
    * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, B, X, EX, RX>(
@@ -4063,7 +4055,7 @@ export const filterMapEffect: {
  * // Outputs: [2, 4] (the arrays [1,3,5] and [7,9] are discarded)
  * ```
  *
- * @category Filtering
+ * @category filtering
  * @since 4.0.0
  */
 export const filterArray: {
@@ -4100,7 +4092,7 @@ export const filterArray: {
    * // Outputs: [2, 4] (the arrays [1,3,5] and [7,9] are discarded)
    * ```
    *
-   * @category Filtering
+   * @category filtering
    * @since 4.0.0
    */
   <OutElem, B extends OutElem>(refinement: Predicate.Refinement<OutElem, B>): <OutErr, OutDone, InElem, InErr, InDone, Env>(
@@ -4139,7 +4131,7 @@ export const filterArray: {
    * // Outputs: [2, 4] (the arrays [1,3,5] and [7,9] are discarded)
    * ```
    *
-   * @category Filtering
+   * @category filtering
    * @since 4.0.0
    */
   <OutElem>(predicate: Predicate.Predicate<Types.NoInfer<OutElem>>): <OutErr, OutDone, InElem, InErr, InDone, Env>(
@@ -4178,7 +4170,7 @@ export const filterArray: {
    * // Outputs: [2, 4] (the arrays [1,3,5] and [7,9] are discarded)
    * ```
    *
-   * @category Filtering
+   * @category filtering
    * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, B extends OutElem>(
@@ -4218,7 +4210,7 @@ export const filterArray: {
    * // Outputs: [2, 4] (the arrays [1,3,5] and [7,9] are discarded)
    * ```
    *
-   * @category Filtering
+   * @category filtering
    * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(
@@ -4252,7 +4244,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.
  *
- * @category Filtering
+ * @category filtering
  * @since 4.0.0
  */
 export const filterMapArray: {
@@ -4263,7 +4255,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.
    *
-   * @category Filtering
+   * @category filtering
    * @since 4.0.0
    */
   <OutElem, B, X>(filter: Filter.Filter<Types.NoInfer<OutElem>, B, X>): <OutErr, OutDone, InElem, InErr, InDone, Env>(
@@ -4276,7 +4268,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.
    *
-   * @category Filtering
+   * @category filtering
    * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, B, X>(
@@ -4312,7 +4304,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.
  *
- * @category Filtering
+ * @category filtering
  * @since 4.0.0
  */
 export const filterArrayEffect: {
@@ -4324,7 +4316,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.
    *
-   * @category Filtering
+   * @category filtering
    * @since 4.0.0
    */
   <OutElem, E, R>(
@@ -4340,7 +4332,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.
    *
-   * @category Filtering
+   * @category filtering
    * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, E, R>(
@@ -4369,7 +4361,7 @@ export const filterArrayEffect: {
  * are removed from the array. Arrays that become empty are discarded. Failures
  * from the effectful filter fail the returned channel.
  *
- * @category Filtering
+ * @category filtering
  * @since 4.0.0
  */
 export const filterMapArrayEffect: {
@@ -4381,7 +4373,7 @@ export const filterMapArrayEffect: {
    * are removed from the array. Arrays that become empty are discarded. Failures
    * from the effectful filter fail the returned channel.
    *
-   * @category Filtering
+   * @category filtering
    * @since 4.0.0
    */
   <OutElem, B, X, EX, RX>(filter: Filter.FilterEffect<Types.NoInfer<OutElem>, B, X, EX, RX>): <OutErr, OutDone, InElem, InErr, InDone, Env>(
@@ -4395,7 +4387,7 @@ export const filterMapArrayEffect: {
    * are removed from the array. Arrays that become empty are discarded. Failures
    * from the effectful filter fail the returned channel.
    *
-   * @category Filtering
+   * @category filtering
    * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, B, X, EX, RX>(
@@ -4455,8 +4447,8 @@ export const filterMapArrayEffect: {
  * )
  * ```
  *
- * @category Sequencing
- * @since 2.0.0
+ * @category sequencing
+ * @since 4.0.0
  */
 export const mapAccum: {
   /**
@@ -4494,8 +4486,8 @@ export const mapAccum: {
    * )
    * ```
    *
-   * @category Sequencing
-   * @since 2.0.0
+   * @category sequencing
+   * @since 4.0.0
    */
   <S, OutElem, B, E = never, R = never>(
     initial: LazyArg<S>,
@@ -4559,8 +4551,8 @@ export const mapAccum: {
    * )
    * ```
    *
-   * @category Sequencing
-   * @since 2.0.0
+   * @category sequencing
+   * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, S, B, E = never, R = never>(
     self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>,
@@ -4664,8 +4656,8 @@ export const mapAccum: {
  * // Outputs: "", "hello", "hello world", "hello world from", "hello world from effect"
  * ```
  *
- * @category Sequencing
- * @since 2.0.0
+ * @category sequencing
+ * @since 4.0.0
  */
 export const scan: {
   /**
@@ -4695,8 +4687,8 @@ export const scan: {
    * // Outputs: "", "hello", "hello world", "hello world from", "hello world from effect"
    * ```
    *
-   * @category Sequencing
-   * @since 2.0.0
+   * @category sequencing
+   * @since 4.0.0
    */
   <S, OutElem>(initial: S, f: (s: S, a: Types.NoInfer<OutElem>) => S): <
     OutErr,
@@ -4741,8 +4733,8 @@ export const scan: {
    * // Outputs: "", "hello", "hello world", "hello world from", "hello world from effect"
    * ```
    *
-   * @category Sequencing
-   * @since 2.0.0
+   * @category sequencing
+   * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, S>(
     self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>,
@@ -4798,8 +4790,8 @@ export const scan: {
  * )
  * ```
  *
- * @category Sequencing
- * @since 2.0.0
+ * @category sequencing
+ * @since 4.0.0
  */
 export const scanEffect: {
   /**
@@ -4844,8 +4836,8 @@ export const scanEffect: {
    * )
    * ```
    *
-   * @category Sequencing
-   * @since 2.0.0
+   * @category sequencing
+   * @since 4.0.0
    */
   <S, OutElem, E, R>(initial: S, f: (s: S, a: Types.NoInfer<OutElem>) => Effect.Effect<S, E, R>): <
     OutErr,
@@ -4905,8 +4897,8 @@ export const scanEffect: {
    * )
    * ```
    *
-   * @category Sequencing
-   * @since 2.0.0
+   * @category sequencing
+   * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, S, E, R>(
     self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>,
@@ -4971,8 +4963,8 @@ export const scanEffect: {
  * // The channel recovers gracefully from errors
  * ```
  *
- * @category Error handling
- * @since 4.0.0
+ * @category error handling
+ * @since 2.0.0
  */
 export const catchCause: {
   /**
@@ -5008,8 +5000,8 @@ export const catchCause: {
    * // The channel recovers gracefully from errors
    * ```
    *
-   * @category Error handling
-   * @since 4.0.0
+   * @category error handling
+   * @since 2.0.0
    */
   <OutErr, OutElem1, OutErr1, OutDone1, InElem1, InErr1, InDone1, Env1>(
     f: (d: Cause.Cause<OutErr>) => Channel<OutElem1, OutErr1, OutDone1, InElem1, InErr1, InDone1, Env1>
@@ -5062,8 +5054,8 @@ export const catchCause: {
    * // The channel recovers gracefully from errors
    * ```
    *
-   * @category Error handling
-   * @since 4.0.0
+   * @category error handling
+   * @since 2.0.0
    */
   <
     OutElem,
@@ -5149,7 +5141,7 @@ export const catchCause: {
  * Use this for observing failures, such as logging or metrics. If the observer
  * effect fails, that failure can fail the returned channel.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const tapCause: {
@@ -5160,7 +5152,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.
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <OutErr, A, E, R>(f: (d: Cause.Cause<OutErr>) => Effect.Effect<A, E, R>): <
@@ -5186,7 +5178,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.
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -5240,7 +5232,7 @@ export const tapCause: {
  * Catches causes of failure that match a specific filter, allowing
  * conditional error recovery based on the type of failure.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const catchCauseIf: {
@@ -5248,7 +5240,7 @@ export const catchCauseIf: {
    * Catches causes of failure that match a specific filter, allowing
    * conditional error recovery based on the type of failure.
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -5283,7 +5275,7 @@ export const catchCauseIf: {
    * Catches causes of failure that match a specific filter, allowing
    * conditional error recovery based on the type of failure.
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -5368,7 +5360,7 @@ export const catchCauseIf: {
  * and the original cause. When the filter fails, the returned channel fails
  * with the residual cause produced by the filter.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const catchCauseFilter: {
@@ -5379,7 +5371,7 @@ export const catchCauseFilter: {
    * and the original cause. When the filter fails, the returned channel fails
    * with the residual cause produced by the filter.
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -5422,7 +5414,7 @@ export const catchCauseFilter: {
    * and the original cause. When the filter fails, the returned channel fails
    * with the residual cause produced by the filter.
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -5587,7 +5579,7 @@ const catch_: {
 
 export {
   /**
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   catch_ as catch
@@ -5600,7 +5592,7 @@ export {
  * The effect is not run for normal channel completion. If the observer effect
  * fails, that failure can fail the returned channel.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const tapError: {
@@ -5611,7 +5603,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.
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <OutErr, A, E, R>(f: (d: OutErr) => Effect.Effect<A, E, R>): <
@@ -5637,7 +5629,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.
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -5702,7 +5694,7 @@ export const tapError: {
  * are handled by `orElse` when provided. Without `orElse`, non-matching errors
  * are re-failed.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const catchIf: {
@@ -5713,7 +5705,7 @@ export const catchIf: {
    * are handled by `orElse` when provided. Without `orElse`, non-matching errors
    * are re-failed.
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -5764,7 +5756,7 @@ export const catchIf: {
    * are handled by `orElse` when provided. Without `orElse`, non-matching errors
    * are re-failed.
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -5814,7 +5806,7 @@ export const catchIf: {
    * are handled by `orElse` when provided. Without `orElse`, non-matching errors
    * are re-failed.
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -5865,7 +5857,7 @@ export const catchIf: {
    * are handled by `orElse` when provided. Without `orElse`, non-matching errors
    * are re-failed.
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -5974,7 +5966,7 @@ export const catchIf: {
  * filter results are handled by `orElse` when provided. Without `orElse`,
  * failed filter results are re-failed.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const catchFilter: {
@@ -5985,7 +5977,7 @@ export const catchFilter: {
    * filter results are handled by `orElse` when provided. Without `orElse`,
    * failed filter results are re-failed.
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -6037,7 +6029,7 @@ export const catchFilter: {
    * filter results are handled by `orElse` when provided. Without `orElse`,
    * failed filter results are re-failed.
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -6151,7 +6143,7 @@ export const catchFilter: {
  * errors are handled by `orElse` when provided. Without `orElse`,
  * non-matching errors are re-failed.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const catchTag: {
@@ -6162,7 +6154,7 @@ export const catchTag: {
    * errors are handled by `orElse` when provided. Without `orElse`,
    * non-matching errors are re-failed.
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -6215,7 +6207,7 @@ export const catchTag: {
    * errors are handled by `orElse` when provided. Without `orElse`,
    * non-matching errors are re-failed.
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -6341,7 +6333,7 @@ export const catchTag: {
  * )
  * ```
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const catchReason: {
@@ -6376,7 +6368,7 @@ export const catchReason: {
    * )
    * ```
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -6459,7 +6451,7 @@ export const catchReason: {
    * )
    * ```
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -6581,14 +6573,14 @@ export const catchReason: {
 /**
  * Catches multiple reasons within a tagged error using an object of handlers.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const catchReasons: {
   /**
    * Catches multiple reasons within a tagged error using an object of handlers.
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -6665,7 +6657,7 @@ export const catchReasons: {
   /**
    * Catches multiple reasons within a tagged error using an object of handlers.
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -6791,7 +6783,7 @@ export const catchReasons: {
  * const unwrapped = channel.pipe(Channel.unwrapReason("AiError"))
  * ```
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const unwrapReason: {
@@ -6822,7 +6814,7 @@ export const unwrapReason: {
    * const unwrapped = channel.pipe(Channel.unwrapReason("AiError"))
    * ```
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -6866,7 +6858,7 @@ export const unwrapReason: {
    * const unwrapped = channel.pipe(Channel.unwrapReason("AiError"))
    * ```
    *
-   * @category Error handling
+   * @category error handling
    * @since 4.0.0
    */
   <
@@ -6923,7 +6915,7 @@ export const unwrapReason: {
  * value of the returned channel is created by applying the specified function
  * to the failure value of this channel.
  *
- * @category Error handling
+ * @category error handling
  * @since 2.0.0
  */
 export const mapError: {
@@ -6932,7 +6924,7 @@ export const mapError: {
    * value of the returned channel is created by applying the specified function
    * to the failure value of this channel.
    *
-   * @category Error handling
+   * @category error handling
    * @since 2.0.0
    */
   <OutErr, OutErr2>(f: (err: OutErr) => OutErr2): <OutElem, OutDone, InElem, InErr, InDone, Env>(
@@ -6943,7 +6935,7 @@ export const mapError: {
    * value of the returned channel is created by applying the specified function
    * to the failure value of this channel.
    *
-   * @category Error handling
+   * @category error handling
    * @since 2.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, OutErr2>(
@@ -6977,8 +6969,8 @@ export const mapError: {
  * // Any failure will now become a defect (uncaught exception)
  * ```
  *
- * @category Error handling
- * @since 4.0.0
+ * @category error handling
+ * @since 2.0.0
  */
 export const orDie = <
   OutElem,
@@ -6997,7 +6989,7 @@ export const orDie = <
  *
  * Use the `log` option to emit the full {@link Cause} when the channel fails.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const ignore: <
@@ -7052,7 +7044,7 @@ const ignoreCause_ = <
  *
  * Use the `log` option to emit the full {@link Cause} when the channel fails.
  *
- * @category Error handling
+ * @category error handling
  * @since 4.0.0
  */
 export const ignoreCause: <
@@ -7198,7 +7190,7 @@ export const retry: {
  * ```
  *
  * @category sequencing
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const switchMap: {
   /**
@@ -7231,7 +7223,7 @@ export const switchMap: {
    * ```
    *
    * @category sequencing
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <OutElem, OutElem1, OutErr1, OutDone1, InElem1, InErr1, InDone1, Env1>(
     f: (d: OutElem) => Channel<OutElem1, OutErr1, OutDone1, InElem1, InErr1, InDone1, Env1>,
@@ -7280,7 +7272,7 @@ export const switchMap: {
    * ```
    *
    * @category sequencing
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <
     OutElem,
@@ -7666,7 +7658,7 @@ export const mergeAll: {
  * ```
  *
  * @category models
- * @since 2.0.0
+ * @since 4.0.0
  */
 export type HaltStrategy = "left" | "right" | "both" | "either"
 
@@ -7697,7 +7689,7 @@ export type HaltStrategy = "left" | "right" | "both" | "either"
  * ```
  *
  * @category utils
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const merge: {
   /**
@@ -7727,7 +7719,7 @@ export const merge: {
    * ```
    *
    * @category utils
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <OutElem1, OutErr1, OutDone1, InElem1, InErr1, InDone1, Env1>(
     right: Channel<OutElem1, OutErr1, OutDone1, InElem1, InErr1, InDone1, Env1>,
@@ -7772,7 +7764,7 @@ export const merge: {
    * ```
    *
    * @category utils
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <
     OutElem,
@@ -7863,7 +7855,7 @@ export const merge: {
      * ```
      *
      * @category utils
-     * @since 2.0.0
+     * @since 4.0.0
      */
     OutElem | OutElem1, /**
      * Returns a new channel, which is the merge of this channel and the specified
@@ -7892,7 +7884,7 @@ export const merge: {
      * ```
      *
      * @category utils
-     * @since 2.0.0
+     * @since 4.0.0
      */
     OutErr | OutErr1 | Cause.Done<OutDone | OutDone1>>(0)
     yield* Scope.addFinalizer(forkedScope, Queue.shutdown(queue))
@@ -8131,8 +8123,9 @@ export const splitLines = <Err, Done>(): Channel<
 /**
  * Decodes incoming `Uint8Array` chunks into strings using `TextDecoder`.
  *
- * Each `Uint8Array` inside an emitted array is decoded independently. The
- * optional `encoding` and `options` are passed to `TextDecoder`.
+ * Input chunks are decoded with streaming enabled so multi-byte characters may
+ * span `Uint8Array` boundaries. The optional `encoding` and `options` are
+ * passed to `TextDecoder`.
  *
  * @category String manipulation
  * @since 4.0.0
@@ -8148,7 +8141,8 @@ export const decodeText = <Err, Done>(encoding?: string, options?: TextDecoderOp
   fromTransform((upstream, _scope) =>
     Effect.sync(() => {
       const decoder = new TextDecoder(encoding, options)
-      return Effect.map(upstream, Arr.map((line) => decoder.decode(line)))
+      const streamOptions = { stream: true }
+      return Effect.map(upstream, Arr.map((line) => decoder.decode(line, streamOptions)))
     })
   )
 
@@ -8652,7 +8646,7 @@ export const buffer: {
  * buffering up to `capacity` elements in a queue.
  *
  * @category Buffering
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const bufferArray: {
   /**
@@ -8660,7 +8654,7 @@ export const bufferArray: {
    * buffering up to `capacity` elements in a queue.
    *
    * @category Buffering
-   * @since 2.0.0
+   * @since 4.0.0
    */
   (
     options: { readonly capacity: "unbounded" } | {
@@ -8675,7 +8669,7 @@ export const bufferArray: {
    * buffering up to `capacity` elements in a queue.
    *
    * @category Buffering
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(
     self: Channel<Arr.NonEmptyReadonlyArray<OutElem>, OutErr, OutDone, InElem, InErr, InDone, Env>,
@@ -8698,14 +8692,14 @@ export const bufferArray: {
      * buffering up to `capacity` elements in a queue.
      *
      * @category Buffering
-     * @since 2.0.0
+     * @since 4.0.0
      */
     OutElem, /**
      * Allows a faster producer to progress independently of a slower consumer by
      * buffering up to `capacity` elements in a queue.
      *
      * @category Buffering
-     * @since 2.0.0
+     * @since 4.0.0
      */
     OutErr | Cause.Done<OutDone>>({
       capacity: options.capacity === "unbounded" ? undefined : options.capacity,
@@ -9248,7 +9242,7 @@ const runWith = <
 /**
  * Create a channel from the specified services.
  *
- * @category Services
+ * @category services
  * @since 2.0.0
  */
 export const contextWith = <Env, OutElem, OutErr, OutDone, InElem, InErr, InDone, Env2>(
@@ -9262,16 +9256,16 @@ 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.
  *
- * @category Services
- * @since 4.0.0
+ * @category services
+ * @since 2.0.0
  */
 export const provideContext: {
   /**
    * Provides a `Context` to the channel, removing the corresponding service
    * requirements from the returned channel.
    *
-   * @category Services
-   * @since 4.0.0
+   * @category services
+   * @since 2.0.0
    */
   <R2>(context: Context.Context<R2>): <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(
     self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>
@@ -9280,8 +9274,8 @@ export const provideContext: {
    * Provides a `Context` to the channel, removing the corresponding service
    * requirements from the returned channel.
    *
-   * @category Services
-   * @since 4.0.0
+   * @category services
+   * @since 2.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, R2>(
     self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>,
@@ -9302,16 +9296,16 @@ export const provideContext: {
  * Provides a concrete service for a context key, removing that service
  * requirement from the returned channel.
  *
- * @category Services
- * @since 4.0.0
+ * @category services
+ * @since 2.0.0
  */
 export const provideService: {
   /**
    * Provides a concrete service for a context key, removing that service
    * requirement from the returned channel.
    *
-   * @category Services
-   * @since 4.0.0
+   * @category services
+   * @since 2.0.0
    */
   <I, S>(key: Context.Key<I, S>, service: NoInfer<S>): <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(
     self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>
@@ -9320,8 +9314,8 @@ export const provideService: {
    * Provides a concrete service for a context key, removing that service
    * requirement from the returned channel.
    *
-   * @category Services
-   * @since 4.0.0
+   * @category services
+   * @since 2.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, I, S>(
     self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>,
@@ -9347,7 +9341,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.
  *
- * @category Services
+ * @category services
  * @since 4.0.0
  */
 export const provideServiceEffect: {
@@ -9358,7 +9352,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.
    *
-   * @category Services
+   * @category services
    * @since 4.0.0
    */
   <I, S, ES, RS>(key: Context.Key<I, S>, service: Effect.Effect<NoInfer<S>, ES, RS>): <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(
@@ -9371,7 +9365,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.
    *
-   * @category Services
+   * @category services
    * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, I, S, ES, RS>(
@@ -9399,7 +9393,7 @@ export const provideServiceEffect: {
  * builds the layer in the channel scope. Use `options.local` to build a fresh
  * layer instance for this provision.
  *
- * @category Services
+ * @category services
  * @since 4.0.0
  */
 export const provide: {
@@ -9411,7 +9405,7 @@ export const provide: {
    * builds the layer in the channel scope. Use `options.local` to build a fresh
    * layer instance for this provision.
    *
-   * @category Services
+   * @category services
    * @since 4.0.0
    */
   <A, E = never, R = never>(
@@ -9430,7 +9424,7 @@ export const provide: {
    * builds the layer in the channel scope. Use `options.local` to build a fresh
    * layer instance for this provision.
    *
-   * @category Services
+   * @category services
    * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, A, E = never, R = never>(
@@ -9467,8 +9461,8 @@ export const provide: {
  * provide to the channel. The returned channel requires the services needed to
  * build that context.
  *
- * @category Services
- * @since 2.0.0
+ * @category services
+ * @since 4.0.0
  */
 export const updateContext: {
   /**
@@ -9478,8 +9472,8 @@ export const updateContext: {
    * provide to the channel. The returned channel requires the services needed to
    * build that context.
    *
-   * @category Services
-   * @since 2.0.0
+   * @category services
+   * @since 4.0.0
    */
   <Env, R2>(f: (context: Context.Context<R2>) => Context.Context<Env>): <OutElem, OutErr, OutDone, InElem, InErr, InDone>(
     self: Channel<OutElem, InElem, OutErr, InErr, OutDone, InDone, Env>
@@ -9491,8 +9485,8 @@ export const updateContext: {
    * provide to the channel. The returned channel requires the services needed to
    * build that context.
    *
-   * @category Services
-   * @since 2.0.0
+   * @category services
+   * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, R2>(
     self: Channel<OutElem, InElem, OutErr, InErr, OutDone, InDone, Env>,
@@ -9515,7 +9509,7 @@ export const updateContext: {
  * The existing service is read from the context. The updated service is
  * provided to the channel under the same key.
  *
- * @category Services
+ * @category services
  * @since 2.0.0
  */
 export const updateService: {
@@ -9525,7 +9519,7 @@ export const updateService: {
    * The existing service is read from the context. The updated service is
    * provided to the channel under the same key.
    *
-   * @category Services
+   * @category services
    * @since 2.0.0
    */
   <I, S>(key: Context.Key<I, S>, f: (service: NoInfer<S>) => S): <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(
@@ -9537,7 +9531,7 @@ export const updateService: {
    * The existing service is read from the context. The updated service is
    * provided to the channel under the same key.
    *
-   * @category Services
+   * @category services
    * @since 2.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, I, S>(
@@ -9563,8 +9557,8 @@ 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.
  *
- * @category Tracing
- * @since 4.0.0
+ * @category tracing
+ * @since 2.0.0
  */
 export const withSpan: {
   /**
@@ -9573,8 +9567,8 @@ 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.
    *
-   * @category Tracing
-   * @since 4.0.0
+   * @category tracing
+   * @since 2.0.0
    */
   (name: string, options?: SpanOptions): <OutElem, OutErr, OutDone, InElem, InErr, InDone, R>(
     self: Channel<OutElem, InElem, OutErr, InErr, OutDone, InDone, R>
@@ -9585,8 +9579,8 @@ 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.
    *
-   * @category Tracing
-   * @since 4.0.0
+   * @category tracing
+   * @since 2.0.0
    */
   <OutElem, OutErr, OutDone, InElem, InErr, InDone, R>(
     self: Channel<OutElem, InElem, OutErr, InErr, OutDone, InDone, R>,
@@ -9882,7 +9876,7 @@ export const bindTo: {
  * ```
  *
  * @category execution
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const runCount = <OutElem, OutErr, OutDone, Env>(
   self: Channel<OutElem, OutErr, OutDone, unknown, unknown, unknown, Env>
@@ -9945,7 +9939,7 @@ export const runDrain = <OutElem, OutErr, OutDone, Env>(
  * ```
  *
  * @category execution
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const runForEach: {
   /**
@@ -9973,7 +9967,7 @@ export const runForEach: {
    * ```
    *
    * @category execution
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <OutElem, EX, RX>(f: (o: OutElem) => Effect.Effect<void, EX, RX>): <OutErr, OutDone, Env>(
     self: Channel<OutElem, OutErr, OutDone, unknown, unknown, unknown, Env>
@@ -10003,7 +9997,7 @@ export const runForEach: {
    * ```
    *
    * @category execution
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, Env, EX, RX>(
     self: Channel<OutElem, OutErr, OutDone, unknown, unknown, unknown, Env>,
@@ -10026,7 +10020,7 @@ export const runForEach: {
  * consumption early. The returned effect completes with `void`.
  *
  * @category execution
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const runForEachWhile: {
   /**
@@ -10037,7 +10031,7 @@ export const runForEachWhile: {
    * consumption early. The returned effect completes with `void`.
    *
    * @category execution
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <OutElem, EX, RX>(f: (o: OutElem) => Effect.Effect<boolean, EX, RX>): <OutErr, OutDone, Env>(
     self: Channel<OutElem, OutErr, OutDone, unknown, unknown, unknown, Env>
@@ -10050,7 +10044,7 @@ export const runForEachWhile: {
    * consumption early. The returned effect completes with `void`.
    *
    * @category execution
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, Env, EX, RX>(
     self: Channel<OutElem, OutErr, OutDone, unknown, unknown, unknown, Env>,
@@ -10120,7 +10114,7 @@ export const runDone = <OutElem, OutErr, OutDone, Env>(
  * channel completes without emitting output.
  *
  * @category execution
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const runHead = <OutElem, OutErr, OutDone, Env>(
   self: Channel<OutElem, OutErr, OutDone, unknown, unknown, unknown, Env>
@@ -10145,7 +10139,7 @@ export const runHead = <OutElem, OutErr, OutDone, Env>(
  * channel completes without emitting output.
  *
  * @category execution
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const runLast = <OutElem, OutErr, OutDone, Env>(
   self: Channel<OutElem, OutErr, OutDone, unknown, unknown, unknown, Env>
@@ -10189,7 +10183,7 @@ export const runLast = <OutElem, OutErr, OutDone, Env>(
  * ```
  *
  * @category execution
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const runFold: {
   /**
@@ -10214,7 +10208,7 @@ export const runFold: {
    * ```
    *
    * @category execution
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <Z, OutElem>(initial: LazyArg<Z>, f: (acc: Z, o: OutElem) => Z): <OutErr, OutDone, Env>(
     self: Channel<OutElem, OutErr, OutDone, unknown, unknown, unknown, Env>
@@ -10241,7 +10235,7 @@ export const runFold: {
    * ```
    *
    * @category execution
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, Env, Z>(
     self: Channel<OutElem, OutErr, OutDone, unknown, unknown, unknown, Env>,
@@ -10277,7 +10271,7 @@ export const runFold: {
  * final accumulator value.
  *
  * @category execution
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const runFoldEffect: {
   /**
@@ -10288,7 +10282,7 @@ export const runFoldEffect: {
    * final accumulator value.
    *
    * @category execution
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <OutElem, Z, E, R>(initial: LazyArg<Z>, f: (acc: Z, o: OutElem) => Effect.Effect<Z, E, R>): <OutErr, OutDone, Env>(
     self: Channel<OutElem, OutErr, OutDone, unknown, unknown, unknown, Env>
@@ -10301,7 +10295,7 @@ export const runFoldEffect: {
    * final accumulator value.
    *
    * @category execution
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, Env, Z, E, R>(
     self: Channel<OutElem, OutErr, OutDone, unknown, unknown, unknown, Env>,
@@ -10359,7 +10353,7 @@ export const runFoldEffect: {
  * // Use the Pull to manually consume elements
  * ```
  *
- * @category Destructors
+ * @category destructors
  * @since 2.0.0
  */
 export const toPull: <OutElem, OutErr, OutDone, Env>(
@@ -10408,7 +10402,7 @@ export const toPull: <OutElem, OutErr, OutDone, Env>(
  * })
  * ```
  *
- * @category Destructors
+ * @category destructors
  * @since 4.0.0
  */
 export const toPullScoped = <OutElem, OutErr, OutDone, Env>(
@@ -10423,7 +10417,7 @@ export const toPullScoped = <OutElem, OutErr, OutDone, Env>(
  * queue is failed with the channel's cause. The returned effect itself
  * completes with `void`.
  *
- * @category Destructors
+ * @category destructors
  * @since 4.0.0
  */
 export const runIntoQueue: {
@@ -10434,7 +10428,7 @@ export const runIntoQueue: {
    * queue is failed with the channel's cause. The returned effect itself
    * completes with `void`.
    *
-   * @category Destructors
+   * @category destructors
    * @since 4.0.0
    */
   <OutElem, OutErr>(queue: Queue.Queue<OutElem, OutErr | Cause.Done>): <OutDone, Env>(
@@ -10447,7 +10441,7 @@ export const runIntoQueue: {
    * queue is failed with the channel's cause. The returned effect itself
    * completes with `void`.
    *
-   * @category Destructors
+   * @category destructors
    * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, Env>(
@@ -10484,7 +10478,7 @@ export const runIntoQueue: {
  * queue is failed with the channel's cause. The returned effect itself
  * completes with `void`.
  *
- * @category Destructors
+ * @category destructors
  * @since 4.0.0
  */
 export const runIntoQueueArray: {
@@ -10496,7 +10490,7 @@ export const runIntoQueueArray: {
    * queue is failed with the channel's cause. The returned effect itself
    * completes with `void`.
    *
-   * @category Destructors
+   * @category destructors
    * @since 4.0.0
    */
   <OutElem, OutErr>(queue: Queue.Queue<OutElem, OutErr | Cause.Done>): <OutDone, Env>(
@@ -10510,7 +10504,7 @@ export const runIntoQueueArray: {
    * queue is failed with the channel's cause. The returned effect itself
    * completes with `void`.
    *
-   * @category Destructors
+   * @category destructors
    * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, Env>(
@@ -10566,8 +10560,8 @@ export const runIntoQueueArray: {
  * // Multiple consumers can read from the queue
  * ```
  *
- * @category Destructors
- * @since 4.0.0
+ * @category destructors
+ * @since 2.0.0
  */
 export const toQueue: {
   /**
@@ -10597,8 +10591,8 @@ export const toQueue: {
    * // Multiple consumers can read from the queue
    * ```
    *
-   * @category Destructors
-   * @since 4.0.0
+   * @category destructors
+   * @since 2.0.0
    */
   (
     options: {
@@ -10637,8 +10631,8 @@ export const toQueue: {
    * // Multiple consumers can read from the queue
    * ```
    *
-   * @category Destructors
-   * @since 4.0.0
+   * @category destructors
+   * @since 2.0.0
    */
   <OutElem, OutErr, OutDone, Env>(
     self: Channel<OutElem, OutErr, OutDone, unknown, unknown, unknown, Env>,
@@ -10688,8 +10682,8 @@ export const toQueue: {
      * // Multiple consumers can read from the queue
      * ```
      *
-     * @category Destructors
-     * @since 4.0.0
+     * @category destructors
+     * @since 2.0.0
      */
     OutElem, /**
      * Creates a scoped queue and forks the channel to feed it for concurrent
@@ -10718,8 +10712,8 @@ export const toQueue: {
      * // Multiple consumers can read from the queue
      * ```
      *
-     * @category Destructors
-     * @since 4.0.0
+     * @category destructors
+     * @since 2.0.0
      */
     OutErr | Cause.Done>({
       capacity: typeof options.capacity === "number" ? options.capacity : undefined,
@@ -10738,7 +10732,7 @@ export const toQueue: {
  * completion and failure are signaled through the queue. The queue is shut down
  * when the surrounding scope closes.
  *
- * @category Destructors
+ * @category destructors
  * @since 4.0.0
  */
 export const toQueueArray: {
@@ -10749,7 +10743,7 @@ export const toQueueArray: {
    * completion and failure are signaled through the queue. The queue is shut down
    * when the surrounding scope closes.
    *
-   * @category Destructors
+   * @category destructors
    * @since 4.0.0
    */
   (
@@ -10769,7 +10763,7 @@ export const toQueueArray: {
    * completion and failure are signaled through the queue. The queue is shut down
    * when the surrounding scope closes.
    *
-   * @category Destructors
+   * @category destructors
    * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, Env>(
@@ -10800,7 +10794,7 @@ export const toQueueArray: {
      * completion and failure are signaled through the queue. The queue is shut down
      * when the surrounding scope closes.
      *
-     * @category Destructors
+     * @category destructors
      * @since 4.0.0
      */
     OutElem, /**
@@ -10810,7 +10804,7 @@ export const toQueueArray: {
      * completion and failure are signaled through the queue. The queue is shut down
      * when the surrounding scope closes.
      *
-     * @category Destructors
+     * @category destructors
      * @since 4.0.0
      */
     OutErr | Cause.Done>({
@@ -10829,8 +10823,8 @@ export const toQueueArray: {
  * `shutdownOnEnd` indicates whether the PubSub should be shut down when the
  * channel ends. By default this is `true`.
  *
- * @category Destructors
- * @since 4.0.0
+ * @category destructors
+ * @since 2.0.0
  */
 export const toPubSub: {
   /**
@@ -10839,8 +10833,8 @@ export const toPubSub: {
    * `shutdownOnEnd` indicates whether the PubSub should be shut down when the
    * channel ends. By default this is `true`.
    *
-   * @category Destructors
-   * @since 4.0.0
+   * @category destructors
+   * @since 2.0.0
    */
   (
     options: {
@@ -10862,8 +10856,8 @@ export const toPubSub: {
    * `shutdownOnEnd` indicates whether the PubSub should be shut down when the
    * channel ends. By default this is `true`.
    *
-   * @category Destructors
-   * @since 4.0.0
+   * @category destructors
+   * @since 2.0.0
    */
   <OutElem, OutErr, OutDone, Env>(
     self: Channel<OutElem, OutErr, OutDone, unknown, unknown, unknown, Env>,
@@ -10899,8 +10893,8 @@ export const toPubSub: {
      * `shutdownOnEnd` indicates whether the PubSub should be shut down when the
      * channel ends. By default this is `true`.
      *
-     * @category Destructors
-     * @since 4.0.0
+     * @category destructors
+     * @since 2.0.0
      */
     OutElem>(options)
     yield* Effect.forkScoped(runIntoPubSub(self, pubsub, {
@@ -10916,7 +10910,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.
  *
- * @category Destructors
+ * @category destructors
  * @since 4.0.0
  */
 export const runIntoPubSub: {
@@ -10926,7 +10920,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.
    *
-   * @category Destructors
+   * @category destructors
    * @since 4.0.0
    */
   <OutElem>(
@@ -10943,7 +10937,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.
    *
-   * @category Destructors
+   * @category destructors
    * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, Env>(
@@ -10996,7 +10990,7 @@ const makePubSub = <A>(
  * PubSub message. `shutdownOnEnd` indicates whether the PubSub should be shut
  * down when the channel ends. By default this is `true`.
  *
- * @category Destructors
+ * @category destructors
  * @since 4.0.0
  */
 export const toPubSubArray: {
@@ -11008,7 +11002,7 @@ export const toPubSubArray: {
    * PubSub message. `shutdownOnEnd` indicates whether the PubSub should be shut
    * down when the channel ends. By default this is `true`.
    *
-   * @category Destructors
+   * @category destructors
    * @since 4.0.0
    */
   (
@@ -11033,7 +11027,7 @@ export const toPubSubArray: {
    * PubSub message. `shutdownOnEnd` indicates whether the PubSub should be shut
    * down when the channel ends. By default this is `true`.
    *
-   * @category Destructors
+   * @category destructors
    * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, Env>(
@@ -11072,7 +11066,7 @@ export const toPubSubArray: {
      * PubSub message. `shutdownOnEnd` indicates whether the PubSub should be shut
      * down when the channel ends. By default this is `true`.
      *
-     * @category Destructors
+     * @category destructors
      * @since 4.0.0
      */
     OutElem>(options)
@@ -11091,7 +11085,7 @@ export const toPubSubArray: {
  * PubSub message. Use `options.shutdownOnEnd` to shut down the PubSub when
  * channel execution ends.
  *
- * @category Destructors
+ * @category destructors
  * @since 4.0.0
  */
 export const runIntoPubSubArray: {
@@ -11103,7 +11097,7 @@ export const runIntoPubSubArray: {
    * PubSub message. Use `options.shutdownOnEnd` to shut down the PubSub when
    * channel execution ends.
    *
-   * @category Destructors
+   * @category destructors
    * @since 4.0.0
    */
   <OutElem>(
@@ -11122,7 +11116,7 @@ export const runIntoPubSubArray: {
    * PubSub message. Use `options.shutdownOnEnd` to shut down the PubSub when
    * channel execution ends.
    *
-   * @category Destructors
+   * @category destructors
    * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, Env>(
@@ -11153,7 +11147,7 @@ export const runIntoPubSubArray: {
  * channel ends, its final `Exit` is published so subscribers can observe
  * completion or failure.
  *
- * @category Destructors
+ * @category destructors
  * @since 4.0.0
  */
 export const toPubSubTake: {
@@ -11164,7 +11158,7 @@ export const toPubSubTake: {
    * channel ends, its final `Exit` is published so subscribers can observe
    * completion or failure.
    *
-   * @category Destructors
+   * @category destructors
    * @since 4.0.0
    */
   (
@@ -11190,7 +11184,7 @@ export const toPubSubTake: {
    * channel ends, its final `Exit` is published so subscribers can observe
    * completion or failure.
    *
-   * @category Destructors
+   * @category destructors
    * @since 4.0.0
    */
   <OutElem, OutErr, OutDone, Env>(
@@ -11228,7 +11222,7 @@ export const toPubSubTake: {
      * channel ends, its final `Exit` is published so subscribers can observe
      * completion or failure.
      *
-     * @category Destructors
+     * @category destructors
      * @since 4.0.0
      */
     Take.Take<OutElem, OutErr, OutDone>>(options)