effect 4.0.1 → 4.0.2

package/dist/Stream.js

@@ -8,6 +8,7 @@
  * stream lifecycle: create a stream, transform or combine it, control buffering
  * and timing, handle failures, and finally consume it.
  *
+ * @stability stable
  * @since 2.0.0
  */
 // @effect-diagnostics returnEffectInGen:off
@@ -55,6 +56,7 @@ import { isString } from "./String.js";
  *
  * @see {@link isStream} for the public guard that checks this identifier
  *
+ * @stability stable
  * @category type IDs
  * @since 4.0.0
  */
@@ -71,6 +73,7 @@ export const TypeId = "~effect/Stream";
  * Stream.isStream({ data: [1, 2, 3] }) // => false
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 4.0.0
  */
@@ -86,6 +89,7 @@ export const isStream = u => hasProperty(u, TypeId);
  * Stream.DefaultChunkSize // => 4096
  * ```
  *
+ * @stability stable
  * @category constants
  * @since 2.0.0
  */
@@ -103,6 +107,7 @@ export const DefaultChunkSize = Channel.DefaultChunkSize;
  * await Effect.runPromise(Stream.runCollect(stream)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -119,6 +124,7 @@ export const fromChannel = internal.fromChannel;
  * await Effect.runPromise(Stream.runCollect(stream)) // => [42]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -149,6 +155,7 @@ export const fromEffect = effect => fromChannel(Channel.fromEffect(Effect.map(ef
  * ) // => ["Hello, World!"]
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 4.0.0
  */
@@ -190,6 +197,7 @@ export const service = service => fromEffect(Effect.service(service));
  * ) // => ["Hello, World!"]
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 4.0.0
  */
@@ -211,6 +219,7 @@ export const serviceOption = service => fromEffect(Effect.serviceOption(service)
  * drained // => true
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -228,6 +237,7 @@ export const fromEffectDrain = effect => fromPull(Effect.succeed(Effect.flatMap(
  * await Effect.runPromise(Stream.runCollect(stream)) // => [1, 2, 3, 4, 5]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -245,6 +255,7 @@ export const fromEffectRepeat = effect => fromPull(Effect.succeed(Effect.map(eff
  * await Effect.runPromise(Stream.runCollect(stream)) // => ["ping", "ping", "ping"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -276,6 +287,7 @@ export const fromEffectSchedule = (effect, schedule) => fromPull(Effect.gen(func
  * await Effect.runPromise(Stream.tick(0).pipe(Stream.take(3), Stream.runCollect)) // => [undefined, undefined, undefined]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -316,6 +328,7 @@ export const tick = interval => fromPull(Effect.sync(() => {
  * await Effect.runPromise(program) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -335,6 +348,7 @@ export const fromPull = pull => fromChannel(Channel.fromPull(pull));
  * await Effect.runPromise(Stream.runCollect(transformed)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -368,6 +382,7 @@ export const transformPull = (self, f) => fromChannel(Channel.fromTransform((_,
  * finalized // => [true]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -385,6 +400,7 @@ export const transformPullBracket = (self, f) => fromChannel(Channel.fromTransfo
  * values.flat() // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -420,6 +436,7 @@ export const toChannel = stream => stream.channel;
  * await Effect.runPromise(Stream.runCollect(stream)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -435,6 +452,7 @@ export const callback = (f, options) => fromChannel(Channel.callbackArray(f, opt
  * await Effect.runPromise(Stream.runCollect(Stream.empty)) // => []
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -450,6 +468,7 @@ export const empty = /*#__PURE__*/fromChannel(Channel.empty);
  * await Effect.runPromise(Stream.runCollect(Stream.succeed(3))) // => [3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -467,6 +486,7 @@ export const succeed = value => fromChannel(Channel.succeed(Arr.of(value)));
  * await Effect.runPromise(Stream.runCollect(stream)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -486,6 +506,7 @@ export const make = (...values) => fromArray(values);
  * await Effect.runPromise(Stream.sync(() => 2 + 1).pipe(Stream.runCollect)) // => [3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -505,6 +526,7 @@ export const sync = evaluate => fromChannel(Channel.sync(() => Arr.of(evaluate()
  * await Effect.runPromise(Stream.suspend(() => Stream.make(1, 2, 3)).pipe(Stream.runCollect)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -520,6 +542,7 @@ export const suspend = stream => fromChannel(Channel.suspend(() => stream().chan
  * await Effect.runPromise(Effect.exit(Stream.runCollect(Stream.fail("Uh oh!")))) // => Exit.fail("Uh oh!")
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -537,6 +560,7 @@ export const fail = error => fromChannel(Channel.fail(error));
  * await Effect.runPromise(Stream.runCollect(stream).pipe(Effect.exit)) // => Exit.fail("Uh oh!")
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -556,6 +580,7 @@ export const failSync = evaluate => fromChannel(Channel.failSync(evaluate));
  * await Effect.runPromise(Stream.runCollect(stream)) // => ["recovered"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -574,6 +599,7 @@ export const failCause = cause => fromChannel(Channel.failCause(cause));
  * await Effect.runPromise(Effect.exit(Stream.runCollect(stream))) // => Exit.failCause(Cause.die(defect))
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -593,6 +619,7 @@ export const die = defect => fromChannel(Channel.die(defect));
  * await Effect.runPromise(Stream.runCollect(stream).pipe(Effect.exit)) // => Exit.fail("Connection timeout after retries")
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -627,6 +654,7 @@ export const failCauseSync = evaluate => fromChannel(Channel.failCauseSync(evalu
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -656,6 +684,7 @@ export const fromIteratorSucceed = (iterator, maxChunkSize) => fromChannel(Chann
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -696,6 +725,7 @@ export const fromIterable = (iterable, options) => Array.isArray(iterable) && op
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -719,6 +749,7 @@ export const fromIterableEffect = iterable => unwrap(Effect.map(iterable, fromIt
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -740,6 +771,7 @@ export const fromIterableEffectRepeat = iterable => flatMap(fromEffectRepeat(ite
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -766,6 +798,7 @@ export const fromArray = array => Arr.isReadonlyArrayNonEmpty(array) ? fromChann
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -787,6 +820,7 @@ export const fromArrayEffect = effect => unwrap(Effect.map(effect, fromArray));
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -819,6 +853,7 @@ export const fromArrays = (...arrays) => fromChannel(Channel.fromArray(Arr.filte
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -851,6 +886,7 @@ export const fromQueue = queue => fromChannel(Channel.fromQueueArray(queue));
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -883,6 +919,7 @@ export const fromPubSub = pubsub => fromChannel(Channel.fromPubSubArray(pubsub))
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -924,6 +961,7 @@ export const fromPubSubTake = pubsub => fromChannel(Channel.fromPubSubTake(pubsu
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -952,6 +990,7 @@ export const fromReadableStream = options => fromChannel(Channel.fromReadableStr
  *
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -975,6 +1014,7 @@ export const fromAsyncIterable = (iterable, onError) => fromChannel(Channel.from
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1008,6 +1048,7 @@ export const fromSchedule = schedule => fromPull(Effect.map(Schedule.toStepWithS
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1041,6 +1082,7 @@ export const fromSubscription = pubsub => fromChannel(Channel.fromSubscriptionAr
  *
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 3.1.0
  */
@@ -1077,6 +1119,7 @@ export const fromEventListener = (target, type, options) => callback(queue => {
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1117,6 +1160,7 @@ export const unfold = (s, f) => fromPull(Effect.sync(() => {
  * await Effect.runPromise(Stream.runCollect(stream)) // => [0, 1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1154,6 +1198,7 @@ export const paginate = (s, f) => fromPull(Effect.sync(() => {
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1180,6 +1225,7 @@ export const iterate = (value, next) => unfold(value, a => Effect.succeed([a, ne
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1216,6 +1262,7 @@ export const range = (min, max, chunkSize = Channel.DefaultChunkSize) => min > m
  * await Effect.runPromise(program) // => []
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1239,6 +1286,7 @@ export const never = /*#__PURE__*/fromChannel(Channel.never);
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1269,6 +1317,7 @@ export const unwrap = effect => fromChannel(Channel.unwrap(Effect.map(effect, to
  * events // => ["acquire", "release"]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -1285,6 +1334,7 @@ export const scoped = self => fromChannel(Channel.scoped(self.channel));
  * await Effect.runPromise(Stream.runCollect(stream)) // => [1, 3, 5]
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -1313,6 +1363,7 @@ export const map = /*#__PURE__*/dual(2, (self, f) => suspend(() => {
  *
  * @see {@link map} for deriving the replacement value from each element
  *
+ * @stability stable
  * @category mapping
  * @since 4.0.0
  */
@@ -1348,6 +1399,7 @@ export const as = /*#__PURE__*/dual(2, (self, value) => map(self, () => value));
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -1372,6 +1424,7 @@ export const mapBoth = /*#__PURE__*/dual(2, (self, options) => self.pipe(map(opt
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 4.0.0
  */
@@ -1410,6 +1463,7 @@ export const mapArray = /*#__PURE__*/dual(2, (self, f) => fromChannel(Channel.ma
  * events // => ["Processing: 1", "Processing: 2", "Processing: 3"]
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -1437,6 +1491,7 @@ export const mapEffect = /*#__PURE__*/dual(args => isStream(args[0]), (self, f,
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1468,6 +1523,7 @@ export const flattenEffect = /*#__PURE__*/dual(args => isStream(args[0]), (self,
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 4.0.0
  */
@@ -1500,6 +1556,7 @@ export const mapArrayEffect = /*#__PURE__*/dual(2, (self, f) => fromChannel(Chan
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -1528,6 +1585,7 @@ export const result = self => self.pipe(map(Result.succeed), catch_(e => succeed
  * events // => ["before mapping: 1", "after mapping: 2", "before mapping: 2", "after mapping: 4", "before mapping: 3", "after mapping: 6"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1558,6 +1616,7 @@ export const tap = /*#__PURE__*/dual(args => isStream(args[0]), (self, f, option
  * events // => ["seen: 1", "seen: 2", "error: boom"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1589,6 +1648,7 @@ export const tapBoth = /*#__PURE__*/dual(2, (self, options) => self.pipe(tapErro
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1616,15 +1676,20 @@ export const tapSink = /*#__PURE__*/dual(2, (self, sink) => transformPullBracket
     return sinkLatch.open;
   }, true), Effect.forkIn(scope));
   const pullAndOffer = pull.pipe(Effect.flatMap(chunk_ => {
+    // The sink may have exited while the upstream pull was suspended.
+    if (causeSink) return Effect.failCause(causeSink);
+    if (sinkDone) return Effect.succeed(chunk_);
     chunk = chunk_;
     sinkLatch.closeUnsafe();
     upstreamLatch.openUnsafe();
     return Effect.as(sinkLatch.await, chunk_);
   }), Pull.catchDone(() => {
+    if (causeSink) return Effect.failCause(causeSink);
+    if (sinkDone) return Cause.done();
     streamDone = true;
     sinkLatch.closeUnsafe();
     upstreamLatch.openUnsafe();
-    return Effect.flatMap(sinkLatch.await, () => Cause.done());
+    return Effect.flatMap(sinkLatch.await, () => causeSink ? Effect.failCause(causeSink) : Cause.done());
   }));
   return Effect.suspend(() => {
     if (causeSink) {
@@ -1661,6 +1726,7 @@ export const tapSink = /*#__PURE__*/dual(2, (self, sink) => transformPullBracket
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1685,6 +1751,7 @@ export const flatMap = /*#__PURE__*/dual(args => isStream(args[0]), (self, f, op
  * }))
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -1718,6 +1785,7 @@ export const switchMap = /*#__PURE__*/dual(args => isStream(args[0]), (self, f,
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1740,6 +1808,7 @@ export const flatten = /*#__PURE__*/dual(args => isStream(args[0]), (self, optio
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -1760,6 +1829,7 @@ export const flattenArray = self => fromChannel(Channel.flattenArray(self.channe
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1789,6 +1859,7 @@ export const drain = self => fromChannel(Channel.drain(self.channel));
  * events // => ["background task"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -1813,6 +1884,7 @@ export const drainFork = /*#__PURE__*/dual(2, (self, that) => mergeEffect(self,
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -1837,6 +1909,7 @@ export const repeat = /*#__PURE__*/dual(2, (self, schedule) => fromChannel(Chann
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category rate limiting
  * @since 2.0.0
  */
@@ -1861,6 +1934,7 @@ export const schedule = /*#__PURE__*/dual(2, (self, schedule) => self.channel.pi
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category delays & timeouts
  * @since 2.0.0
  */
@@ -1889,6 +1963,7 @@ export const timeout = /*#__PURE__*/dual(2, (self, duration) => timeoutOrElse(se
  *
  * @see {@link timeout} for ending the stream instead of switching to a fallback stream
  *
+ * @stability stable
  * @category delays & timeouts
  * @since 4.0.0
  */
@@ -1950,6 +2025,7 @@ export const timeoutOrElse = /*#__PURE__*/dual(2, (self, options) => {
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -1988,6 +2064,7 @@ export const repeatElements = /*#__PURE__*/dual(2, (self, schedule) => fromChann
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -2009,6 +2086,7 @@ export const forever = self => fromChannel(Channel.forever(self.channel));
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -2036,6 +2114,7 @@ export const flattenIterable = self => flatMap(self, fromIterable);
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -2057,6 +2136,7 @@ export const flattenTake = self => self.channel.pipe(Channel.flattenArray, Chann
  * }))
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -2097,6 +2177,7 @@ function* concatChannels(self, that) {
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -2125,6 +2206,7 @@ export const prepend = /*#__PURE__*/dual(2, (self, values) => concat(fromIterabl
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category merging
  * @since 2.0.0
  */
@@ -2161,6 +2243,7 @@ export const merge = /*#__PURE__*/dual(args => isStream(args[0]) && isStream(arg
  * events // => ["side task"]
  * ```
  *
+ * @stability stable
  * @category merging
  * @since 4.0.0
  */
@@ -2201,6 +2284,7 @@ export const mergeEffect = /*#__PURE__*/dual(2, (self, effect) => self.channel.p
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category merging
  * @since 4.0.0
  */
@@ -2234,6 +2318,7 @@ export const mergeResult = /*#__PURE__*/dual(2, (self, that) => merge(map(self,
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category merging
  * @since 2.0.0
  */
@@ -2272,6 +2357,7 @@ export const mergeLeft = /*#__PURE__*/dual(2, (left, right) => mergeEffect(left,
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category merging
  * @since 2.0.0
  */
@@ -2313,6 +2399,7 @@ export const mergeRight = /*#__PURE__*/dual(2, (left, right) => mergeEffect(righ
  * @see {@link merge} for merging exactly two streams and choosing a halt strategy
  * @see {@link flatten} for flattening a stream that already emits streams
  *
+ * @stability stable
  * @category merging
  * @since 2.0.0
  */
@@ -2340,6 +2427,7 @@ export const mergeAll = /*#__PURE__*/dual(2, (streams, options) => flatten(fromI
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -2369,6 +2457,7 @@ export const cross = /*#__PURE__*/dual(2, (left, right) => crossWith(left, right
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -2394,6 +2483,7 @@ export const crossWith = /*#__PURE__*/dual(3, (left, right, f) => flatMap(left,
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -2436,6 +2526,7 @@ const zipArrays = f => (leftArr, rightArr) => {
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 4.0.0
  */
@@ -2494,6 +2585,7 @@ export const zipWithArray = /*#__PURE__*/dual(3, (left, right, f) => fromChannel
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -2522,6 +2614,7 @@ export const zip = /*#__PURE__*/dual(2, (self, that) => zipWith(self, that, (a,
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -2551,6 +2644,7 @@ export const zipLeft = /*#__PURE__*/dual(2, (left, right) => zipWithArray(left,
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -2589,6 +2683,7 @@ export const zipRight = /*#__PURE__*/dual(2, (left, right) => zipWithArray(left,
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -2612,6 +2707,7 @@ export const zipFlatten = /*#__PURE__*/dual(2, (self, that) => zipWith(self, tha
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -2633,6 +2729,7 @@ export const zipWithIndex = self => map(self, (a, i) => [a, i]);
  * }))
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -2672,6 +2769,7 @@ export const zipWithNext = self => mapAccumArray(self, Option.none, (acc, arr) =
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -2703,6 +2801,7 @@ export const zipWithPrevious = self => mapAccumArray(self, Option.none, (acc, ar
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -2767,6 +2866,7 @@ export const zipWithPreviousAndNext = self => mapAccumArray(self, () => ({
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 3.3.0
  */
@@ -2774,6 +2874,7 @@ export const zipLatestAll = (...streams) => fromChannel(Channel.suspend(() => {
   const latest = [];
   const emitted = new Set();
   const readyLatch = Latch.makeUnsafe();
+  const emptyLatch = Latch.makeUnsafe();
   return Channel.mergeAll(Channel.fromArray(streams.map((s, i) => s.channel.pipe(Channel.flattenArray, Channel.mapEffect(a => {
     latest[i] = a;
     if (!emitted.has(i)) {
@@ -2784,10 +2885,12 @@ export const zipLatestAll = (...streams) => fromChannel(Channel.suspend(() => {
       return Effect.as(readyLatch.open, Arr.of(latest.slice()));
     }
     return Effect.succeed(Arr.of(latest.slice()));
-  }), Channel.filter(isNotUndefined)))), {
+  }), Channel.filter(isNotUndefined),
+  // An input ending without a value makes a complete tuple impossible.
+  Channel.mapDoneEffect(() => emitted.has(i) ? Effect.void : emptyLatch.open)))), {
     concurrency: "unbounded",
     bufferSize: 0
-  });
+  }).pipe(Channel.interruptWhen(emptyLatch.await));
 }));
 /**
  * Combines two streams by emitting each new element with the latest value from the other stream.
@@ -2819,6 +2922,7 @@ export const zipLatestAll = (...streams) => fromChannel(Channel.suspend(() => {
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -2857,6 +2961,7 @@ export const zipLatest = /*#__PURE__*/dual(2, (left, right) => zipLatestAll(left
  * }))
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -2887,6 +2992,7 @@ export const zipLatestWith = /*#__PURE__*/dual(3, (left, right, f) => map(zipLat
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category racing
  * @since 3.5.0
  */
@@ -2935,6 +3041,7 @@ export const raceAll = (...streams) => fromChannel(Channel.fromTransform((_, sco
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category racing
  * @since 3.7.0
  */
@@ -2958,6 +3065,7 @@ export const race = /*#__PURE__*/dual(2, (left, right) => raceAll(left, right));
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -2978,6 +3086,7 @@ export const filter = /*#__PURE__*/dual(2, (self, predicate) => fromChannel(Chan
  * @see {@link filterMapEffect} for an effectful `Filter`
  * @see {@link partition} for consuming both filter success and failure values
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -3000,6 +3109,7 @@ export const filterMap = /*#__PURE__*/dual(2, (self, filter) => fromChannel(Chan
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -3021,6 +3131,7 @@ export const filterEffect = /*#__PURE__*/dual(2, (self, predicate) => fromChanne
  * @see {@link filterEffect} for effectfully keeping original elements
  * @see {@link mapEffect} for effectfully transforming every element
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -3055,6 +3166,7 @@ export const filterMapEffect = /*#__PURE__*/dual(2, (self, filter) => fromChanne
  * await Effect.runPromise(Effect.scoped(program))
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -3103,6 +3215,7 @@ export const partitionQueue = /*#__PURE__*/dual(args => isStream(args[0]), /*#__
   }), Effect.forkIn(scope));
   return [passes, fails];
 }));
+const fromQueueShutdownOnEnd = queue => fromChannel(Channel.fromTransform((_, scope) => Effect.as(Scope.addFinalizer(scope, Queue.shutdown(queue)), Queue.takeAll(queue))));
 /**
  * Splits a stream with an effectful `Filter`, returning scoped streams for
  * filter successes and failures.
@@ -3122,10 +3235,11 @@ export const partitionQueue = /*#__PURE__*/dual(args => isStream(args[0]), /*#__
  * @see {@link partitionQueue} for the lower-level queue result
  * @see {@link filterMapEffect} for effectful filtering that discards failed filter results
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
-export const partitionEffect = /*#__PURE__*/dual(args => isStream(args[0]), (self, filter, options) => Effect.map(partitionQueue(mapEffect(self, a => filter(a), options), result => result, options), ([passes, fails]) => [fromQueue(passes), fromQueue(fails)]));
+export const partitionEffect = /*#__PURE__*/dual(args => isStream(args[0]), (self, filter, options) => Effect.map(partitionQueue(mapEffect(self, a => filter(a), options), result => result, options), ([passes, fails]) => [fromQueueShutdownOnEnd(passes), fromQueueShutdownOnEnd(fails)]));
 /**
  * Splits a stream into scoped passing and failing substreams using a
  * `Filter`.
@@ -3156,12 +3270,13 @@ export const partitionEffect = /*#__PURE__*/dual(args => isStream(args[0]), (sel
  * await Effect.runPromise(Effect.scoped(program))
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
 export const partition = /*#__PURE__*/dual(args => isStream(args[0]), (self, filter, options) => Effect.map(partitionQueue(self, filter, {
   capacity: options?.capacity ?? 16
-}), ([passes, fails]) => [fromQueue(passes), fromQueue(fails)]));
+}), ([passes, fails]) => [fromQueueShutdownOnEnd(passes), fromQueueShutdownOnEnd(fails)]));
 /**
  * Returns the specified stream if the given condition is satisfied, otherwise
  * returns an empty stream.
@@ -3181,6 +3296,7 @@ export const partition = /*#__PURE__*/dual(args => isStream(args[0]), (self, fil
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -3212,6 +3328,7 @@ export const when = /*#__PURE__*/dual(2, (self, test) => test.pipe(Effect.map(pa
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -3222,11 +3339,12 @@ export const peel = /*#__PURE__*/dual(2, /*#__PURE__*/Effect.fnUntraced(function
     cause = cause_;
     return Effect.failCause(cause_);
   });
-  let stream = fromPull(Effect.succeed(pull));
-  const leftover = yield* run(stream, sink);
-  if (cause) return [leftover, empty];
-  stream = fromPull(Effect.succeed(originalPull));
-  return [leftover, stream];
+  const [result, leftover] = yield* Effect.scopedWith(scope => sink.transform(pull, scope));
+  let stream = cause ? empty : fromPull(Effect.succeed(originalPull));
+  if (leftover) {
+    stream = concat(fromArray(leftover), stream);
+  }
+  return [result, stream];
 }));
 /**
  * Buffers up to `capacity` elements so a faster producer can progress
@@ -3255,6 +3373,7 @@ export const peel = /*#__PURE__*/dual(2, /*#__PURE__*/Effect.fnUntraced(function
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category buffering
  * @since 2.0.0
  */
@@ -3286,6 +3405,7 @@ export const buffer = /*#__PURE__*/dual(2, (self, options) => fromChannel(Channe
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category buffering
  * @since 4.0.0
  */
@@ -3317,6 +3437,7 @@ export const bufferArray = /*#__PURE__*/dual(2, (self, options) => fromChannel(C
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -3341,6 +3462,7 @@ export const catchCause = /*#__PURE__*/dual(2, (self, f) => self.channel.pipe(Ch
  * result // => ["recovered: boom"]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3370,6 +3492,7 @@ export const catchDefect = /*#__PURE__*/dual(2, (self, f) => self.channel.pipe(C
  * observations // => [false]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -3397,6 +3520,7 @@ export {
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3425,6 +3549,7 @@ catch_ as catch };
  * errors // => ["boom"]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -3464,6 +3589,7 @@ export const tapError = /*#__PURE__*/dual(2, (self, f) => self.channel.pipe(Chan
  * @see {@link tapError} for peeking at every typed error
  * @see {@link catchTag} for recovering from a tagged error
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3499,6 +3625,7 @@ export const tapErrorTag = /*#__PURE__*/dual(3, (self, k, f) => {
  * @see {@link tapCause} for peeking at the full failure cause
  * @see {@link catchDefect} for recovering from defects
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3536,6 +3663,7 @@ export const tapDefect = /*#__PURE__*/dual(2, (self, f) => tapCause(self, cause
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3559,6 +3687,7 @@ export const catchIf = /*#__PURE__*/dual(args => isStream(args[0]), (self, predi
  * @see {@link catchTags} for `_tag` based recovery from multiple tagged errors
  * @see {@link catchCauseFilter} for filtering full causes
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3593,6 +3722,7 @@ export const catchFilter = /*#__PURE__*/dual(args => isStream(args[0]), (self, f
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -3634,6 +3764,7 @@ export const catchTag = /*#__PURE__*/dual(args => isStream(args[0]), (self, k, f
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -3690,6 +3821,7 @@ export const catchTags = /*#__PURE__*/dual(args => isStream(args[0]), (self, cas
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3732,6 +3864,7 @@ export const catchReason = /*#__PURE__*/dual(args => isStream(args[0]), (self, e
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3784,6 +3917,7 @@ export const catchReasons = /*#__PURE__*/dual(args => isStream(args[0]), (self,
  * @see {@link catchReason} for recovering from a specific reason
  * @see {@link catchReasons} for handling several reasons at once
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3813,6 +3947,7 @@ export const unwrapReason = /*#__PURE__*/dual(2, (self, errorTag) => catchFilter
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -3841,6 +3976,7 @@ export const mapError = /*#__PURE__*/dual(2, (self, f) => fromChannel(Channel.ma
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3865,6 +4001,7 @@ export const catchCauseIf = /*#__PURE__*/dual(3, (self, predicate, f) => fromCha
  * @see {@link catchFilter} for filtering typed error values instead of full causes
  * @see {@link catchCause} for recovering from every cause without filtering
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3888,6 +4025,7 @@ export const catchCauseFilter = /*#__PURE__*/dual(3, (self, filter, f) => fromCh
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -3912,6 +4050,7 @@ export const orElseIfEmpty = /*#__PURE__*/dual(2, (self, orElse) => fromChannel(
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -3936,6 +4075,7 @@ export const orElseSucceed = /*#__PURE__*/dual(2, (self, f) => catch_(self, e =>
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -3987,6 +4127,7 @@ export const orDie = self => fromChannel(Channel.orDie(self.channel));
  *
  * @see {@link ignoreCause} for a variant that also ignores defects, not just typed failures
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -4017,6 +4158,7 @@ export const ignore = /*#__PURE__*/dual(args => isStream(args[0]), (self, option
  *
  * @see {@link ignore} to ignore only typed failures without suppressing defects
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -4051,6 +4193,7 @@ export const ignoreCause = /*#__PURE__*/dual(args => isStream(args[0]), (self, o
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -4109,6 +4252,7 @@ const retryWithoutReset = (self, schedule) => unwrap(Effect.map(Schedule.toStepW
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability unstable
  * @category error handling
  * @since 3.16.0
  */
@@ -4197,6 +4341,7 @@ export const withExecutionPlan = /*#__PURE__*/dual(args => isStream(args[0]), (s
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -4225,6 +4370,7 @@ export const take = /*#__PURE__*/dual(2, (self, n) => {
  * await Effect.runPromise(program) // => [[1, 2]]
  * ```
  *
+ * @stability unstable
  * @category filtering
  * @since 4.0.0
  */
@@ -4266,6 +4412,7 @@ export const limitBytes = /*#__PURE__*/dual(3, (self, bytes, onLimitReached) =>
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -4314,6 +4461,7 @@ export const takeRight = /*#__PURE__*/dual(2, (self, n) => {
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -4355,6 +4503,7 @@ export const takeUntil = /*#__PURE__*/dual(args => isStream(args[0]), (self, pre
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -4394,6 +4543,7 @@ export const takeUntilEffect = /*#__PURE__*/dual(args => isStream(args[0]), (sel
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -4430,6 +4580,7 @@ export const takeWhile = /*#__PURE__*/dual(2, (self, predicate) => transformPull
  * @see {@link filterMap} for filtering across the whole stream instead of only the leading prefix
  * @see {@link dropWhileFilter} for dropping the accepted prefix and keeping the remaining original elements
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -4473,6 +4624,7 @@ export const takeWhileFilter = /*#__PURE__*/dual(2, (self, filter) => transformP
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -4503,6 +4655,7 @@ export const takeWhileEffect = /*#__PURE__*/dual(2, (self, predicate) => takeUnt
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -4538,6 +4691,7 @@ export const drop = /*#__PURE__*/dual(2, (self, n) => {
  * }))
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -4567,6 +4721,7 @@ export const dropUntil = /*#__PURE__*/dual(2, (self, predicate) => drop(dropWhil
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -4590,6 +4745,7 @@ export const dropUntilEffect = /*#__PURE__*/dual(2, (self, predicate) => drop(dr
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -4622,6 +4778,7 @@ export const dropWhile = /*#__PURE__*/dual(2, (self, predicate) => transformPull
  * @see {@link takeWhileFilter} for keeping the accepted prefix as filter success values
  * @see {@link dropWhileEffect} for effectful predicate prefix dropping
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -4654,6 +4811,7 @@ export const dropWhileFilter = /*#__PURE__*/dual(2, (self, filter) => transformP
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -4698,6 +4856,7 @@ export const dropWhileEffect = /*#__PURE__*/dual(2, (self, predicate) => transfo
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -4735,6 +4894,7 @@ export const dropRight = /*#__PURE__*/dual(2, (self, n) => {
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category grouping
  * @since 2.0.0
  */
@@ -4764,6 +4924,7 @@ export const chunks = self => self.channel.pipe(Channel.map(Arr.of), fromChannel
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category grouping
  * @since 2.0.0
  */
@@ -4832,6 +4993,7 @@ export const rechunk = /*#__PURE__*/dual(2, (self, target) => {
  * }))
  * ```
  *
+ * @stability stable
  * @category grouping
  * @since 2.0.0
  */
@@ -4860,6 +5022,7 @@ export const sliding = /*#__PURE__*/dual(2, (self, chunkSize) => slidingSize(sel
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category grouping
  * @since 2.0.0
  */
@@ -4895,8 +5058,8 @@ export const slidingSize = /*#__PURE__*/dual(3, (self, chunkSize, stepSize) => {
         return Effect.succeed(chunks);
       },
       onFailure(cause_) {
-        if (emitted) MutableList.takeNVoid(list, windowSize - step);
-        if (list.length === 0) return Effect.failCause(cause_);
+        // The buffer has already advanced by step after a full window.
+        if (list.length === 0 || emitted && list.length <= windowSize - step) return Effect.failCause(cause_);
         cause = cause_;
         return Effect.succeed(Arr.of(MutableList.takeAll(list)));
       }
@@ -4927,6 +5090,7 @@ export const slidingSize = /*#__PURE__*/dual(3, (self, chunkSize, stepSize) => {
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category grouping
  * @since 2.0.0
  */
@@ -4980,6 +5144,7 @@ export const split = /*#__PURE__*/dual(2, (self, predicate) => mapAccumArray(sel
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category merging
  * @since 2.0.0
  */
@@ -5023,6 +5188,7 @@ export const combine = /*#__PURE__*/dual(4, (self, that, s, f) => Channel.combin
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category merging
  * @since 4.0.0
  */
@@ -5050,6 +5216,7 @@ export const combineArray = /*#__PURE__*/dual(4, (self, that, s, f) => fromChann
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -5094,6 +5261,7 @@ export const mapAccum = /*#__PURE__*/dual(args => isStream(args[0]), (self, init
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 4.0.0
  */
@@ -5142,6 +5310,7 @@ const emptyArr = /*#__PURE__*/Arr.empty();
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -5187,6 +5356,7 @@ export const mapAccumEffect = /*#__PURE__*/dual(args => isStream(args[0]), (self
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 4.0.0
  */
@@ -5215,6 +5385,7 @@ export const mapAccumArrayEffect = /*#__PURE__*/dual(args => isStream(args[0]),
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category accumulation
  * @since 2.0.0
  */
@@ -5247,6 +5418,7 @@ export const scan = /*#__PURE__*/dual(3, (self, initial, f) => suspend(() => {
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category accumulation
  * @since 2.0.0
  */
@@ -5268,6 +5440,7 @@ export const scanEffect = /*#__PURE__*/dual(3, (self, initial, f) => suspend(()
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category rate limiting
  * @since 2.0.0
  */
@@ -5365,6 +5538,7 @@ export const debounce = /*#__PURE__*/dual(2, (self, duration) => transformPull(s
  * }))
  * ```
  *
+ * @stability stable
  * @category rate limiting
  * @since 2.0.0
  */
@@ -5468,6 +5642,7 @@ const throttleShapeEffect = (self, cost, units, duration, burst) => transformPul
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category rate limiting
  * @since 2.0.0
  */
@@ -5500,6 +5675,7 @@ export const throttle = /*#__PURE__*/dual(2, (self, options) => throttleEffect(s
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category grouping
  * @since 2.0.0
  */
@@ -5530,6 +5706,7 @@ export const grouped = /*#__PURE__*/dual(2, (self, n) => chunks(rechunk(self, n)
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category grouping
  * @since 2.0.0
  */
@@ -5562,6 +5739,7 @@ export const groupedWithin = /*#__PURE__*/dual(3, (self, chunkSize, duration) =>
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category grouping
  * @since 2.0.0
  */
@@ -5600,6 +5778,7 @@ export const groupBy = /*#__PURE__*/dual(args => isStream(args[0]), (self, f, op
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category grouping
  * @since 2.0.0
  */
@@ -5633,7 +5812,7 @@ const groupByImpl = (self, f, options) => transformPullBracket(self, Effect.fnUn
       capacity: options?.bufferSize ?? 4096
     }).pipe(Effect.tap(queue => {
       MutableHashMap.set(queueMap, key, queue);
-      return Queue.offer(out, [key, fromQueue(queue)]);
+      return Queue.offer(out, [key, fromQueueShutdownOnEnd(queue)]);
     })), queue => {
       MutableHashMap.remove(queueMap, key);
       return Queue.end(queue);
@@ -5665,6 +5844,7 @@ const groupByImpl = (self, f, options) => transformPullBracket(self, Effect.fnUn
  * @see {@link groupByKey} for grouping all elements with the same key across the stream
  * @see {@link groupBy} for custom grouped stream construction
  *
+ * @stability stable
  * @category grouping
  * @since 2.0.0
  */
@@ -5722,6 +5902,7 @@ export const groupAdjacentBy = /*#__PURE__*/dual(2, (self, f) => transformPull(s
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category aggregation
  * @since 2.0.0
  */
@@ -5770,6 +5951,7 @@ export const transduce = /*#__PURE__*/dual(2, (self, sink) => transformPull(self
  * }))
  * ```
  *
+ * @stability stable
  * @category aggregation
  * @since 2.0.0
  */
@@ -5811,6 +5993,7 @@ export const aggregate = /*#__PURE__*/dual(2, (self, sink) => aggregateWithin(se
  * }))
  * ```
  *
+ * @stability stable
  * @category aggregation
  * @since 2.0.0
  */
@@ -5910,6 +6093,7 @@ export const aggregateWithin = /*#__PURE__*/dual(3, (self, sink, schedule) => fr
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category broadcasting
  * @since 4.0.0
  */
@@ -5958,6 +6142,7 @@ const makePubSub = options => Effect.acquireRelease(options.capacity === "unboun
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category broadcasting
  * @since 2.0.0
  */
@@ -6006,6 +6191,7 @@ export const broadcast = /*#__PURE__*/dual(2, (self, options) => Effect.map(toPu
  * result // => { values: [[1, 2, 3], [1, 2, 3]], acquisitions: 1 }
  * ```
  *
+ * @stability stable
  * @category broadcasting
  * @since 3.8.0
  */
@@ -6044,6 +6230,7 @@ export const share = /*#__PURE__*/dual(2, (self, options) => Effect.map(RcRef.ma
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -6079,6 +6266,7 @@ export const pipeThroughChannel = /*#__PURE__*/dual(2, (self, channel) => fromCh
  * }))
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -6107,6 +6295,7 @@ export const pipeThroughChannelOrFail = /*#__PURE__*/dual(2, (self, channel) =>
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -6129,6 +6318,7 @@ export const pipeThrough = /*#__PURE__*/dual(2, (self, sink) => self.channel.pip
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category accumulation
  * @since 4.0.0
  */
@@ -6154,6 +6344,7 @@ export const collect = self => fromEffect(runCollect(self));
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category accumulation
  * @since 2.0.0
  */
@@ -6181,6 +6372,7 @@ export const accumulate = self => mapAccumArray(self, Arr.empty, (acc, as) => {
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category deduplication
  * @since 2.0.0
  */
@@ -6205,6 +6397,7 @@ export const changes = self => changesWith(self, Equal.equals);
  * )
  * ```
  *
+ * @stability stable
  * @category deduplication
  * @since 2.0.0
  */
@@ -6252,6 +6445,7 @@ export const changesWith = /*#__PURE__*/dual(2, (self, f) => transformPull(self,
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category deduplication
  * @since 2.0.0
  */
@@ -6301,6 +6495,7 @@ export const changesWithEffect = /*#__PURE__*/dual(2, (self, f) => transformPull
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category text
  * @since 2.0.0
  */
@@ -6329,6 +6524,7 @@ export const decodeText = /*#__PURE__*/dual(args => isStream(args[0]), (self, op
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category text
  * @since 2.0.0
  */
@@ -6352,6 +6548,7 @@ export const encodeText = self => suspend(() => {
  * }))
  * ```
  *
+ * @stability stable
  * @category text
  * @since 2.0.0
  */
@@ -6373,6 +6570,7 @@ export const splitLines = self => self.channel.pipe(Channel.pipeTo(Channel.split
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -6412,6 +6610,7 @@ export const intersperse = /*#__PURE__*/dual(2, (self, element) => mapArray(self
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -6439,6 +6638,7 @@ export const intersperseAffixes = /*#__PURE__*/dual(2, (self, options) => succee
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category merging
  * @since 2.0.0
  */
@@ -6471,6 +6671,7 @@ export const interleave = /*#__PURE__*/dual(2, (self, that) => interleaveWith(se
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category merging
  * @since 2.0.0
  */
@@ -6535,6 +6736,7 @@ export const interleaveWith = /*#__PURE__*/dual(3, (self, that, decider) => from
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -6576,6 +6778,7 @@ export const interruptWhen = /*#__PURE__*/dual(2, (self, effect) => fromChannel(
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -6603,6 +6806,7 @@ export const haltWhen = /*#__PURE__*/dual(2, (self, effect) => fromChannel(Chann
  * exits // => ["success"]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -6634,6 +6838,7 @@ export const onExit = /*#__PURE__*/dual(2, (self, finalizer) => fromChannel(Chan
  * errors // => ["boom"]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -6660,6 +6865,7 @@ export const onError = /*#__PURE__*/dual(2, (self, cleanup) => fromChannel(Chann
  * events // => ["started"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 3.6.0
  */
@@ -6682,6 +6888,7 @@ export const onStart = /*#__PURE__*/dual(2, (self, onStart) => fromChannel(Chann
  * first // => [1]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -6707,6 +6914,7 @@ export const onFirst = /*#__PURE__*/dual(2, (self, onFirst) => fromChannel(Chann
  * events // => ["ended"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 3.6.0
  */
@@ -6733,6 +6941,7 @@ export const onEnd = /*#__PURE__*/dual(2, (self, onEnd) => fromChannel(Channel.o
  * events // => ["cleanup"]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -6763,6 +6972,7 @@ export const ensuring = /*#__PURE__*/dual(2, (self, finalizer) => fromChannel(Ch
  * await Effect.runPromise(Stream.runCollect(withEnv)) // => ["Hello, Ada"]
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -6798,6 +7008,7 @@ export const provide = /*#__PURE__*/dual(args => isStream(args[0]), (self, layer
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -6835,6 +7046,7 @@ export const provideContext = /*#__PURE__*/dual(2, (self, context) => fromChanne
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -6870,6 +7082,7 @@ export const provideService = /*#__PURE__*/dual(3, (self, key, service) => fromC
  * events // => ["loading"]
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -6910,6 +7123,7 @@ export const provideServiceEffect = /*#__PURE__*/dual(3, (self, key, service) =>
  * )
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -6936,6 +7150,7 @@ export const updateContext = /*#__PURE__*/dual(2, (self, f) => fromChannel(Chann
  * await Effect.runPromise(Effect.provideService(program, Counter, { count: 0 }))
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -6958,6 +7173,7 @@ export const updateService = /*#__PURE__*/dual(3, (self, service, f) => updateCo
  * )
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -6993,6 +7209,7 @@ export const withSpan = function () {
  * await Effect.runPromise(effect)
  * ```
  *
+ * @stability stable
  * @category do notation
  * @since 2.0.0
  */
@@ -7023,6 +7240,7 @@ export {
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category do notation
  * @since 2.0.0
  */
@@ -7045,6 +7263,7 @@ let_ as let };
  * await Effect.runPromise(result) // => [{ a: 1, b: 2 }, { a: 2, b: 3 }]
  * ```
  *
+ * @stability stable
  * @category do notation
  * @since 2.0.0
  */
@@ -7073,6 +7292,7 @@ export const bind = /*#__PURE__*/dual(args => isStream(args[0]), (self, name, f,
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category do notation
  * @since 2.0.0
  */
@@ -7093,6 +7313,7 @@ export const bindEffect = /*#__PURE__*/dual(args => isStream(args[0]), (self, na
  * await Effect.runPromise(Stream.runCollect(stream)) // => [{ value: 1 }, { value: 2 }, { value: 3 }]
  * ```
  *
+ * @stability stable
  * @category do notation
  * @since 2.0.0
  */
@@ -7112,6 +7333,7 @@ export const bindTo = /*#__PURE__*/dual(2, (self, name) => map(self, a => ({
  * await Effect.runPromise(program) // => 6
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -7134,6 +7356,7 @@ export const run = /*#__PURE__*/dual(2, (self, sink) => Effect.scopedWith(scope
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -7161,6 +7384,7 @@ export const runCollect = self => Channel.runFold(self.channel, () => [], (acc,
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -7181,6 +7405,7 @@ export const runCount = self => Channel.runFold(self.channel, () => 0, (acc, chu
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -7210,6 +7435,7 @@ export const runSum = self => Channel.runFold(self.channel, () => 0, (acc, chunk
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -7244,6 +7470,7 @@ export const runFold = /*#__PURE__*/dual(3, (self, initial, f) => Channel.runFol
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -7275,6 +7502,7 @@ export const runFoldEffect = /*#__PURE__*/dual(3, (self, initial, f) => Channel.
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -7300,6 +7528,7 @@ export const runHead = self => Effect.map(Channel.runHead(self.channel), Option.
  * @see {@link runCollect} for collecting every emitted element
  * @see {@link runDrain} for consuming the stream while discarding emitted elements
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -7323,6 +7552,7 @@ export const runLast = self => Effect.map(Channel.runLast(self.channel), Option.
  * values // => ["Processing: 1", "Processing: 2", "Processing: 3"]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -7359,6 +7589,7 @@ export const runForEach = /*#__PURE__*/dual(2, (self, f) => Channel.runForEach(s
  * values // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -7395,6 +7626,7 @@ export const runForEachWhile = /*#__PURE__*/dual(2, (self, f) => Channel.runForE
  * chunks // => ["1, 2, 3, 4, 5"]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -7420,6 +7652,7 @@ export const runForEachArray = /*#__PURE__*/dual(2, (self, f) => Channel.runForE
  * values // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -7450,6 +7683,7 @@ export const runDrain = self => Channel.runDrain(self.channel);
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -7471,6 +7705,7 @@ export const toPull = self => Channel.toPull(self.channel);
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -7499,6 +7734,7 @@ export const mkString = self => Channel.runFold(self.channel, () => "", (acc, ch
  * await Effect.runPromise(program) // => [1, 2, 3, 4]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -7525,6 +7761,7 @@ export const mkArrayBuffer = self => Effect.map(Channel.mkUint8Array(self.channe
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -7552,6 +7789,7 @@ export const mkUint8Array = self => Channel.mkUint8Array(self.channel);
  * values // => [ 1, 2, 3, 4, 5 ]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -7606,6 +7844,7 @@ export const toReadableStreamWith = /*#__PURE__*/dual(args => isStream(args[0]),
  * values // => [ 1, 2, 3 ]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -7637,6 +7876,7 @@ export const toReadableStream = /*#__PURE__*/dual(args => isStream(args[0]), (se
  * await Effect.runPromise(effect)
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -7660,6 +7900,7 @@ export const toReadableStreamEffect = /*#__PURE__*/dual(args => isStream(args[0]
  * await Array.fromAsync(iterable) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -7750,6 +7991,7 @@ export const toAsyncIterableWith = /*#__PURE__*/dual(2, (self, context) => ({
  * await Effect.runPromise(program) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 3.15.0
  */
@@ -7767,6 +8009,7 @@ export const toAsyncIterableEffect = self => Effect.map(Effect.context(), contex
  * await Array.fromAsync(Stream.toAsyncIterable(stream)) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 3.15.0
  */
@@ -7800,6 +8043,7 @@ export const toAsyncIterable = self => toAsyncIterableWith(self, Context.empty()
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -7829,6 +8073,7 @@ export const runIntoPubSub = /*#__PURE__*/dual(args => isStream(args[0]), (self,
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -7861,6 +8106,7 @@ export const toPubSub = /*#__PURE__*/dual(2, (self, options) => Channel.toPubSub
  * await Effect.runPromise(Effect.scoped(program))
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 4.0.0
  */
@@ -7888,6 +8134,7 @@ export const toPubSubTake = /*#__PURE__*/dual(2, (self, options) => Channel.toPu
  * await Effect.runPromise(Effect.scoped(program))
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */
@@ -7921,6 +8168,7 @@ export const toQueue = /*#__PURE__*/dual(2, (self, options) => Channel.toQueueAr
  * await Effect.runPromise(program)
  * ```
  *
+ * @stability stable
  * @category destructors
  * @since 2.0.0
  */