effect 4.0.0-beta.69 → 4.0.0-beta.70

package/src/Channel.ts

@@ -137,6 +137,8 @@ export const isChannel = (
  * `OutElem`. When the channel finishes, it yields a value of type `OutDone`. A
  * channel may fail with a value of type `OutErr`.
  *
+ * **Details**
+ *
  * Channels are the foundation of Streams: both streams and sinks are built on
  * channels. Most users shouldn't have to use channels directly, as streams and
  * sinks are much more convenient and cover all common use cases. However, when
@@ -197,6 +199,8 @@ export interface Channel<
 /**
  * Type-level unification support for `Channel` values.
  *
+ * **Details**
+ *
  * This preserves all `Channel` type parameters when `Unify` normalizes unions
  * or generic return types that include channels. Users normally do not need to
  * reference this interface directly.
@@ -214,6 +218,8 @@ export interface ChannelUnify<A extends { [Unify.typeSymbol]?: any }> extends Ef
 /**
  * Marker used by `Unify` while resolving `Channel` values.
  *
+ * **Details**
+ *
  * It prevents the inherited `Effect` unifier from being selected when the
  * channel-specific unifier should preserve `Channel` input, output, and
  * environment type parameters. Users normally do not need to reference this
@@ -233,6 +239,8 @@ type TagsWithReason<E> = {
 /**
  * Phantom variance marker for the type parameters of `Channel`.
  *
+ * **Details**
+ *
  * Output element, output error, output done, and environment types are
  * covariant. Input element, input error, and input done types are
  * contravariant. This is type-level machinery and is not used directly at
@@ -256,6 +264,8 @@ export interface Variance<
  * Structural encoding used by `Variance` to record each `Channel` type
  * parameter's variance.
  *
+ * **Details**
+ *
  * The `_OutElem`, `_OutErr`, `_OutDone`, and `_Env` fields are covariant; the
  * `_InElem`, `_InErr`, and `_InDone` fields are contravariant. Users normally
  * do not need to reference this interface directly.
@@ -573,6 +583,8 @@ export const suspend = <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(
  * `release` runs with the channel's `Exit` when the channel completes, fails,
  * or is interrupted.
  *
+ * **Details**
+ *
  * Acquisition is uninterruptible. If acquisition fails, `use` is not run and
  * `release` is not registered.
  *
@@ -613,6 +625,8 @@ export const acquireUseRelease = <A, E, R, OutElem, OutErr, OutDone, InElem, InE
  * Acquires a resource, emits the acquired value as a single channel element,
  * and registers `release` in the channel scope.
  *
+ * **Details**
+ *
  * The release action runs when the channel scope closes and receives the scope
  * exit. If acquisition fails, no element is emitted and `release` is not
  * registered.
@@ -636,6 +650,8 @@ export const acquireRelease: {
    * Acquires a resource, emits the acquired value as a single channel element,
    * and registers `release` in the channel scope.
    *
+   * **Details**
+   *
    * The release action runs when the channel scope closes and receives the scope
    * exit. If acquisition fails, no element is emitted and `release` is not
    * registered.
@@ -659,6 +675,8 @@ export const acquireRelease: {
    * Acquires a resource, emits the acquired value as a single channel element,
    * and registers `release` in the channel scope.
    *
+   * **Details**
+   *
    * The release action runs when the channel scope closes and receives the scope
    * exit. If acquisition fails, no element is emitted and `release` is not
    * registered.
@@ -1189,6 +1207,8 @@ export const fromEffect = <A, E, R>(
  * Creates a channel that evaluates an effect and uses its successful value as
  * the channel's done value without emitting any output elements.
  *
+ * **Details**
+ *
  * If the effect fails, the channel fails with the effect's error.
  *
  * @category constructors
@@ -1212,6 +1232,8 @@ export const fromEffectDrain = <A, E, R>(
 /**
  * Creates a channel from an effect that produces a `Take`.
  *
+ * **Details**
+ *
  * A successful `Take` emits a non-empty array of output elements. A failed
  * `Take` fails the channel. A done `Take` completes the channel with its done
  * value.
@@ -1375,6 +1397,8 @@ export const fromSubscription = <A>(
 /**
  * Create a channel from a PubSub subscription that outputs arrays of values.
  *
+ * **Details**
+ *
  * This constructor creates a channel that reads from a PubSub subscription and outputs
  * arrays of values in chunks. It's useful when you want to process multiple values at once
  * for better performance.
@@ -1480,6 +1504,8 @@ export const fromSubscriptionArray = <A>(
 /**
  * Create a channel from a PubSub that outputs individual values.
  *
+ * **Details**
+ *
  * This constructor creates a channel that reads from a PubSub by automatically
  * subscribing to it. The channel outputs individual values as they are published
  * to the PubSub, making it ideal for real-time streaming scenarios.
@@ -1575,6 +1601,8 @@ export const fromPubSub = <A>(
 /**
  * Create a channel from a PubSub that outputs arrays of values.
  *
+ * **Details**
+ *
  * This constructor creates a channel that reads from a PubSub by automatically
  * subscribing to it and collecting values into arrays. The channel outputs
  * arrays of values in chunks, making it ideal for batch processing scenarios.
@@ -1697,6 +1725,8 @@ export const fromPubSubArray = <A>(pubsub: PubSub.PubSub<A>): Channel<Arr.NonEmp
 /**
  * Subscribes to a `PubSub` of `Take` values and exposes them as a channel.
  *
+ * **Details**
+ *
  * Output `Take` values are emitted as non-empty arrays. Failed `Take` values
  * fail the channel. Done `Take` values complete the channel.
  *
@@ -1722,6 +1752,8 @@ export const fromSchedule = <O, E, R>(
 /**
  * Creates a channel that pulls values from an `AsyncIterable`.
  *
+ * **Details**
+ *
  * Each yielded value is emitted as an output element. The iterator's return
  * value becomes the channel's done value. Thrown or rejected iterator errors
  * are converted with `onError`. If the channel scope closes early and the
@@ -1752,6 +1784,8 @@ export const fromAsyncIterable = <A, D, E>(
  * Creates a channel from an `AsyncIterable`, emitting each yielded value as a
  * single-element non-empty array.
  *
+ * **Details**
+ *
  * The iterator's return value becomes the channel's done value. Thrown or
  * rejected iterator errors are converted with `onError`. If the channel scope
  * closes early and the iterator has a `return` method, that method is called.
@@ -1983,6 +2017,8 @@ const concurrencyIsSequential = (
  * Maps each output element with an effectful function, preserving the source
  * channel's done value.
  *
+ * **Details**
+ *
  * The mapping function receives the output element and its zero-based index.
  * By default elements are mapped sequentially. Use `options.concurrency` to
  * map multiple elements concurrently, and `options.unordered` to allow
@@ -2034,6 +2070,8 @@ export const mapEffect: {
    * Maps each output element with an effectful function, preserving the source
    * channel's done value.
    *
+   * **Details**
+   *
    * The mapping function receives the output element and its zero-based index.
    * By default elements are mapped sequentially. Use `options.concurrency` to
    * map multiple elements concurrently, and `options.unordered` to allow
@@ -2093,6 +2131,8 @@ export const mapEffect: {
    * Maps each output element with an effectful function, preserving the source
    * channel's done value.
    *
+   * **Details**
+   *
    * The mapping function receives the output element and its zero-based index.
    * By default elements are mapped sequentially. Use `options.concurrency` to
    * map multiple elements concurrently, and `options.unordered` to allow
@@ -2368,6 +2408,8 @@ export const mapInputError: {
  * Applies a side effect function to each output element of the channel,
  * returning a new channel that emits the same elements.
  *
+ * **Details**
+ *
  * The `tap` function allows you to perform side effects (like logging or
  * debugging) on each element emitted by a channel without modifying the
  * elements themselves.
@@ -2402,6 +2444,8 @@ export const tap: {
    * Applies a side effect function to each output element of the channel,
    * returning a new channel that emits the same elements.
    *
+   * **Details**
+   *
    * The `tap` function allows you to perform side effects (like logging or
    * debugging) on each element emitted by a channel without modifying the
    * elements themselves.
@@ -2443,6 +2487,8 @@ export const tap: {
    * Applies a side effect function to each output element of the channel,
    * returning a new channel that emits the same elements.
    *
+   * **Details**
+   *
    * The `tap` function allows you to perform side effects (like logging or
    * debugging) on each element emitted by a channel without modifying the
    * elements themselves.
@@ -2495,6 +2541,8 @@ export const tap: {
  * Maps each output element to a channel and flattens the child channel
  * outputs.
  *
+ * **Details**
+ *
  * The source channel's done value is preserved. Child channel done values are
  * used only for child-channel completion. By default child channels are run
  * sequentially. Use `options.concurrency` and `options.bufferSize` to run child
@@ -2531,6 +2579,8 @@ export const flatMap: {
    * Maps each output element to a channel and flattens the child channel
    * outputs.
    *
+   * **Details**
+   *
    * The source channel's done value is preserved. Child channel done values are
    * used only for child-channel completion. By default child channels are run
    * sequentially. Use `options.concurrency` and `options.bufferSize` to run child
@@ -2583,6 +2633,8 @@ export const flatMap: {
    * Maps each output element to a channel and flattens the child channel
    * outputs.
    *
+   * **Details**
+   *
    * The source channel's done value is preserved. Child channel done values are
    * used only for child-channel completion. By default child channels are run
    * sequentially. Use `options.concurrency` and `options.bufferSize` to run child
@@ -3219,6 +3271,8 @@ export const combine: {
  * Runs a fallback channel if this channel completes without emitting any
  * output elements.
  *
+ * **Details**
+ *
  * If the source emits at least one element, the source is used unchanged. If
  * the source completes before emitting an element, the fallback function
  * receives the source done value and returns the replacement channel.
@@ -3231,6 +3285,8 @@ export const orElseIfEmpty: {
    * Runs a fallback channel if this channel completes without emitting any
    * output elements.
    *
+   * **Details**
+   *
    * If the source emits at least one element, the source is used unchanged. If
    * the source completes before emitting an element, the fallback function
    * receives the source done value and returns the replacement channel.
@@ -3255,6 +3311,8 @@ export const orElseIfEmpty: {
    * Runs a fallback channel if this channel completes without emitting any
    * output elements.
    *
+   * **Details**
+   *
    * If the source emits at least one element, the source is used unchanged. If
    * the source completes before emitting an element, the fallback function
    * receives the source done value and returns the replacement channel.
@@ -3469,6 +3527,8 @@ export const flattenArray = <
  * Flattens a channel that emits `Take` values into a channel that emits the
  * `Take` outputs directly.
  *
+ * **Details**
+ *
  * Output `Take` values are emitted as non-empty arrays. Failed `Take` values
  * fail the returned channel. Done `Take` values complete the returned channel.
  *
@@ -3619,6 +3679,8 @@ export const forever = <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(
  * Runs a schedule step for each output element while preserving the emitted
  * elements.
  *
+ * **Details**
+ *
  * The schedule receives each output element as input. Schedule delays are
  * applied between emitted elements. If the schedule fails, the returned channel
  * fails. If the schedule finishes, the returned channel completes with the
@@ -3632,6 +3694,8 @@ export const schedule: {
    * Runs a schedule step for each output element while preserving the emitted
    * elements.
    *
+   * **Details**
+   *
    * The schedule receives each output element as input. Schedule delays are
    * applied between emitted elements. If the schedule fails, the returned channel
    * fails. If the schedule finishes, the returned channel completes with the
@@ -3647,6 +3711,8 @@ export const schedule: {
    * Runs a schedule step for each output element while preserving the emitted
    * elements.
    *
+   * **Details**
+   *
    * The schedule receives each output element as input. Schedule delays are
    * applied between emitted elements. If the schedule fails, the returned channel
    * fails. If the schedule finishes, the returned channel completes with the
@@ -3854,6 +3920,8 @@ export const filter: {
 /**
  * Filters and maps output elements using a `Filter`.
  *
+ * **Details**
+ *
  * Successful filter results are emitted as mapped values. Failed filter
  * results are discarded. The source channel's errors and done value are
  * preserved.
@@ -3865,6 +3933,8 @@ export const filterMap: {
   /**
    * Filters and maps output elements using a `Filter`.
    *
+   * **Details**
+   *
    * Successful filter results are emitted as mapped values. Failed filter
    * results are discarded. The source channel's errors and done value are
    * preserved.
@@ -3878,6 +3948,8 @@ export const filterMap: {
   /**
    * Filters and maps output elements using a `Filter`.
    *
+   * **Details**
+   *
    * Successful filter results are emitted as mapped values. Failed filter
    * results are discarded. The source channel's errors and done value are
    * preserved.
@@ -3909,6 +3981,8 @@ export const filterMap: {
 /**
  * Filters output elements with an effectful predicate.
  *
+ * **Details**
+ *
  * Elements for which the predicate succeeds with `true` are emitted. Elements
  * for which the predicate succeeds with `false` are discarded. Predicate
  * failures fail the returned channel.
@@ -3920,6 +3994,8 @@ export const filterEffect: {
   /**
    * Filters output elements with an effectful predicate.
    *
+   * **Details**
+   *
    * Elements for which the predicate succeeds with `true` are emitted. Elements
    * for which the predicate succeeds with `false` are discarded. Predicate
    * failures fail the returned channel.
@@ -3933,6 +4009,8 @@ export const filterEffect: {
   /**
    * Filters output elements with an effectful predicate.
    *
+   * **Details**
+   *
    * Elements for which the predicate succeeds with `true` are emitted. Elements
    * for which the predicate succeeds with `false` are discarded. Predicate
    * failures fail the returned channel.
@@ -3967,6 +4045,8 @@ export const filterEffect: {
 /**
  * Filters and maps output elements using an effectful `Filter`.
  *
+ * **Details**
+ *
  * Successful filter results are emitted as mapped values. Failed filter
  * results are discarded. Failures from the effectful filter fail the returned
  * channel.
@@ -3978,6 +4058,8 @@ export const filterMapEffect: {
   /**
    * Filters and maps output elements using an effectful `Filter`.
    *
+   * **Details**
+   *
    * Successful filter results are emitted as mapped values. Failed filter
    * results are discarded. Failures from the effectful filter fail the returned
    * channel.
@@ -3991,6 +4073,8 @@ export const filterMapEffect: {
   /**
    * Filters and maps output elements using an effectful `Filter`.
    *
+   * **Details**
+   *
    * Successful filter results are emitted as mapped values. Failed filter
    * results are discarded. Failures from the effectful filter fail the returned
    * channel.
@@ -4241,6 +4325,8 @@ export const filterArray: {
  * Filters and maps each element inside emitted non-empty arrays using a
  * `Filter`.
  *
+ * **Details**
+ *
  * Successful filter results are kept as mapped values. Failed filter results
  * are removed from the array. Arrays that become empty are discarded.
  *
@@ -4252,6 +4338,8 @@ export const filterMapArray: {
    * Filters and maps each element inside emitted non-empty arrays using a
    * `Filter`.
    *
+   * **Details**
+   *
    * Successful filter results are kept as mapped values. Failed filter results
    * are removed from the array. Arrays that become empty are discarded.
    *
@@ -4265,6 +4353,8 @@ export const filterMapArray: {
    * Filters and maps each element inside emitted non-empty arrays using a
    * `Filter`.
    *
+   * **Details**
+   *
    * Successful filter results are kept as mapped values. Failed filter results
    * are removed from the array. Arrays that become empty are discarded.
    *
@@ -4300,6 +4390,8 @@ export const filterMapArray: {
  * Filters each element inside emitted non-empty arrays with an effectful
  * predicate.
  *
+ * **Details**
+ *
  * The predicate receives the element and its index within the array. Elements
  * for which the predicate succeeds with `true` are kept. Arrays that become
  * empty are discarded. Predicate failures fail the returned channel.
@@ -4312,6 +4404,8 @@ export const filterArrayEffect: {
    * Filters each element inside emitted non-empty arrays with an effectful
    * predicate.
    *
+   * **Details**
+   *
    * The predicate receives the element and its index within the array. Elements
    * for which the predicate succeeds with `true` are kept. Arrays that become
    * empty are discarded. Predicate failures fail the returned channel.
@@ -4328,6 +4422,8 @@ export const filterArrayEffect: {
    * Filters each element inside emitted non-empty arrays with an effectful
    * predicate.
    *
+   * **Details**
+   *
    * The predicate receives the element and its index within the array. Elements
    * for which the predicate succeeds with `true` are kept. Arrays that become
    * empty are discarded. Predicate failures fail the returned channel.
@@ -4357,6 +4453,8 @@ export const filterArrayEffect: {
  * Filters and maps each element inside emitted non-empty arrays using an
  * effectful `Filter`.
  *
+ * **Details**
+ *
  * Successful filter results are kept as mapped values. Failed filter results
  * are removed from the array. Arrays that become empty are discarded. Failures
  * from the effectful filter fail the returned channel.
@@ -4369,6 +4467,8 @@ export const filterMapArrayEffect: {
    * Filters and maps each element inside emitted non-empty arrays using an
    * effectful `Filter`.
    *
+   * **Details**
+   *
    * Successful filter results are kept as mapped values. Failed filter results
    * are removed from the array. Arrays that become empty are discarded. Failures
    * from the effectful filter fail the returned channel.
@@ -4383,6 +4483,8 @@ export const filterMapArrayEffect: {
    * Filters and maps each element inside emitted non-empty arrays using an
    * effectful `Filter`.
    *
+   * **Details**
+   *
    * Successful filter results are kept as mapped values. Failed filter results
    * are removed from the array. Arrays that become empty are discarded. Failures
    * from the effectful filter fail the returned channel.
@@ -5138,6 +5240,8 @@ export const catchCause: {
  * Runs an effect with the full failure `Cause` when the channel fails, then
  * fails the returned channel with the original cause.
  *
+ * **Details**
+ *
  * Use this for observing failures, such as logging or metrics. If the observer
  * effect fails, that failure can fail the returned channel.
  *
@@ -5149,6 +5253,8 @@ export const tapCause: {
    * Runs an effect with the full failure `Cause` when the channel fails, then
    * fails the returned channel with the original cause.
    *
+   * **Details**
+   *
    * Use this for observing failures, such as logging or metrics. If the observer
    * effect fails, that failure can fail the returned channel.
    *
@@ -5175,6 +5281,8 @@ export const tapCause: {
    * Runs an effect with the full failure `Cause` when the channel fails, then
    * fails the returned channel with the original cause.
    *
+   * **Details**
+   *
    * Use this for observing failures, such as logging or metrics. If the observer
    * effect fails, that failure can fail the returned channel.
    *
@@ -5356,6 +5464,8 @@ export const catchCauseIf: {
 /**
  * Recovers from channel failures whose full `Cause` is selected by a `Filter`.
  *
+ * **Details**
+ *
  * When the filter succeeds, the recovery function receives the selected value
  * and the original cause. When the filter fails, the returned channel fails
  * with the residual cause produced by the filter.
@@ -5367,6 +5477,8 @@ export const catchCauseFilter: {
   /**
    * Recovers from channel failures whose full `Cause` is selected by a `Filter`.
    *
+   * **Details**
+   *
    * When the filter succeeds, the recovery function receives the selected value
    * and the original cause. When the filter fails, the returned channel fails
    * with the residual cause produced by the filter.
@@ -5410,6 +5522,8 @@ export const catchCauseFilter: {
   /**
    * Recovers from channel failures whose full `Cause` is selected by a `Filter`.
    *
+   * **Details**
+   *
    * When the filter succeeds, the recovery function receives the selected value
    * and the original cause. When the filter fails, the returned channel fails
    * with the residual cause produced by the filter.
@@ -5579,6 +5693,8 @@ const catch_: {
 
 export {
   /**
+   * Recovers from typed channel errors by running a fallback channel.
+   *
    * @category error handling
    * @since 4.0.0
    */
@@ -5589,6 +5705,8 @@ export {
  * Runs an effect when the channel fails with a typed error, then preserves the
  * original channel failure.
  *
+ * **Details**
+ *
  * The effect is not run for normal channel completion. If the observer effect
  * fails, that failure can fail the returned channel.
  *
@@ -5600,6 +5718,8 @@ export const tapError: {
    * Runs an effect when the channel fails with a typed error, then preserves the
    * original channel failure.
    *
+   * **Details**
+   *
    * The effect is not run for normal channel completion. If the observer effect
    * fails, that failure can fail the returned channel.
    *
@@ -5626,6 +5746,8 @@ export const tapError: {
    * Runs an effect when the channel fails with a typed error, then preserves the
    * original channel failure.
    *
+   * **Details**
+   *
    * The effect is not run for normal channel completion. If the observer effect
    * fails, that failure can fail the returned channel.
    *
@@ -5690,6 +5812,8 @@ export const tapError: {
 /**
  * Recovers from typed channel errors that match a predicate or refinement.
  *
+ * **Details**
+ *
  * Matching errors are handled by the recovery function. Non-matching errors
  * are handled by `orElse` when provided. Without `orElse`, non-matching errors
  * are re-failed.
@@ -5701,6 +5825,8 @@ export const catchIf: {
   /**
    * Recovers from typed channel errors that match a predicate or refinement.
    *
+   * **Details**
+   *
    * Matching errors are handled by the recovery function. Non-matching errors
    * are handled by `orElse` when provided. Without `orElse`, non-matching errors
    * are re-failed.
@@ -5752,6 +5878,8 @@ export const catchIf: {
   /**
    * Recovers from typed channel errors that match a predicate or refinement.
    *
+   * **Details**
+   *
    * Matching errors are handled by the recovery function. Non-matching errors
    * are handled by `orElse` when provided. Without `orElse`, non-matching errors
    * are re-failed.
@@ -5802,6 +5930,8 @@ export const catchIf: {
   /**
    * Recovers from typed channel errors that match a predicate or refinement.
    *
+   * **Details**
+   *
    * Matching errors are handled by the recovery function. Non-matching errors
    * are handled by `orElse` when provided. Without `orElse`, non-matching errors
    * are re-failed.
@@ -5853,6 +5983,8 @@ export const catchIf: {
   /**
    * Recovers from typed channel errors that match a predicate or refinement.
    *
+   * **Details**
+   *
    * Matching errors are handled by the recovery function. Non-matching errors
    * are handled by `orElse` when provided. Without `orElse`, non-matching errors
    * are re-failed.
@@ -5962,6 +6094,8 @@ export const catchIf: {
 /**
  * Recovers from typed channel errors selected by a `Filter`.
  *
+ * **Details**
+ *
  * Successful filter results are handled by the recovery function. Failed
  * filter results are handled by `orElse` when provided. Without `orElse`,
  * failed filter results are re-failed.
@@ -5973,6 +6107,8 @@ export const catchFilter: {
   /**
    * Recovers from typed channel errors selected by a `Filter`.
    *
+   * **Details**
+   *
    * Successful filter results are handled by the recovery function. Failed
    * filter results are handled by `orElse` when provided. Without `orElse`,
    * failed filter results are re-failed.
@@ -6025,6 +6161,8 @@ export const catchFilter: {
   /**
    * Recovers from typed channel errors selected by a `Filter`.
    *
+   * **Details**
+   *
    * Successful filter results are handled by the recovery function. Failed
    * filter results are handled by `orElse` when provided. Without `orElse`,
    * failed filter results are re-failed.
@@ -6139,6 +6277,8 @@ export const catchFilter: {
 /**
  * Recovers from tagged channel errors whose `_tag` matches one or more tags.
  *
+ * **Details**
+ *
  * Matching tagged errors are handled by the recovery function. Non-matching
  * errors are handled by `orElse` when provided. Without `orElse`,
  * non-matching errors are re-failed.
@@ -6150,6 +6290,8 @@ export const catchTag: {
   /**
    * Recovers from tagged channel errors whose `_tag` matches one or more tags.
    *
+   * **Details**
+   *
    * Matching tagged errors are handled by the recovery function. Non-matching
    * errors are handled by `orElse` when provided. Without `orElse`,
    * non-matching errors are re-failed.
@@ -6203,6 +6345,8 @@ export const catchTag: {
   /**
    * Recovers from tagged channel errors whose `_tag` matches one or more tags.
    *
+   * **Details**
+   *
    * Matching tagged errors are handled by the recovery function. Non-matching
    * errors are handled by `orElse` when provided. Without `orElse`,
    * non-matching errors are re-failed.
@@ -6987,6 +7131,8 @@ export const orDie = <
 /**
  * Ignores all errors in the channel, converting them to an empty channel.
  *
+ * **Details**
+ *
  * Use the `log` option to emit the full {@link Cause} when the channel fails.
  *
  * @category error handling
@@ -7042,6 +7188,8 @@ const ignoreCause_ = <
 /**
  * Ignores all errors in the channel including defects, converting them to an empty channel.
  *
+ * **Details**
+ *
  * Use the `log` option to emit the full {@link Cause} when the channel fails.
  *
  * @category error handling
@@ -7164,6 +7312,8 @@ export const retry: {
  * Maps each output element to a channel and emits values from the most recent
  * active child channels.
  *
+ * **Details**
+ *
  * With the default concurrency of `1`, starting a new child channel interrupts
  * the previous child channel. Use `options.concurrency` to allow more active
  * child channels. The source channel's done value is preserved.
@@ -7197,6 +7347,8 @@ export const switchMap: {
    * Maps each output element to a channel and emits values from the most recent
    * active child channels.
    *
+   * **Details**
+   *
    * With the default concurrency of `1`, starting a new child channel interrupts
    * the previous child channel. Use `options.concurrency` to allow more active
    * child channels. The source channel's done value is preserved.
@@ -7246,6 +7398,8 @@ export const switchMap: {
    * Maps each output element to a channel and emits values from the most recent
    * active child channels.
    *
+   * **Details**
+   *
    * With the default concurrency of `1`, starting a new child channel interrupts
    * the previous child channel. Use `options.concurrency` to allow more active
    * child channels. The source channel's done value is preserved.
@@ -7947,6 +8101,8 @@ export const merge: {
  * Runs an effect concurrently with a channel while emitting only the channel's
  * output elements.
  *
+ * **Details**
+ *
  * The effect's successful value is ignored. If the effect fails while the
  * channel is running, the returned channel fails with that error.
  *
@@ -7958,6 +8114,8 @@ export const mergeEffect: {
    * Runs an effect concurrently with a channel while emitting only the channel's
    * output elements.
    *
+   * **Details**
+   *
    * The effect's successful value is ignored. If the effect fails while the
    * channel is running, the returned channel fails with that error.
    *
@@ -7971,6 +8129,8 @@ export const mergeEffect: {
    * Runs an effect concurrently with a channel while emitting only the channel's
    * output elements.
    *
+   * **Details**
+   *
    * The effect's successful value is ignored. If the effect fails while the
    * channel is running, the returned channel fails with that error.
    *
@@ -7996,6 +8156,8 @@ export const mergeEffect: {
  * standalone `\r` as line terminators. The behavior matches
  * `String.linesIterator` regardless of how the input is chunked.
  *
+ * **Details**
+ *
  * A line terminator at the very end of the stream does **not** produce a
  * trailing empty line (consistent with `String.linesIterator`). Conversely,
  * if the stream ends without a terminator the final partial line is still
@@ -8123,6 +8285,8 @@ export const splitLines = <Err, Done>(): Channel<
 /**
  * Decodes incoming `Uint8Array` chunks into strings using `TextDecoder`.
  *
+ * **Details**
+ *
  * Input chunks are decoded with streaming enabled so multi-byte characters may
  * span `Uint8Array` boundaries. The optional `encoding` and `options` are
  * passed to `TextDecoder`.
@@ -8149,6 +8313,8 @@ export const decodeText = <Err, Done>(encoding?: string, options?: TextDecoderOp
 /**
  * Encodes incoming string chunks into `Uint8Array` values using `TextEncoder`.
  *
+ * **Details**
+ *
  * Each string inside an emitted array is encoded independently.
  *
  * @category String manipulation
@@ -8450,6 +8616,8 @@ export const scoped = <OutElem, OutErr, OutDone, InElem, InErr, InDone, Env>(
  * Runs an input handler against the upstream pull while the wrapped channel
  * runs without receiving upstream input directly.
  *
+ * **Details**
+ *
  * The input handler is forked in the channel scope. The wrapped channel is run
  * with an already-completed input.
  *
@@ -8483,6 +8651,8 @@ export const embedInput: {
    * Runs an input handler against the upstream pull while the wrapped channel
    * runs without receiving upstream input directly.
    *
+   * **Details**
+   *
    * The input handler is forked in the channel scope. The wrapped channel is run
    * with an already-completed input.
    *
@@ -8522,6 +8692,8 @@ export const embedInput: {
    * Runs an input handler against the upstream pull while the wrapped channel
    * runs without receiving upstream input directly.
    *
+   * **Details**
+   *
    * The input handler is forked in the channel scope. The wrapped channel is run
    * with an already-completed input.
    *
@@ -8777,6 +8949,8 @@ export const interruptWhen: {
 /**
  * Halts a channel when the specified effect completes or fails.
  *
+ * **Details**
+ *
  * If the effect completes before the channel is done, its success value becomes
  * the returned channel's done value. If the effect fails, the returned channel
  * fails with that error. If the channel completes first, the channel's done
@@ -8789,6 +8963,8 @@ export const haltWhen: {
   /**
    * Halts a channel when the specified effect completes or fails.
    *
+   * **Details**
+   *
    * If the effect completes before the channel is done, its success value becomes
    * the returned channel's done value. If the effect fails, the returned channel
    * fails with that error. If the channel completes first, the channel's done
@@ -8803,6 +8979,8 @@ export const haltWhen: {
   /**
    * Halts a channel when the specified effect completes or fails.
    *
+   * **Details**
+   *
    * If the effect completes before the channel is done, its success value becomes
    * the returned channel's done value. If the effect fails, the returned channel
    * fails with that error. If the channel completes first, the channel's done
@@ -8837,6 +9015,8 @@ export const haltWhen: {
 /**
  * Attaches a finalizer that runs only when the channel exits with failure.
  *
+ * **Details**
+ *
  * The finalizer receives the failure `Cause`. The original channel failure is
  * preserved. The finalizer itself must not fail.
  *
@@ -8847,6 +9027,8 @@ export const onError: {
   /**
    * Attaches a finalizer that runs only when the channel exits with failure.
    *
+   * **Details**
+   *
    * The finalizer receives the failure `Cause`. The original channel failure is
    * preserved. The finalizer itself must not fail.
    *
@@ -8861,6 +9043,8 @@ export const onError: {
   /**
    * Attaches a finalizer that runs only when the channel exits with failure.
    *
+   * **Details**
+   *
    * The finalizer receives the failure `Cause`. The original channel failure is
    * preserved. The finalizer itself must not fail.
    *
@@ -8990,6 +9174,8 @@ export const onExit: {
 /**
  * Runs an effect before the channel starts.
  *
+ * **Details**
+ *
  * The effect's successful value is ignored. If the effect fails, the returned
  * channel fails before running the source channel.
  *
@@ -9000,6 +9186,8 @@ export const onStart: {
   /**
    * Runs an effect before the channel starts.
    *
+   * **Details**
+   *
    * The effect's successful value is ignored. If the effect fails, the returned
    * channel fails before running the source channel.
    *
@@ -9012,6 +9200,8 @@ export const onStart: {
   /**
    * Runs an effect before the channel starts.
    *
+   * **Details**
+   *
    * The effect's successful value is ignored. If the effect fails, the returned
    * channel fails before running the source channel.
    *
@@ -9030,6 +9220,8 @@ export const onStart: {
 /**
  * Runs an effect the first time the channel emits an output element.
  *
+ * **Details**
+ *
  * The effect receives the first emitted element. The first element is still
  * emitted unchanged. The effect is not run if the channel completes without
  * emitting an element.
@@ -9041,6 +9233,8 @@ export const onFirst: {
   /**
    * Runs an effect the first time the channel emits an output element.
    *
+   * **Details**
+   *
    * The effect receives the first emitted element. The first element is still
    * emitted unchanged. The effect is not run if the channel completes without
    * emitting an element.
@@ -9054,6 +9248,8 @@ export const onFirst: {
   /**
    * Runs an effect the first time the channel emits an output element.
    *
+   * **Details**
+   *
    * The effect receives the first emitted element. The first element is still
    * emitted unchanged. The effect is not run if the channel completes without
    * emitting an element.
@@ -9082,6 +9278,8 @@ export const onFirst: {
 /**
  * Runs an effect when the channel completes successfully.
  *
+ * **Details**
+ *
  * The effect runs before the original done value is propagated. The effect is
  * not run when the channel fails. If the effect fails, the returned channel
  * fails with that error.
@@ -9093,6 +9291,8 @@ export const onEnd: {
   /**
    * Runs an effect when the channel completes successfully.
    *
+   * **Details**
+   *
    * The effect runs before the original done value is propagated. The effect is
    * not run when the channel fails. If the effect fails, the returned channel
    * fails with that error.
@@ -9106,6 +9306,8 @@ export const onEnd: {
   /**
    * Runs an effect when the channel completes successfully.
    *
+   * **Details**
+   *
    * The effect runs before the original done value is propagated. The effect is
    * not run when the channel fails. If the effect fails, the returned channel
    * fails with that error.
@@ -9343,6 +9545,8 @@ export const provideService: {
  * Evaluates an effect to obtain a service, then provides that service to the
  * channel.
  *
+ * **Details**
+ *
  * If the service effect fails, the returned channel fails. The provided service
  * removes the corresponding service requirement from the returned channel.
  *
@@ -9354,6 +9558,8 @@ export const provideServiceEffect: {
    * Evaluates an effect to obtain a service, then provides that service to the
    * channel.
    *
+   * **Details**
+   *
    * If the service effect fails, the returned channel fails. The provided service
    * removes the corresponding service requirement from the returned channel.
    *
@@ -9367,6 +9573,8 @@ export const provideServiceEffect: {
    * Evaluates an effect to obtain a service, then provides that service to the
    * channel.
    *
+   * **Details**
+   *
    * If the service effect fails, the returned channel fails. The provided service
    * removes the corresponding service requirement from the returned channel.
    *
@@ -9394,6 +9602,8 @@ export const provideServiceEffect: {
  * Provides a `Layer` or `Context` to the channel, removing the corresponding
  * service requirements.
  *
+ * **Details**
+ *
  * Providing a `Context` delegates to `provideContext`. Providing a `Layer`
  * builds the layer in the channel scope. Use `options.local` to build a fresh
  * layer instance for this provision.
@@ -9406,6 +9616,8 @@ export const provide: {
    * Provides a `Layer` or `Context` to the channel, removing the corresponding
    * service requirements.
    *
+   * **Details**
+   *
    * Providing a `Context` delegates to `provideContext`. Providing a `Layer`
    * builds the layer in the channel scope. Use `options.local` to build a fresh
    * layer instance for this provision.
@@ -9425,6 +9637,8 @@ export const provide: {
    * Provides a `Layer` or `Context` to the channel, removing the corresponding
    * service requirements.
    *
+   * **Details**
+   *
    * Providing a `Context` delegates to `provideContext`. Providing a `Layer`
    * builds the layer in the channel scope. Use `options.local` to build a fresh
    * layer instance for this provision.
@@ -9462,6 +9676,8 @@ export const provide: {
 /**
  * Transforms the current context before running the channel.
  *
+ * **Details**
+ *
  * The function receives the surrounding context and returns the context to
  * provide to the channel. The returned channel requires the services needed to
  * build that context.
@@ -9473,6 +9689,8 @@ export const updateContext: {
   /**
    * Transforms the current context before running the channel.
    *
+   * **Details**
+   *
    * The function receives the surrounding context and returns the context to
    * provide to the channel. The returned channel requires the services needed to
    * build that context.
@@ -9486,6 +9704,8 @@ export const updateContext: {
   /**
    * Transforms the current context before running the channel.
    *
+   * **Details**
+   *
    * The function receives the surrounding context and returns the context to
    * provide to the channel. The returned channel requires the services needed to
    * build that context.
@@ -9511,6 +9731,8 @@ export const updateContext: {
 /**
  * Updates a service in the current context before running the channel.
  *
+ * **Details**
+ *
  * The existing service is read from the context. The updated service is
  * provided to the channel under the same key.
  *
@@ -9521,6 +9743,8 @@ export const updateService: {
   /**
    * Updates a service in the current context before running the channel.
    *
+   * **Details**
+   *
    * The existing service is read from the context. The updated service is
    * provided to the channel under the same key.
    *
@@ -9533,6 +9757,8 @@ export const updateService: {
   /**
    * Updates a service in the current context before running the channel.
    *
+   * **Details**
+   *
    * The existing service is read from the context. The updated service is
    * provided to the channel under the same key.
    *
@@ -9559,6 +9785,8 @@ export const updateService: {
 /**
  * Runs the channel inside a tracing span with the specified name and options.
  *
+ * **Details**
+ *
  * The created span is provided as the current parent span while the channel
  * runs. The span is ended with the channel's exit value.
  *
@@ -9569,6 +9797,8 @@ export const withSpan: {
   /**
    * Runs the channel inside a tracing span with the specified name and options.
    *
+   * **Details**
+   *
    * The created span is provided as the current parent span while the channel
    * runs. The span is ended with the channel's exit value.
    *
@@ -9581,6 +9811,8 @@ export const withSpan: {
   /**
    * Runs the channel inside a tracing span with the specified name and options.
    *
+   * **Details**
+   *
    * The created span is provided as the current parent span while the channel
    * runs. The span is ended with the channel's exit value.
    *
@@ -9674,6 +9906,8 @@ const let_: {
   }) as any)))
 export {
   /**
+   * Adds a computed field to each object emitted by a channel.
+   *
    * @category Do notation
    * @since 4.0.0
    */
@@ -9684,6 +9918,8 @@ export {
  * Adds a field to each object emitted by a channel by running another channel
  * derived from that object.
  *
+ * **Details**
+ *
  * The field name must not already exist on the emitted object. The derived
  * channel's output becomes the value of the new field. `options.concurrency`
  * and `options.bufferSize` control how derived channels are flattened.
@@ -9696,6 +9932,8 @@ export const bind: {
    * Adds a field to each object emitted by a channel by running another channel
    * derived from that object.
    *
+   * **Details**
+   *
    * The field name must not already exist on the emitted object. The derived
    * channel's output becomes the value of the new field. `options.concurrency`
    * and `options.bufferSize` control how derived channels are flattened.
@@ -9725,6 +9963,8 @@ export const bind: {
    * Adds a field to each object emitted by a channel by running another channel
    * derived from that object.
    *
+   * **Details**
+   *
    * The field name must not already exist on the emitted object. The derived
    * channel's output becomes the value of the new field. `options.concurrency`
    * and `options.bufferSize` control how derived channels are flattened.
@@ -10021,6 +10261,8 @@ export const runForEach: {
  * Runs a channel and applies an effectful predicate to each output element
  * until the predicate returns `false`.
  *
+ * **Details**
+ *
  * Returning `true` continues consuming the channel. Returning `false` stops
  * consumption early. The returned effect completes with `void`.
  *
@@ -10032,6 +10274,8 @@ export const runForEachWhile: {
    * Runs a channel and applies an effectful predicate to each output element
    * until the predicate returns `false`.
    *
+   * **Details**
+   *
    * Returning `true` continues consuming the channel. Returning `false` stops
    * consumption early. The returned effect completes with `void`.
    *
@@ -10045,6 +10289,8 @@ export const runForEachWhile: {
    * Runs a channel and applies an effectful predicate to each output element
    * until the predicate returns `false`.
    *
+   * **Details**
+   *
    * Returning `true` continues consuming the channel. Returning `false` stops
    * consumption early. The returned effect completes with `void`.
    *
@@ -10115,6 +10361,8 @@ export const runDone = <OutElem, OutErr, OutDone, Env>(
  * Runs a channel until the first output element is available, returning it in
  * an `Option`.
  *
+ * **Details**
+ *
  * Returns `Option.some` with the first output element, or `Option.none` if the
  * channel completes without emitting output.
  *
@@ -10140,6 +10388,8 @@ export const runHead = <OutElem, OutErr, OutDone, Env>(
  * Runs a channel to completion and returns the last output element in an
  * `Option`.
  *
+ * **Details**
+ *
  * Returns `Option.some` with the last emitted element, or `Option.none` if the
  * channel completes without emitting output.
  *
@@ -10271,6 +10521,8 @@ export const runFold: {
 /**
  * Runs a channel and effectfully folds all output elements with an accumulator.
  *
+ * **Details**
+ *
  * The initial accumulator is evaluated lazily. Each output element is passed to
  * the effectful accumulator function. The returned effect succeeds with the
  * final accumulator value.
@@ -10282,6 +10534,8 @@ export const runFoldEffect: {
   /**
    * Runs a channel and effectfully folds all output elements with an accumulator.
    *
+   * **Details**
+   *
    * The initial accumulator is evaluated lazily. Each output element is passed to
    * the effectful accumulator function. The returned effect succeeds with the
    * final accumulator value.
@@ -10295,6 +10549,8 @@ export const runFoldEffect: {
   /**
    * Runs a channel and effectfully folds all output elements with an accumulator.
    *
+   * **Details**
+   *
    * The initial accumulator is evaluated lazily. Each output element is passed to
    * the effectful accumulator function. The returned effect succeeds with the
    * final accumulator value.
@@ -10334,6 +10590,8 @@ export const runFoldEffect: {
 /**
  * Converts a channel to a scoped `Pull` for low-level consumption.
  *
+ * **Details**
+ *
  * The effect requires a `Scope`. The returned pull should be consumed only
  * while that scope remains open. Pulls are serialized so only one pull is
  * evaluated at a time.
@@ -10418,6 +10676,8 @@ export const toPullScoped = <OutElem, OutErr, OutDone, Env>(
 /**
  * Runs a channel and offers each output element into a queue.
  *
+ * **Details**
+ *
  * When the channel completes, the queue is ended. When the channel fails, the
  * queue is failed with the channel's cause. The returned effect itself
  * completes with `void`.
@@ -10429,6 +10689,8 @@ export const runIntoQueue: {
   /**
    * Runs a channel and offers each output element into a queue.
    *
+   * **Details**
+   *
    * When the channel completes, the queue is ended. When the channel fails, the
    * queue is failed with the channel's cause. The returned effect itself
    * completes with `void`.
@@ -10442,6 +10704,8 @@ export const runIntoQueue: {
   /**
    * Runs a channel and offers each output element into a queue.
    *
+   * **Details**
+   *
    * When the channel completes, the queue is ended. When the channel fails, the
    * queue is failed with the channel's cause. The returned effect itself
    * completes with `void`.
@@ -10479,6 +10743,8 @@ export const runIntoQueue: {
  * Runs a channel that emits non-empty arrays and offers each array element into
  * a queue.
  *
+ * **Details**
+ *
  * When the channel completes, the queue is ended. When the channel fails, the
  * queue is failed with the channel's cause. The returned effect itself
  * completes with `void`.
@@ -10491,6 +10757,8 @@ export const runIntoQueueArray: {
    * Runs a channel that emits non-empty arrays and offers each array element into
    * a queue.
    *
+   * **Details**
+   *
    * When the channel completes, the queue is ended. When the channel fails, the
    * queue is failed with the channel's cause. The returned effect itself
    * completes with `void`.
@@ -10505,6 +10773,8 @@ export const runIntoQueueArray: {
    * Runs a channel that emits non-empty arrays and offers each array element into
    * a queue.
    *
+   * **Details**
+   *
    * When the channel completes, the queue is ended. When the channel fails, the
    * queue is failed with the channel's cause. The returned effect itself
    * completes with `void`.
@@ -10542,6 +10812,8 @@ export const runIntoQueueArray: {
  * Creates a scoped queue and forks the channel to feed it for concurrent
  * consumption.
  *
+ * **Details**
+ *
  * Output elements are offered to the queue. Channel completion and failure are
  * signaled through the queue. The queue is shut down when the surrounding scope
  * closes.
@@ -10573,6 +10845,8 @@ export const toQueue: {
    * Creates a scoped queue and forks the channel to feed it for concurrent
    * consumption.
    *
+   * **Details**
+   *
    * Output elements are offered to the queue. Channel completion and failure are
    * signaled through the queue. The queue is shut down when the surrounding scope
    * closes.
@@ -10613,6 +10887,8 @@ export const toQueue: {
    * Creates a scoped queue and forks the channel to feed it for concurrent
    * consumption.
    *
+   * **Details**
+   *
    * Output elements are offered to the queue. Channel completion and failure are
    * signaled through the queue. The queue is shut down when the surrounding scope
    * closes.
@@ -10664,6 +10940,8 @@ export const toQueue: {
      * Creates a scoped queue and forks the channel to feed it for concurrent
      * consumption.
      *
+     * **Details**
+     *
      * Output elements are offered to the queue. Channel completion and failure are
      * signaled through the queue. The queue is shut down when the surrounding scope
      * closes.
@@ -10694,6 +10972,8 @@ export const toQueue: {
      * Creates a scoped queue and forks the channel to feed it for concurrent
      * consumption.
      *
+     * **Details**
+     *
      * Output elements are offered to the queue. Channel completion and failure are
      * signaled through the queue. The queue is shut down when the surrounding scope
      * closes.
@@ -10733,6 +11013,8 @@ export const toQueue: {
 /**
  * Creates a scoped queue and forks an array-emitting channel to feed it.
  *
+ * **Details**
+ *
  * Each element inside emitted non-empty arrays is offered to the queue. Channel
  * completion and failure are signaled through the queue. The queue is shut down
  * when the surrounding scope closes.
@@ -10744,6 +11026,8 @@ export const toQueueArray: {
   /**
    * Creates a scoped queue and forks an array-emitting channel to feed it.
    *
+   * **Details**
+   *
    * Each element inside emitted non-empty arrays is offered to the queue. Channel
    * completion and failure are signaled through the queue. The queue is shut down
    * when the surrounding scope closes.
@@ -10764,6 +11048,8 @@ export const toQueueArray: {
   /**
    * Creates a scoped queue and forks an array-emitting channel to feed it.
    *
+   * **Details**
+   *
    * Each element inside emitted non-empty arrays is offered to the queue. Channel
    * completion and failure are signaled through the queue. The queue is shut down
    * when the surrounding scope closes.
@@ -10795,6 +11081,8 @@ export const toQueueArray: {
     const queue = yield* Queue.make</**
      * Creates a scoped queue and forks an array-emitting channel to feed it.
      *
+     * **Details**
+     *
      * Each element inside emitted non-empty arrays is offered to the queue. Channel
      * completion and failure are signaled through the queue. The queue is shut down
      * when the surrounding scope closes.
@@ -10805,6 +11093,8 @@ export const toQueueArray: {
     OutElem, /**
      * Creates a scoped queue and forks an array-emitting channel to feed it.
      *
+     * **Details**
+     *
      * Each element inside emitted non-empty arrays is offered to the queue. Channel
      * completion and failure are signaled through the queue. The queue is shut down
      * when the surrounding scope closes.
@@ -10825,6 +11115,8 @@ export const toQueueArray: {
 /**
  * Converts a channel to a PubSub for concurrent consumption.
  *
+ * **Details**
+ *
  * `shutdownOnEnd` indicates whether the PubSub should be shut down when the
  * channel ends. By default this is `true`.
  *
@@ -10835,6 +11127,8 @@ export const toPubSub: {
   /**
    * Converts a channel to a PubSub for concurrent consumption.
    *
+   * **Details**
+   *
    * `shutdownOnEnd` indicates whether the PubSub should be shut down when the
    * channel ends. By default this is `true`.
    *
@@ -10858,6 +11152,8 @@ export const toPubSub: {
   /**
    * Converts a channel to a PubSub for concurrent consumption.
    *
+   * **Details**
+   *
    * `shutdownOnEnd` indicates whether the PubSub should be shut down when the
    * channel ends. By default this is `true`.
    *
@@ -10895,6 +11191,8 @@ export const toPubSub: {
     const pubsub = yield* makePubSub</**
      * Converts a channel to a PubSub for concurrent consumption.
      *
+     * **Details**
+     *
      * `shutdownOnEnd` indicates whether the PubSub should be shut down when the
      * channel ends. By default this is `true`.
      *
@@ -10912,6 +11210,8 @@ export const toPubSub: {
 /**
  * Runs a channel and publishes each output element to a `PubSub`.
  *
+ * **Details**
+ *
  * The channel's output values are published as individual PubSub messages. Use
  * `options.shutdownOnEnd` to shut down the PubSub when channel execution ends.
  *
@@ -10922,6 +11222,8 @@ export const runIntoPubSub: {
   /**
    * Runs a channel and publishes each output element to a `PubSub`.
    *
+   * **Details**
+   *
    * The channel's output values are published as individual PubSub messages. Use
    * `options.shutdownOnEnd` to shut down the PubSub when channel execution ends.
    *
@@ -10939,6 +11241,8 @@ export const runIntoPubSub: {
   /**
    * Runs a channel and publishes each output element to a `PubSub`.
    *
+   * **Details**
+   *
    * The channel's output values are published as individual PubSub messages. Use
    * `options.shutdownOnEnd` to shut down the PubSub when channel execution ends.
    *
@@ -10991,6 +11295,8 @@ const makePubSub = <A>(
  * Converts an array-emitting channel to a scoped `PubSub` for concurrent
  * consumption.
  *
+ * **Details**
+ *
  * Each element inside emitted non-empty arrays is published as an individual
  * PubSub message. `shutdownOnEnd` indicates whether the PubSub should be shut
  * down when the channel ends. By default this is `true`.
@@ -11003,6 +11309,8 @@ export const toPubSubArray: {
    * Converts an array-emitting channel to a scoped `PubSub` for concurrent
    * consumption.
    *
+   * **Details**
+   *
    * Each element inside emitted non-empty arrays is published as an individual
    * PubSub message. `shutdownOnEnd` indicates whether the PubSub should be shut
    * down when the channel ends. By default this is `true`.
@@ -11028,6 +11336,8 @@ export const toPubSubArray: {
    * Converts an array-emitting channel to a scoped `PubSub` for concurrent
    * consumption.
    *
+   * **Details**
+   *
    * Each element inside emitted non-empty arrays is published as an individual
    * PubSub message. `shutdownOnEnd` indicates whether the PubSub should be shut
    * down when the channel ends. By default this is `true`.
@@ -11067,6 +11377,8 @@ export const toPubSubArray: {
      * Converts an array-emitting channel to a scoped `PubSub` for concurrent
      * consumption.
      *
+     * **Details**
+     *
      * Each element inside emitted non-empty arrays is published as an individual
      * PubSub message. `shutdownOnEnd` indicates whether the PubSub should be shut
      * down when the channel ends. By default this is `true`.
@@ -11086,6 +11398,8 @@ export const toPubSubArray: {
  * Runs an array-emitting channel and publishes each array element to a
  * `PubSub`.
  *
+ * **Details**
+ *
  * Each element inside emitted non-empty arrays is published as an individual
  * PubSub message. Use `options.shutdownOnEnd` to shut down the PubSub when
  * channel execution ends.
@@ -11098,6 +11412,8 @@ export const runIntoPubSubArray: {
    * Runs an array-emitting channel and publishes each array element to a
    * `PubSub`.
    *
+   * **Details**
+   *
    * Each element inside emitted non-empty arrays is published as an individual
    * PubSub message. Use `options.shutdownOnEnd` to shut down the PubSub when
    * channel execution ends.
@@ -11117,6 +11433,8 @@ export const runIntoPubSubArray: {
    * Runs an array-emitting channel and publishes each array element to a
    * `PubSub`.
    *
+   * **Details**
+   *
    * Each element inside emitted non-empty arrays is published as an individual
    * PubSub message. Use `options.shutdownOnEnd` to shut down the PubSub when
    * channel execution ends.
@@ -11148,6 +11466,8 @@ export const runIntoPubSubArray: {
 /**
  * Converts a channel to a scoped `PubSub` of `Take` values.
  *
+ * **Details**
+ *
  * Emitted non-empty arrays are published as output `Take` values. When the
  * channel ends, its final `Exit` is published so subscribers can observe
  * completion or failure.
@@ -11159,6 +11479,8 @@ export const toPubSubTake: {
   /**
    * Converts a channel to a scoped `PubSub` of `Take` values.
    *
+   * **Details**
+   *
    * Emitted non-empty arrays are published as output `Take` values. When the
    * channel ends, its final `Exit` is published so subscribers can observe
    * completion or failure.
@@ -11185,6 +11507,8 @@ export const toPubSubTake: {
   /**
    * Converts a channel to a scoped `PubSub` of `Take` values.
    *
+   * **Details**
+   *
    * Emitted non-empty arrays are published as output `Take` values. When the
    * channel ends, its final `Exit` is published so subscribers can observe
    * completion or failure.
@@ -11223,6 +11547,8 @@ export const toPubSubTake: {
     const pubsub = yield* makePubSub</**
      * Converts a channel to a scoped `PubSub` of `Take` values.
      *
+     * **Details**
+     *
      * Emitted non-empty arrays are published as output `Take` values. When the
      * channel ends, its final `Exit` is published so subscribers can observe
      * completion or failure.