effect 4.0.0-beta.73 → 4.0.0-beta.74

package/dist/Channel.d.ts

@@ -2408,7 +2408,7 @@ export declare const flatten: <OutElem, OutErr, OutDone, InElem, InErr, InDone,
  * // Outputs: 1, 2, 3, 4, 5, 6, 7, 8, 9
  * ```
  *
- * @category utils
+ * @category transforming
  * @since 4.0.0
  */
 export declare const flattenArray: <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(self: Channel<ReadonlyArray<OutElem>, OutErr, OutDone, InElem, InErr, InDone, Env>) => Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>;
@@ -2421,7 +2421,7 @@ export declare const flattenArray: <OutElem, OutErr, OutDone, InElem, InErr, InD
  * Output `Take` values are emitted as non-empty arrays. Failed `Take` values
  * fail the returned channel. Done `Take` values complete the returned channel.
  *
- * @category utils
+ * @category transforming
  * @since 4.0.0
  */
 export declare const flattenTake: <OutElem, OutErr, OutDone, OutErr2, OutDone2, InElem, InErr, InDone, Env>(self: Channel<Take.Take<OutElem, OutErr, OutDone>, OutErr2, OutDone2, InElem, InErr, InDone, Env>) => Channel<Arr.NonEmptyReadonlyArray<OutElem>, OutErr | OutErr2, OutDone, InElem, InErr, InDone, Env>;
@@ -2451,21 +2451,21 @@ export declare const drain: <OutElem, OutErr, OutDone, InElem, InErr, InDone, En
 /**
  * Repeats this channel according to the provided schedule.
  *
- * @category utils
+ * @category repetition
  * @since 4.0.0
  */
 export declare const repeat: {
     /**
      * Repeats this channel according to the provided schedule.
      *
-     * @category utils
+     * @category repetition
      * @since 4.0.0
      */
     <SO, OutDone, SE, SR>(schedule: Schedule.Schedule<SO, Types.NoInfer<OutDone>, SE, SR> | (($: <SO, SE, SR>(_: Schedule.Schedule<SO, NoInfer<OutDone>, SE, SR>) => Schedule.Schedule<SO, OutDone, SE, SR>) => Schedule.Schedule<SO, Types.NoInfer<OutDone>, SE, SR>)): <OutElem, OutErr, InElem, InErr, InDone, Env>(self: Channel<OutElem, OutErr | SE, OutDone, InElem, InErr, InDone, Env | SR>) => Channel<OutElem, OutErr | SE, OutDone, InElem, InErr, InDone, Env | SR>;
     /**
      * Repeats this channel according to the provided schedule.
      *
-     * @category utils
+     * @category repetition
      * @since 4.0.0
      */
     <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, SO, SE, SR>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>, schedule: Schedule.Schedule<SO, OutDone, SE, SR> | (($: <SO, SE, SR>(_: Schedule.Schedule<SO, NoInfer<OutDone>, SE, SR>) => Schedule.Schedule<SO, OutDone, SE, SR>) => Schedule.Schedule<SO, Types.NoInfer<OutDone>, SE, SR>)): Channel<OutElem, OutErr | SE, OutDone, InElem, InErr, InDone, Env | SR>;
@@ -2473,7 +2473,7 @@ export declare const repeat: {
 /**
  * Repeats this channel forever.
  *
- * @category utils
+ * @category repetition
  * @since 4.0.0
  */
 export declare const forever: <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>) => Channel<OutElem, OutErr, never, InElem, InErr, InDone, Env>;
@@ -2488,7 +2488,7 @@ export declare const forever: <OutElem, OutErr, OutDone, InElem, InErr, InDone,
  * fails. If the schedule finishes, the returned channel completes with the
  * schedule output.
  *
- * @category utils
+ * @category sequencing
  * @since 4.0.0
  */
 export declare const schedule: {
@@ -2503,7 +2503,7 @@ export declare const schedule: {
      * fails. If the schedule finishes, the returned channel completes with the
      * schedule output.
      *
-     * @category utils
+     * @category sequencing
      * @since 4.0.0
      */
     <SO, OutElem, SE, SR>(schedule: Schedule.Schedule<SO, Types.NoInfer<OutElem>, SE, SR>): <OutErr, OutDone, InElem, InErr, InDone, Env>(self: Channel<OutElem, OutErr | SE, OutDone, InElem, InErr, InDone, Env | SR>) => Channel<OutElem, OutErr | SE, OutDone | SO, InElem, InErr, InDone, Env | SR>;
@@ -2518,7 +2518,7 @@ export declare const schedule: {
      * fails. If the schedule finishes, the returned channel completes with the
      * schedule output.
      *
-     * @category utils
+     * @category sequencing
      * @since 4.0.0
      */
     <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, SO, SE, SR>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>, schedule: Schedule.Schedule<SO, OutElem, SE, SR>): Channel<OutElem, OutErr | SE, OutDone | SO, InElem, InErr, InDone, Env | SR>;
@@ -4430,7 +4430,7 @@ export declare const ignoreCause: <Arg extends Channel<any, any, any, any, any,
  * Returns a new channel that retries this channel according to the specified
  * schedule whenever it fails.
  *
- * @category utils
+ * @category error handling
  * @since 4.0.0
  */
 export declare const retry: {
@@ -4438,7 +4438,7 @@ export declare const retry: {
      * Returns a new channel that retries this channel according to the specified
      * schedule whenever it fails.
      *
-     * @category utils
+     * @category error handling
      * @since 4.0.0
      */
     <SO, OutErr, SE, SR>(schedule: Schedule.Schedule<SO, Types.NoInfer<OutErr>, SE, SR> | (($: <SO, SE, SR>(_: Schedule.Schedule<SO, Types.NoInfer<OutErr>, SE, SR>) => Schedule.Schedule<SO, OutErr, SE, SR>) => Schedule.Schedule<SO, Types.NoInfer<OutErr>, SE, SR>)): <OutElem, OutDone, InElem, InErr, InDone, Env>(self: Channel<OutElem, OutErr | SE, OutDone, InElem, InErr, InDone, Env | SR>) => Channel<OutElem, OutErr | SE, OutDone, InElem, InErr, InDone, Env | SR>;
@@ -4446,7 +4446,7 @@ export declare const retry: {
      * Returns a new channel that retries this channel according to the specified
      * schedule whenever it fails.
      *
-     * @category utils
+     * @category error handling
      * @since 4.0.0
      */
     <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, SO, SE, SR>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>, schedule: Schedule.Schedule<SO, OutErr, SE, SR> | (($: <SO, SE, SR>(_: Schedule.Schedule<SO, Types.NoInfer<OutErr>, SE, SR>) => Schedule.Schedule<SO, OutErr, SE, SR>) => Schedule.Schedule<SO, Types.NoInfer<OutErr>, SE, SR>)): Channel<OutElem, OutErr | SE, OutDone, InElem, InErr, InDone, Env | SR>;
@@ -4591,7 +4591,7 @@ export declare const switchMap: {
  * // Outputs: 1, 2, 3, 4, 5, 6 (order may vary due to concurrency)
  * ```
  *
- * @category utils
+ * @category combining
  * @since 2.0.0
  */
 export declare const mergeAll: {
@@ -4623,7 +4623,7 @@ export declare const mergeAll: {
      * // Outputs: 1, 2, 3, 4, 5, 6 (order may vary due to concurrency)
      * ```
      *
-     * @category utils
+     * @category combining
      * @since 2.0.0
      */
     (options: {
@@ -4659,7 +4659,7 @@ export declare const mergeAll: {
      * // Outputs: 1, 2, 3, 4, 5, 6 (order may vary due to concurrency)
      * ```
      *
-     * @category utils
+     * @category combining
      * @since 2.0.0
      */
     <OutElem, OutErr1, OutDone1, InElem1, InErr1, InDone1, Env1, OutErr, OutDone, InElem, InErr, InDone, Env>(channels: Channel<Channel<OutElem, OutErr1, OutDone1, InElem1, InErr1, InDone1, Env1>, OutErr, OutDone, InElem, InErr, InDone, Env>, options: {
@@ -4713,7 +4713,7 @@ export type HaltStrategy = "left" | "right" | "both" | "either";
  * // Order may vary: 1, "a", 2, "b", 3, "c"
  * ```
  *
- * @category utils
+ * @category combining
  * @since 4.0.0
  */
 export declare const merge: {
@@ -4743,7 +4743,7 @@ export declare const merge: {
      * // Order may vary: 1, "a", 2, "b", 3, "c"
      * ```
      *
-     * @category utils
+     * @category combining
      * @since 4.0.0
      */
     <OutElem1, OutErr1, OutDone1, InElem1, InErr1, InDone1, Env1>(right: Channel<OutElem1, OutErr1, OutDone1, InElem1, InErr1, InDone1, Env1>, options?: {
@@ -4775,7 +4775,7 @@ export declare const merge: {
      * // Order may vary: 1, "a", 2, "b", 3, "c"
      * ```
      *
-     * @category utils
+     * @category combining
      * @since 4.0.0
      */
     <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, OutElem1, OutErr1, OutDone1, InElem1, InErr1, InDone1, Env1>(left: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>, right: Channel<OutElem1, OutErr1, OutDone1, InElem1, InErr1, InDone1, Env1>, options?: {
@@ -4791,7 +4791,7 @@ export declare 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.
  *
- * @category utils
+ * @category combining
  * @since 4.0.0
  */
 export declare const mergeEffect: {
@@ -4804,7 +4804,7 @@ export declare 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.
      *
-     * @category utils
+     * @category combining
      * @since 4.0.0
      */
     <X, E, R>(effect: Effect.Effect<X, E, R>): <OutElem, OutDone, OutErr, InElem, InErr, InDone, Env>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>) => Channel<OutElem, OutErr | E, OutDone, InElem, InErr, InDone, Env | R>;
@@ -4817,7 +4817,7 @@ export declare 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.
      *
-     * @category utils
+     * @category combining
      * @since 4.0.0
      */
     <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, X, E, R>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>, effect: Effect.Effect<X, E, R>): Channel<OutElem, OutErr | E, OutDone, InElem, InErr, InDone, Env | R>;
@@ -4901,7 +4901,7 @@ export declare const encodeText: <Err, Done>() => Channel<Arr.NonEmptyReadonlyAr
  * // Outputs: 2, 4, 6
  * ```
  *
- * @category utils
+ * @category sequencing
  * @since 2.0.0
  */
 export declare const pipeTo: {
@@ -4930,7 +4930,7 @@ export declare const pipeTo: {
      * // Outputs: 2, 4, 6
      * ```
      *
-     * @category utils
+     * @category sequencing
      * @since 2.0.0
      */
     <OutElem2, OutErr2, OutDone2, OutElem, OutErr, OutDone, Env2>(that: Channel<OutElem2, OutErr2, OutDone2, OutElem, OutErr, OutDone, Env2>): <InElem, InErr, InDone, Env>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>) => Channel<OutElem2, OutErr2, OutDone2, InElem, InErr, InDone, Env2 | Env>;
@@ -4959,7 +4959,7 @@ export declare const pipeTo: {
      * // Outputs: 2, 4, 6
      * ```
      *
-     * @category utils
+     * @category sequencing
      * @since 2.0.0
      */
     <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, OutElem2, OutErr2, OutDone2, Env2>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>, that: Channel<OutElem2, OutErr2, OutDone2, OutElem, OutErr, OutDone, Env2>): Channel<OutElem2, OutErr2, OutDone2, InElem, InErr, InDone, Env2 | Env>;
@@ -4988,7 +4988,7 @@ export declare const pipeTo: {
  * // Source errors are preserved and not sent to transform channel
  * ```
  *
- * @category utils
+ * @category sequencing
  * @since 2.0.0
  */
 export declare const pipeToOrFail: {
@@ -5016,7 +5016,7 @@ export declare const pipeToOrFail: {
      * // Source errors are preserved and not sent to transform channel
      * ```
      *
-     * @category utils
+     * @category sequencing
      * @since 2.0.0
      */
     <OutElem2, OutErr2, OutDone2, OutElem, OutDone, Env2>(that: Channel<OutElem2, OutErr2, OutDone2, OutElem, never, OutDone, Env2>): <OutErr, InElem, InErr, InDone, Env>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>) => Channel<OutElem2, OutErr | OutErr2, OutDone2, InElem, InErr, InDone, Env2 | Env>;
@@ -5044,7 +5044,7 @@ export declare const pipeToOrFail: {
      * // Source errors are preserved and not sent to transform channel
      * ```
      *
-     * @category utils
+     * @category sequencing
      * @since 2.0.0
      */
     <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, OutElem2, OutErr2, OutDone2, Env2>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>, that: Channel<OutElem2, OutErr2, OutDone2, OutElem, never, OutDone, Env2>): Channel<OutElem2, OutErr | OutErr2, OutDone2, InElem, InErr, InDone, Env2 | Env>;
@@ -5081,7 +5081,7 @@ export declare const unwrap: <OutElem, OutErr, OutDone, InElem, InErr, InDone, R
  * Runs a channel with a scope provided for the duration of the channel
  * execution, removing the channel's `Scope` requirement.
  *
- * @category utils
+ * @category resource management
  * @since 2.0.0
  */
 export declare const scoped: <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>) => Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Exclude<Env, Scope.Scope>>;
@@ -5116,7 +5116,7 @@ export declare const scoped: <OutElem, OutErr, OutDone, InElem, InErr, InDone, E
  * )
  * ```
  *
- * @category utils
+ * @category sequencing
  * @since 2.0.0
  */
 export declare const embedInput: {
@@ -5151,7 +5151,7 @@ export declare const embedInput: {
      * )
      * ```
      *
-     * @category utils
+     * @category sequencing
      * @since 2.0.0
      */
     <InElem, InErr, InDone, R>(input: (upstream: Pull.Pull<InElem, InErr, InDone>) => Effect.Effect<void, never, R>): <OutElem, OutErr, OutDone, Env>(self: Channel<OutElem, OutErr, OutDone, unknown, unknown, unknown, Env>) => Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env | R>;
@@ -5186,7 +5186,7 @@ export declare const embedInput: {
      * )
      * ```
      *
-     * @category utils
+     * @category sequencing
      * @since 2.0.0
      */
     <OutElem, OutErr, OutDone, Env, InErr, InElem, InDone, R>(self: Channel<OutElem, OutErr, OutDone, unknown, unknown, unknown, Env>, input: (upstream: Pull.Pull<InElem, InErr, InDone>) => Effect.Effect<void, never, R>): Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env | R>;
@@ -5359,7 +5359,7 @@ export declare const bufferArray: {
  * channel's done value. If the channel completes first, the original channel's
  * done value is preserved.
  *
- * @category utils
+ * @category interruption
  * @since 2.0.0
  */
 export declare const interruptWhen: {
@@ -5377,7 +5377,7 @@ export declare const interruptWhen: {
      * channel's done value. If the channel completes first, the original channel's
      * done value is preserved.
      *
-     * @category utils
+     * @category interruption
      * @since 2.0.0
      */
     <OutDone2, OutErr2, Env2>(effect: Effect.Effect<OutDone2, OutErr2, Env2>): <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>) => Channel<OutElem, OutErr | OutErr2, OutDone | OutDone2, InElem, InErr, InDone, Env2 | Env>;
@@ -5395,7 +5395,7 @@ export declare const interruptWhen: {
      * channel's done value. If the channel completes first, the original channel's
      * done value is preserved.
      *
-     * @category utils
+     * @category interruption
      * @since 2.0.0
      */
     <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, OutDone2, OutErr2, Env2>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>, effect: Effect.Effect<OutDone2, OutErr2, Env2>): Channel<OutElem, OutErr | OutErr2, OutDone | OutDone2, InElem, InErr, InDone, Env2 | Env>;
@@ -5410,7 +5410,7 @@ export declare const interruptWhen: {
  * fails with that error. If the channel completes first, the channel's done
  * value is preserved.
  *
- * @category utils
+ * @category interruption
  * @since 4.0.0
  */
 export declare const haltWhen: {
@@ -5424,7 +5424,7 @@ export declare const haltWhen: {
      * fails with that error. If the channel completes first, the channel's done
      * value is preserved.
      *
-     * @category utils
+     * @category interruption
      * @since 4.0.0
      */
     <OutDone2, OutErr2, Env2>(effect: Effect.Effect<OutDone2, OutErr2, Env2>): <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>) => Channel<OutElem, OutErr | OutErr2, OutDone | OutDone2, InElem, InErr, InDone, Env2 | Env>;
@@ -5438,7 +5438,7 @@ export declare const haltWhen: {
      * fails with that error. If the channel completes first, the channel's done
      * value is preserved.
      *
-     * @category utils
+     * @category interruption
      * @since 4.0.0
      */
     <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, OutDone2, OutErr2, Env2>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>, effect: Effect.Effect<OutDone2, OutErr2, Env2>): Channel<OutElem, OutErr | OutErr2, OutDone | OutDone2, InElem, InErr, InDone, Env2 | Env>;
@@ -5451,7 +5451,7 @@ export declare const haltWhen: {
  * The finalizer receives the failure `Cause`. The original channel failure is
  * preserved. The finalizer itself must not fail.
  *
- * @category utils
+ * @category error handling
  * @since 4.0.0
  */
 export declare const onError: {
@@ -5463,7 +5463,7 @@ export declare const onError: {
      * The finalizer receives the failure `Cause`. The original channel failure is
      * preserved. The finalizer itself must not fail.
      *
-     * @category utils
+     * @category error handling
      * @since 4.0.0
      */
     <OutDone, OutErr, Env2>(finalizer: (cause: Cause.Cause<OutErr>) => Effect.Effect<unknown, never, Env2>): <OutElem, InElem, InErr, InDone, Env>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>) => Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env2 | Env>;
@@ -5475,7 +5475,7 @@ export declare const onError: {
      * The finalizer receives the failure `Cause`. The original channel failure is
      * preserved. The finalizer itself must not fail.
      *
-     * @category utils
+     * @category error handling
      * @since 4.0.0
      */
     <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, Env2>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>, finalizer: (cause: Cause.Cause<OutErr>) => Effect.Effect<unknown, never, Env2>): Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env2 | Env>;
@@ -5506,7 +5506,7 @@ export declare const onError: {
  * })
  * ```
  *
- * @category utils
+ * @category resource management
  * @since 4.0.0
  */
 export declare const onExit: {
@@ -5536,7 +5536,7 @@ export declare const onExit: {
      * })
      * ```
      *
-     * @category utils
+     * @category resource management
      * @since 4.0.0
      */
     <OutDone, OutErr, Env2>(finalizer: (e: Exit.Exit<OutDone, OutErr>) => Effect.Effect<unknown, never, Env2>): <OutElem, InElem, InErr, InDone, Env>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>) => Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env2 | Env>;
@@ -5566,7 +5566,7 @@ export declare const onExit: {
      * })
      * ```
      *
-     * @category utils
+     * @category resource management
      * @since 4.0.0
      */
     <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, Env2>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>, finalizer: (e: Exit.Exit<OutDone, OutErr>) => Effect.Effect<unknown, never, Env2>): Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env2 | Env>;
@@ -5579,7 +5579,7 @@ export declare const onExit: {
  * The effect's successful value is ignored. If the effect fails, the returned
  * channel fails before running the source channel.
  *
- * @category utils
+ * @category hooks
  * @since 4.0.0
  */
 export declare const onStart: {
@@ -5591,7 +5591,7 @@ export declare const onStart: {
      * The effect's successful value is ignored. If the effect fails, the returned
      * channel fails before running the source channel.
      *
-     * @category utils
+     * @category hooks
      * @since 4.0.0
      */
     <A, E, R>(onStart: Effect.Effect<A, E, R>): <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>) => Channel<OutElem, OutErr | E, OutDone, InElem, InErr, InDone, Env | R>;
@@ -5603,7 +5603,7 @@ export declare const onStart: {
      * The effect's successful value is ignored. If the effect fails, the returned
      * channel fails before running the source channel.
      *
-     * @category utils
+     * @category hooks
      * @since 4.0.0
      */
     <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, A, E, R>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>, onStart: Effect.Effect<A, E, R>): Channel<OutElem, OutErr | E, OutDone, InElem, InErr, InDone, Env | R>;
@@ -5617,7 +5617,7 @@ export declare const onStart: {
  * emitted unchanged. The effect is not run if the channel completes without
  * emitting an element.
  *
- * @category utils
+ * @category hooks
  * @since 4.0.0
  */
 export declare const onFirst: {
@@ -5630,7 +5630,7 @@ export declare const onFirst: {
      * emitted unchanged. The effect is not run if the channel completes without
      * emitting an element.
      *
-     * @category utils
+     * @category hooks
      * @since 4.0.0
      */
     <OutElem, A, E, R>(onFirst: (element: Types.NoInfer<OutElem>) => Effect.Effect<A, E, R>): <OutErr, OutDone, InElem, InErr, InDone, Env>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>) => Channel<OutElem, OutErr | E, OutDone, InElem, InErr, InDone, Env | R>;
@@ -5643,7 +5643,7 @@ export declare const onFirst: {
      * emitted unchanged. The effect is not run if the channel completes without
      * emitting an element.
      *
-     * @category utils
+     * @category hooks
      * @since 4.0.0
      */
     <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, A, E, R>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>, onFirst: (element: Types.NoInfer<OutElem>) => Effect.Effect<A, E, R>): Channel<OutElem, OutErr | E, OutDone, InElem, InErr, InDone, Env | R>;
@@ -5657,7 +5657,7 @@ export declare const onFirst: {
  * not run when the channel fails. If the effect fails, the returned channel
  * fails with that error.
  *
- * @category utils
+ * @category hooks
  * @since 4.0.0
  */
 export declare const onEnd: {
@@ -5670,7 +5670,7 @@ export declare const onEnd: {
      * not run when the channel fails. If the effect fails, the returned channel
      * fails with that error.
      *
-     * @category utils
+     * @category hooks
      * @since 4.0.0
      */
     <A, E, R>(onEnd: Effect.Effect<A, E, R>): <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>) => Channel<OutElem, OutErr | E, OutDone, InElem, InErr, InDone, Env | R>;
@@ -5683,7 +5683,7 @@ export declare const onEnd: {
      * not run when the channel fails. If the effect fails, the returned channel
      * fails with that error.
      *
-     * @category utils
+     * @category hooks
      * @since 4.0.0
      */
     <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, A, E, R>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>, onEnd: Effect.Effect<A, E, R>): Channel<OutElem, OutErr | E, OutDone, InElem, InErr, InDone, Env | R>;
@@ -5711,7 +5711,7 @@ export declare const onEnd: {
  * )
  * ```
  *
- * @category utils
+ * @category resource management
  * @since 2.0.0
  */
 export declare const ensuring: {
@@ -5738,7 +5738,7 @@ export declare const ensuring: {
      * )
      * ```
      *
-     * @category utils
+     * @category resource management
      * @since 2.0.0
      */
     <Env2>(finalizer: Effect.Effect<unknown, never, Env2>): <OutElem, OutDone, OutErr, InElem, InErr, InDone, Env>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>) => Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env2 | Env>;
@@ -5765,7 +5765,7 @@ export declare const ensuring: {
      * )
      * ```
      *
-     * @category utils
+     * @category resource management
      * @since 2.0.0
      */
     <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, Env2>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>, finalizer: Effect.Effect<unknown, never, Env2>): Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env2 | Env>;
@@ -6043,7 +6043,7 @@ export declare const withSpan: {
 /**
  * The starting channel for Do notation, emitting an empty object.
  *
- * @category Do notation
+ * @category do notation
  * @since 4.0.0
  */
 export declare const Do: Channel<{}>;
@@ -6059,7 +6059,7 @@ export {
 /**
  * Adds a computed field to each object emitted by a channel.
  *
- * @category Do notation
+ * @category do notation
  * @since 4.0.0
  */
 let_ as let };
@@ -6073,7 +6073,7 @@ let_ as let };
  * channel's output becomes the value of the new field. `options.concurrency`
  * and `options.bufferSize` control how derived channels are flattened.
  *
- * @category Do notation
+ * @category do notation
  * @since 4.0.0
  */
 export declare const bind: {
@@ -6087,7 +6087,7 @@ export declare const bind: {
      * channel's output becomes the value of the new field. `options.concurrency`
      * and `options.bufferSize` control how derived channels are flattened.
      *
-     * @category Do notation
+     * @category do notation
      * @since 4.0.0
      */
     <N extends string, OutElem extends object, B, OutErr2, OutDone2, InElem2, InErr2, InDone2, Env2>(name: Exclude<N, keyof OutElem>, f: (a: NoInfer<OutElem>) => Channel<B, OutErr2, OutDone2, InElem2, InErr2, InDone2, Env2>, options?: {
@@ -6106,7 +6106,7 @@ export declare const bind: {
      * channel's output becomes the value of the new field. `options.concurrency`
      * and `options.bufferSize` control how derived channels are flattened.
      *
-     * @category Do notation
+     * @category do notation
      * @since 4.0.0
      */
     <OutElem extends object, OutErr, OutDone, InElem, InErr, InDone, Env, N extends string, B, OutErr2, OutDone2, InElem2, InErr2, InDone2, Env2>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>, name: Exclude<N, keyof OutElem>, f: (a: NoInfer<OutElem>) => Channel<B, OutErr2, OutDone2, InElem2, InErr2, InDone2, Env2>, options?: {
@@ -6128,7 +6128,7 @@ export declare const bind: {
  * @see {@link bind} for adding a field produced by another channel
  * @see {@link let_ let} for adding a computed field
  *
- * @category Do notation
+ * @category do notation
  * @since 4.0.0
  */
 export declare const bindTo: {
@@ -6144,7 +6144,7 @@ export declare const bindTo: {
      * @see {@link bind} for adding a field produced by another channel
      * @see {@link let_ let} for adding a computed field
      *
-     * @category Do notation
+     * @category do notation
      * @since 4.0.0
      */
     <N extends string>(name: N): <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>) => Channel<{
@@ -6162,7 +6162,7 @@ export declare const bindTo: {
      * @see {@link bind} for adding a field produced by another channel
      * @see {@link let_ let} for adding a computed field
      *
-     * @category Do notation
+     * @category do notation
      * @since 4.0.0
      */
     <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env, N extends string>(self: Channel<OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>, name: N): Channel<{