effect 3.13.9 → 3.13.11

package/dist/esm/Stream.js

@@ -51,7 +51,7 @@ export const accumulateChunks = internal.accumulateChunks;
  *   (file) => file.close
  * ).pipe(Stream.flatMap((file) => file.getLines))
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // Opening file.txt
  * // Closing file.txt
  * // { _id: 'Chunk', values: [ [ 'Line 1', 'Line 2', 'Line 3' ] ] }
@@ -110,7 +110,7 @@ export const aggregateWithinEither = internal.aggregateWithinEither;
  *
  * const stream = Stream.range(1, 5).pipe(Stream.as(null))
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ null, null, null, null, null ] }
  * ```
  *
@@ -149,7 +149,7 @@ export {
  *   }
  * )
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2 ] }
  *
  * ```
@@ -254,7 +254,7 @@ export const branchAfter = internal.branchAfter;
  *   )
  * )
  *
- * // Effect.runPromise(numbers).then(console.log)
+ * Effect.runPromise(numbers).then(console.log)
  * // Emit 1 element before broadcasting
  * // Emit 2 element before broadcasting
  * // Emit 3 element before broadcasting
@@ -362,7 +362,7 @@ export const broadcastedQueuesDynamic = internal.broadcastedQueuesDynamic;
  *   Stream.schedule(Schedule.spaced("5 seconds"))
  * )
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // before buffering: 1
  * // before buffering: 2
  * // before buffering: 3
@@ -455,7 +455,7 @@ export const catchSomeCause = internal.catchSomeCause;
  *
  * const stream = Stream.make(1, 1, 1, 2, 2, 3, 4).pipe(Stream.changes)
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3, 4 ] }
  * ```
  *
@@ -536,7 +536,7 @@ export const combineChunks = internal.combineChunks;
  *
  * const stream = Stream.concat(s1, s2)
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3, 4, 5 ] }
  * ```
  *
@@ -557,7 +557,7 @@ export const concat = internal.concat;
  *
  * const stream = Stream.concatAll(Chunk.make(s1, s2, s3))
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // {
  * //   _id: 'Chunk',
  * //   values: [
@@ -587,7 +587,7 @@ export const concatAll = internal.concatAll;
  *
  * const product = Stream.cross(s1, s2)
  *
- * // Effect.runPromise(Stream.runCollect(product)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(product)).then(console.log)
  * // {
  * //   _id: "Chunk",
  * //   values: [
@@ -671,7 +671,7 @@ export const crossWith = internal.crossWith;
  *   Stream.tap((n) => log(`> Emitted ${n}`))
  * )
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // Received 1 after 5ms
  * // Received 2 after 2ms
  * // Received 3 after 0ms
@@ -743,7 +743,7 @@ export const distributedWithDynamic = internal.distributedWithDynamic;
  * // We create a stream and immediately drain it.
  * const stream = Stream.range(1, 6).pipe(Stream.drain)
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [] }
  * ```
  *
@@ -828,7 +828,7 @@ export const either = internal.either;
  *
  * const stream = Stream.empty
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [] }
  * ```
  *
@@ -850,7 +850,7 @@ export const empty = internal.empty;
  *   )
  * )
  *
- * // Effect.runPromise(Stream.runCollect(program)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(program)).then(console.log)
  * // Application Logic.
  * // Finalizing the stream
  * // Doing some other works after stream's finalization
@@ -954,7 +954,7 @@ export const failCauseSync = internal.failCauseSync;
  *
  * const stream = Stream.range(1, 11).pipe(Stream.filter((n) => n % 2 === 0))
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 2, 4, 6, 8, 10 ] }
  * ```
  *
@@ -1021,7 +1021,7 @@ export const filterMapWhileEffect = internal.filterMapWhileEffect;
  *   )
  * )
  *
- * // Effect.runPromise(Stream.runCollect(program)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(program)).then(console.log)
  * // Application Logic.
  * // Deleting dir: tmp
  * // Temporary directory was deleted.
@@ -1127,7 +1127,7 @@ export const forever = internal.forever;
  *   (e) => new Error(String(e)) // Error Handling
  * )
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2 ] }
  * ```
  *
@@ -1159,7 +1159,7 @@ export const toChannel = internal.toChannel;
  * // Creating a stream with values from a single Chunk
  * const stream = Stream.fromChunk(Chunk.make(1, 2, 3))
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3 ] }
  * ```
  *
@@ -1199,7 +1199,7 @@ export const fromChunkQueue = internal.fromChunkQueue;
  * // Creating a stream with values from multiple Chunks
  * const stream = Stream.fromChunks(Chunk.make(1, 2, 3), Chunk.make(4, 5, 6))
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3, 4, 5, 6 ] }
  * ```
  *
@@ -1217,7 +1217,7 @@ export const fromChunks = internal.fromChunks;
  *
  * const stream = Stream.fromEffect(Random.nextInt)
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // Example Output: { _id: 'Chunk', values: [ 922694024 ] }
  * ```
  *
@@ -1262,7 +1262,7 @@ export const fromTPubSub = internal.fromTPubSub;
  *
  * const stream = Stream.fromIterable(numbers)
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3 ] }
  * ```
  *
@@ -1286,9 +1286,9 @@ export const fromIterable = internal.fromIterable;
  *
  * const stream = Stream.fromIterableEffect(getUsers)
  *
- * // Effect.runPromise(
- * //   Stream.runCollect(stream.pipe(Stream.provideService(Database, { getUsers: Effect.succeed(["user1", "user2"]) })))
- * // ).then(console.log)
+ * Effect.runPromise(
+ *   Stream.runCollect(stream.pipe(Stream.provideService(Database, { getUsers: Effect.succeed(["user1", "user2"]) })))
+ * ).then(console.log)
  * // { _id: 'Chunk', values: [ 'user1', 'user2' ] }
  * ```
  *
@@ -1365,7 +1365,7 @@ export const fromReadableStreamByob = internal.fromReadableStreamByob;
  *
  * const stream = Stream.fromSchedule(schedule)
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4 ] }
  * ```
  *
@@ -1408,7 +1408,7 @@ export const groupAdjacentBy = internal.groupAdjacentBy;
  *     )
  *   ))
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // {
  * //   _id: 'Chunk',
  * //   values: [ [ 'M', 1 ], [ 'J', 3 ], [ 'R', 2 ], [ 'P', 2 ] ]
@@ -1464,7 +1464,7 @@ export const groupByKey = groupBy_.groupByKey;
  *
  * const stream = Stream.range(0, 8).pipe(Stream.grouped(3))
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then((chunks) => console.log("%o", chunks))
+ * Effect.runPromise(Stream.runCollect(stream)).then((chunks) => console.log("%o", chunks))
  * // {
  * //   _id: 'Chunk',
  * //   values: [
@@ -1494,7 +1494,7 @@ export const grouped = internal.grouped;
  *   Stream.take(3)
  * )
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then((chunks) => console.log(Chunk.toArray(chunks)))
+ * Effect.runPromise(Stream.runCollect(stream)).then((chunks) => console.log(Chunk.toArray(chunks)))
  * // [
  * //   {
  * //     _id: 'Chunk',
@@ -1583,7 +1583,7 @@ export const identity = internal.identityStream;
  *
  * const stream = Stream.interleave(s1, s2)
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 4, 2, 5, 3, 6 ] }
  * ```
  * @since 2.0.0
@@ -1610,7 +1610,7 @@ export const interleave = internal.interleave;
  *
  * const stream = Stream.interleaveWith(s1, s2, booleanStream)
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // {
  * //   _id: 'Chunk',
  * //   values: [
@@ -1633,7 +1633,7 @@ export const interleaveWith = internal.interleaveWith;
  *
  * const stream = Stream.make(1, 2, 3, 4, 5).pipe(Stream.intersperse(0))
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // {
  * //   _id: 'Chunk',
  * //   values: [
@@ -1662,7 +1662,7 @@ export const intersperse = internal.intersperse;
  *   })
  * )
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // {
  * //   _id: 'Chunk',
  * //   values: [
@@ -1720,7 +1720,7 @@ export const interruptWhenDeferred = internal.interruptWhenDeferred;
  * // An infinite Stream of numbers starting from 1 and incrementing
  * const stream = Stream.iterate(1, (n) => n + 1)
  *
- * // Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(10)))).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(10)))).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ] }
  * ```
  *
@@ -1737,7 +1737,7 @@ export const iterate = internal.iterate;
  *
  * const stream = Stream.make(1, 2, 3)
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3 ] }
  * ```
  *
@@ -1754,7 +1754,7 @@ export const make = internal.make;
  *
  * const stream = Stream.make(1, 2, 3).pipe(Stream.map((n) => n + 1))
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 2, 3, 4 ] }
  * ```
  *
@@ -1773,9 +1773,9 @@ export const map = internal.map;
  *   stream.pipe(Stream.mapAccum(0, (s, a) => [s + a, s + a]))
  *
  * // input:  0, 1, 2, 3, 4, 5, 6
- * // Effect.runPromise(Stream.runCollect(runningTotal(Stream.range(0, 6)))).then(
- * //   console.log
- * // )
+ * Effect.runPromise(Stream.runCollect(runningTotal(Stream.range(0, 6)))).then(
+ *   console.log
+ * )
  * // { _id: "Chunk", values: [ 0, 1, 3, 6, 10, 15, 21 ] }
  * ```
  *
@@ -1826,7 +1826,7 @@ export const mapChunksEffect = internal.mapChunksEffect;
  *   Stream.map((s) => parseInt(s))
  * )
  *
- * // Effect.runPromise(Stream.runCollect(numbers)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(numbers)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3, 4, 5, 6 ] }
  * ```
  *
@@ -1869,7 +1869,7 @@ export const mapConcatEffect = internal.mapConcatEffect;
  *   Stream.mapEffect((n) => Random.nextIntBetween(0, n))
  * )
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // Example Output: { _id: 'Chunk', values: [ 7, 19, 8 ] }
  * ```
  *
@@ -1910,7 +1910,7 @@ export const mapErrorCause = internal.mapErrorCause;
  *
  * const stream = Stream.merge(s1, s2)
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 4, 2, 3, 5, 6 ] }
  * ```
  *
@@ -1966,7 +1966,7 @@ export const mergeWithTag = internal.mergeWithTag;
  *   onOther: (n) => Math.floor(n)
  * })
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 4, 2, 3, 5, 6 ] }
  * ```
  *
@@ -2069,7 +2069,7 @@ export const onDone = internal.onDone;
  *   Stream.tap((n) => Console.log(`after mapping: ${n}`))
  * )
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // Stream started
  * // after mapping: 2
  * // after mapping: 4
@@ -2166,7 +2166,7 @@ export const orElseSucceed = internal.orElseSucceed;
  *   n < 3 ? Option.some(n + 1) : Option.none()
  * ])
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 0, 1, 2, 3 ] }
  * ```
  *
@@ -2213,12 +2213,9 @@ export const paginateEffect = internal.paginateEffect;
  * The faster stream may advance up to `bufferSize` elements ahead of the slower
  * one.
  *
- * @see {@link partitionEither} for partitioning a stream based on effectful
- * conditions.
+ * **Example** (Partitioning a Stream into Even and Odd Numbers)
  *
- * @example
  * ```ts
- * // Title: Partitioning a Stream into Even and Odd Numbers
  * import { Effect, Stream } from "effect"
  *
  * const partition = Stream.range(1, 9).pipe(
@@ -2233,11 +2230,14 @@ export const paginateEffect = internal.paginateEffect;
  *   })
  * )
  *
- * // Effect.runPromise(program)
+ * Effect.runPromise(program)
  * // { _id: 'Chunk', values: [ 1, 3, 5, 7, 9 ] }
  * // { _id: 'Chunk', values: [ 2, 4, 6, 8 ] }
  * ```
  *
+ * @see {@link partitionEither} for partitioning a stream based on effectful
+ * conditions.
+ *
  * @since 2.0.0
  * @category utils
  */
@@ -2256,11 +2256,9 @@ export const partition = internal.partition;
  * The faster stream may advance up to `bufferSize` elements ahead of the slower
  * one.
  *
- * @see {@link partition} for partitioning a stream based on simple conditions.
+ * **Example** (Partitioning a Stream with an Effectful Predicate)
  *
- * @example
  * ```ts
- * // Title: Partitioning a Stream with an Effectful Predicate
  * import { Effect, Either, Stream } from "effect"
  *
  * const partition = Stream.range(1, 9).pipe(
@@ -2278,11 +2276,13 @@ export const partition = internal.partition;
  *   })
  * )
  *
- * // Effect.runPromise(program)
+ * Effect.runPromise(program)
  * // { _id: 'Chunk', values: [ 1, 3, 5, 7, 9 ] }
  * // { _id: 'Chunk', values: [ 2, 4, 6, 8 ] }
  * ```
  *
+ * @see {@link partition} for partitioning a stream based on simple conditions.
+ *
  * @since 2.0.0
  * @category utils
  */
@@ -2451,7 +2451,7 @@ export const raceAll = internal.raceAll;
  * // A Stream with a range of numbers from 1 to 5
  * const stream = Stream.range(1, 5)
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3, 4, 5 ] }
  * ```
  *
@@ -2492,7 +2492,7 @@ export const refineOrDieWith = internal.refineOrDieWith;
  *
  * const stream = Stream.repeat(Stream.succeed(1), Schedule.forever)
  *
- * // Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 1, 1, 1, 1 ] }
  * ```
  *
@@ -2510,7 +2510,7 @@ export const repeat = internal.repeat;
  *
  * const stream = Stream.repeatEffect(Random.nextInt)
  *
- * // Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
  * // Example Output: { _id: 'Chunk', values: [ 3891571149, 4239494205, 2352981603, 2339111046, 1488052210 ] }
  * ```
  *
@@ -2613,7 +2613,7 @@ export const repeatElementsWith = internal.repeatElementsWith;
  *
  * const stream = Stream.repeatValue(0)
  *
- * // Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
  * // { _id: 'Chunk', values: [ 0, 0, 0, 0, 0 ] }
  * ```
  *
@@ -2863,7 +2863,7 @@ export const runSum = internal.runSum;
  *
  * const stream = Stream.range(1, 6).pipe(Stream.scan(0, (a, b) => a + b))
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 0,  1,  3, 6, 10, 15, 21 ] }
  * ```
  *
@@ -2932,7 +2932,7 @@ export const scheduleWith = internal.scheduleWith;
  *  Stream.flatMap(() => Console.log("use"))
  * )
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // acquire
  * // use
  * // release
@@ -3041,7 +3041,7 @@ export const splitLines = internal.splitLines;
  * // A Stream with a single number
  * const stream = Stream.succeed(3)
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 3 ] }
  * ```
  *
@@ -3072,7 +3072,7 @@ export const suspend = internal.suspend;
  *
  * const stream = Stream.take(Stream.iterate(0, (n) => n + 1), 5)
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4 ] }
  * ```
  *
@@ -3089,7 +3089,7 @@ export const take = internal.take;
  *
  * const stream = Stream.takeRight(Stream.make(1, 2, 3, 4, 5, 6), 3)
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 4, 5, 6 ] }
  * ```
  *
@@ -3107,7 +3107,7 @@ export const takeRight = internal.takeRight;
  *
  * const stream = Stream.takeUntil(Stream.iterate(0, (n) => n + 1), (n) => n === 4)
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4 ] }
  * ```
  *
@@ -3133,7 +3133,7 @@ export const takeUntilEffect = internal.takeUntilEffect;
  *
  * const stream = Stream.takeWhile(Stream.iterate(0, (n) => n + 1), (n) => n < 5)
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4 ] }
  * ```
  *
@@ -3154,7 +3154,7 @@ export const takeWhile = internal.takeWhile;
  *   Stream.tap((n) => Console.log(`after mapping: ${n}`))
  * )
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // before mapping: 1
  * // after mapping: 2
  * // before mapping: 2
@@ -3235,7 +3235,7 @@ export const tapSink = internal.tapSink;
  *   Stream.tap((n) => log(`> Emitted ${n}`))
  * )
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // Received 0 after 56ms
  * // > Emitted 0 after 0ms
  * // Received 1 after 52ms
@@ -3289,7 +3289,7 @@ export const throttleEffect = internal.throttleEffect;
  *
  * const stream = Stream.tick("1 seconds").pipe(Stream.tap(() => log("tick")))
  *
- * // Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
  * // tick after 4ms
  * // tick after 1003ms
  * // tick after 1001ms
@@ -3365,7 +3365,7 @@ export const toPubSub = internal.toPubSub;
  *   }
  * })
  *
- * // Effect.runPromise(Effect.scoped(program)).then(console.log, console.error)
+ * Effect.runPromise(Effect.scoped(program)).then(console.log, console.error)
  * // { _id: 'Chunk', values: [ 1, 2 ] }
  * // { _id: 'Chunk', values: [ 3, 4 ] }
  * // { _id: 'Chunk', values: [ 5 ] }
@@ -3442,7 +3442,7 @@ export const transduce = internal.transduce;
  *
  * const stream = Stream.unfold(1, (n) => Option.some([n, n + 1]))
  *
- * // Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3, 4, 5 ] }
  * ```
  *
@@ -3478,7 +3478,7 @@ export const unfoldChunkEffect = internal.unfoldChunkEffect;
  *     Effect.map((b) => (b ? Option.some([n, -n]) : Option.some([n, n])))
  *   ))
  *
- * // Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
  * // { _id: 'Chunk', values: [ 1, -1, -1, -1, -1 ] }
  * ```
  *
@@ -3497,7 +3497,7 @@ export {
  *
  * const stream = Stream.void
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ undefined ] }
  *
  * ```
@@ -3590,7 +3590,7 @@ export const withSpan = internal.withSpan;
  *   Stream.make("a", "b", "c")
  * )
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ [ 1, 'a' ], [ 2, 'b' ], [ 3, 'c' ] ] }
  * ```
  *
@@ -3625,7 +3625,7 @@ export const zipFlatten = internal.zipFlatten;
  *   defaultOther: "x"
  * })
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: "Chunk", values: [ [ 1, "a" ], [ 2, "b" ], [ 3, "c" ], [ 4, "x" ], [ 5, "x" ], [ 6, "x" ] ] }
  * ```
  *
@@ -3731,7 +3731,7 @@ export const zipAllSortedByKeyWith = internal.zipAllSortedByKeyWith;
  *   onBoth: (n, s) => [n - s.length, s]
  * })
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: "Chunk", values: [ [ 0, "a" ], [ 1, "b" ], [ 2, "c" ], [ 4, "x" ], [ 5, "x" ], [ 6, "x" ] ] }
  * ```
  *
@@ -3762,7 +3762,7 @@ export const zipAllWith = internal.zipAllWith;
  *
  * const stream = Stream.zipLatest(s1, s2)
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: "Chunk", values: [ [ 1, "a" ], [ 1, "b" ], [ 2, "b" ], [ 2, "c" ], [ 2, "d" ], [ 3, "d" ] ] }
  * ```
  *
@@ -3788,7 +3788,7 @@ export const zipLatest = internal.zipLatest;
  *     Stream.fromSchedule(Schedule.spaced('4 millis')),
  * ).pipe(Stream.take(6), Stream.tap(Console.log))
  *
- * // Effect.runPromise(Stream.runDrain(stream))
+ * Effect.runPromise(Stream.runDrain(stream))
  * // Output:
  * // [ 0, 0, 0 ]
  * // [ 1, 0, 0 ]
@@ -3853,7 +3853,7 @@ export const zipRight = internal.zipRight;
  *   (n, s) => [n - s.length, s]
  * )
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ [ 0, 'a' ], [ 1, 'b' ], [ 2, 'c' ] ] }
  * ```
  *
@@ -3880,7 +3880,7 @@ export const zipWithChunks = internal.zipWithChunks;
  *
  * const stream = Stream.zipWithNext(Stream.make(1, 2, 3, 4))
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then((chunk) => console.log(Chunk.toArray(chunk)))
+ * Effect.runPromise(Stream.runCollect(stream)).then((chunk) => console.log(Chunk.toArray(chunk)))
  * // [
  * //   [ 1, { _id: 'Option', _tag: 'Some', value: 2 } ],
  * //   [ 2, { _id: 'Option', _tag: 'Some', value: 3 } ],
@@ -3903,7 +3903,7 @@ export const zipWithNext = internal.zipWithNext;
  *
  * const stream = Stream.zipWithPrevious(Stream.make(1, 2, 3, 4))
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then((chunk) => console.log(Chunk.toArray(chunk)))
+ * Effect.runPromise(Stream.runCollect(stream)).then((chunk) => console.log(Chunk.toArray(chunk)))
  * // [
  * //   [ { _id: 'Option', _tag: 'None' }, 1 ],
  * //   [ { _id: 'Option', _tag: 'Some', value: 1 }, 2 ],
@@ -3925,7 +3925,7 @@ export const zipWithPrevious = internal.zipWithPrevious;
  *
  * const stream = Stream.zipWithPreviousAndNext(Stream.make(1, 2, 3, 4))
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then((chunk) => console.log(Chunk.toArray(chunk)))
+ * Effect.runPromise(Stream.runCollect(stream)).then((chunk) => console.log(Chunk.toArray(chunk)))
  * // [
  * //   [
  * //     { _id: 'Option', _tag: 'None' },
@@ -3965,7 +3965,7 @@ export const zipWithPreviousAndNext = internal.zipWithPreviousAndNext;
  *
  * const indexedStream = Stream.zipWithIndex(stream)
  *
- * // Effect.runPromise(Stream.runCollect(indexedStream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(indexedStream)).then(console.log)
  * // {
  * //   _id: 'Chunk',
  * //   values: [ [ 'Mary', 0 ], [ 'James', 1 ], [ 'Robert', 2 ], [ 'Patricia', 3 ] ]
@@ -3989,11 +3989,6 @@ export const zipWithIndex = internal.zipWithIndex;
  * 3. You can accumulate multiple `bind` statements to define multiple variables within the scope
  * 4. Inside the do simulation scope, you can also use the `let` function to define variables and bind them to simple values
  *
- * @see {@link bindTo}
- * @see {@link bind}
- * @see {@link bindEffect}
- * @see {@link let_ let}
- *
  * @example
  * ```ts
  * import * as assert from "node:assert"
@@ -4008,6 +4003,11 @@ export const zipWithIndex = internal.zipWithIndex;
  * assert.deepStrictEqual(Effect.runSync(Stream.runCollect(result)), Chunk.of({ x: 2, y: 3, sum: 5 }))
  * ```
  *
+ * @see {@link bindTo}
+ * @see {@link bind}
+ * @see {@link bindEffect}
+ * @see {@link let_ let}
+ *
  * @category do notation
  * @since 2.0.0
  */
@@ -4022,11 +4022,6 @@ export const Do = internal.Do;
  * 3. You can accumulate multiple `bind` statements to define multiple variables within the scope
  * 4. Inside the do simulation scope, you can also use the `let` function to define variables and bind them to simple values
  *
- * @see {@link Do}
- * @see {@link bindTo}
- * @see {@link bindEffect}
- * @see {@link let_ let}
- *
  * @example
  * ```ts
  * import * as assert from "node:assert"
@@ -4041,6 +4036,11 @@ export const Do = internal.Do;
  * assert.deepStrictEqual(Effect.runSync(Stream.runCollect(result)), Chunk.of({ x: 2, y: 3, sum: 5 }))
  * ```
  *
+ * @see {@link Do}
+ * @see {@link bindTo}
+ * @see {@link bindEffect}
+ * @see {@link let_ let}
+ *
  * @category do notation
  * @since 2.0.0
  */
@@ -4067,11 +4067,6 @@ export const bindEffect = groupBy_.bindEffect;
  * 3. You can accumulate multiple `bind` statements to define multiple variables within the scope
  * 4. Inside the do simulation scope, you can also use the `let` function to define variables and bind them to simple values
  *
- * @see {@link Do}
- * @see {@link bind}
- * @see {@link bindEffect}
- * @see {@link let_ let}
- *
  * @example
  * ```ts
  * import * as assert from "node:assert"
@@ -4086,6 +4081,11 @@ export const bindEffect = groupBy_.bindEffect;
  * assert.deepStrictEqual(Effect.runSync(Stream.runCollect(result)), Chunk.of({ x: 2, y: 3, sum: 5 }))
  * ```
  *
+ * @see {@link Do}
+ * @see {@link bind}
+ * @see {@link bindEffect}
+ * @see {@link let_ let}
+ *
  * @category do notation
  * @since 2.0.0
  */
@@ -4102,11 +4102,6 @@ export {
  * 3. You can accumulate multiple `bind` statements to define multiple variables within the scope
  * 4. Inside the do simulation scope, you can also use the `let` function to define variables and bind them to simple values
  *
- * @see {@link Do}
- * @see {@link bindTo}
- * @see {@link bind}
- * @see {@link bindEffect}
- *
  * @example
  * ```ts
  * import * as assert from "node:assert"
@@ -4119,8 +4114,13 @@ export {
  *   Stream.let("sum", ({ x, y }) => x + y)
  * )
  * assert.deepStrictEqual(Effect.runSync(Stream.runCollect(result)), Chunk.of({ x: 2, y: 3, sum: 5 }))
- *
  * ```
+ *
+ * @see {@link Do}
+ * @see {@link bindTo}
+ * @see {@link bind}
+ * @see {@link bindEffect}
+ *
  * @category do notation
  * @since 2.0.0
  */