effect 3.13.9 → 3.13.11

package/dist/cjs/Stream.js

@@ -62,7 +62,7 @@ const accumulateChunks = exports.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' ] ] }
@@ -121,7 +121,7 @@ const aggregateWithinEither = exports.aggregateWithinEither = internal.aggregate
  *
  * 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 ] }
  * ```
  *
@@ -227,7 +227,7 @@ const branchAfter = exports.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
@@ -335,7 +335,7 @@ const broadcastedQueuesDynamic = exports.broadcastedQueuesDynamic = internal.bro
  *   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
@@ -428,7 +428,7 @@ const catchSomeCause = exports.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 ] }
  * ```
  *
@@ -509,7 +509,7 @@ const combineChunks = exports.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 ] }
  * ```
  *
@@ -530,7 +530,7 @@ const concat = exports.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: [
@@ -560,7 +560,7 @@ const concatAll = exports.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: [
@@ -644,7 +644,7 @@ const crossWith = exports.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
@@ -716,7 +716,7 @@ const distributedWithDynamic = exports.distributedWithDynamic = internal.distrib
  * // 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: [] }
  * ```
  *
@@ -801,7 +801,7 @@ const either = exports.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: [] }
  * ```
  *
@@ -823,7 +823,7 @@ const empty = exports.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
@@ -927,7 +927,7 @@ const failCauseSync = exports.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 ] }
  * ```
  *
@@ -994,7 +994,7 @@ const filterMapWhileEffect = exports.filterMapWhileEffect = internal.filterMapWh
  *   )
  * )
  *
- * // 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.
@@ -1100,7 +1100,7 @@ const forever = exports.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 ] }
  * ```
  *
@@ -1132,7 +1132,7 @@ const toChannel = exports.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 ] }
  * ```
  *
@@ -1172,7 +1172,7 @@ const fromChunkQueue = exports.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 ] }
  * ```
  *
@@ -1190,7 +1190,7 @@ const fromChunks = exports.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 ] }
  * ```
  *
@@ -1235,7 +1235,7 @@ const fromTPubSub = exports.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 ] }
  * ```
  *
@@ -1259,9 +1259,9 @@ const fromIterable = exports.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' ] }
  * ```
  *
@@ -1338,7 +1338,7 @@ const fromReadableStreamByob = exports.fromReadableStreamByob = internal.fromRea
  *
  * 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 ] }
  * ```
  *
@@ -1381,7 +1381,7 @@ const groupAdjacentBy = exports.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 ] ]
@@ -1437,7 +1437,7 @@ const groupByKey = exports.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: [
@@ -1467,7 +1467,7 @@ const grouped = exports.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',
@@ -1556,7 +1556,7 @@ const identity = exports.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
@@ -1583,7 +1583,7 @@ const interleave = exports.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: [
@@ -1606,7 +1606,7 @@ const interleaveWith = exports.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: [
@@ -1635,7 +1635,7 @@ const intersperse = exports.intersperse = internal.intersperse;
  *   })
  * )
  *
- * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
+ * Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // {
  * //   _id: 'Chunk',
  * //   values: [
@@ -1693,7 +1693,7 @@ const interruptWhenDeferred = exports.interruptWhenDeferred = internal.interrupt
  * // 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 ] }
  * ```
  *
@@ -1710,7 +1710,7 @@ const iterate = exports.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 ] }
  * ```
  *
@@ -1727,7 +1727,7 @@ const make = exports.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 ] }
  * ```
  *
@@ -1746,9 +1746,9 @@ const map = exports.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 ] }
  * ```
  *
@@ -1799,7 +1799,7 @@ const mapChunksEffect = exports.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 ] }
  * ```
  *
@@ -1842,7 +1842,7 @@ const mapConcatEffect = exports.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 ] }
  * ```
  *
@@ -1883,7 +1883,7 @@ const mapErrorCause = exports.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 ] }
  * ```
  *
@@ -1939,7 +1939,7 @@ const mergeWithTag = exports.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 ] }
  * ```
  *
@@ -2042,7 +2042,7 @@ const onDone = exports.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
@@ -2139,7 +2139,7 @@ const orElseSucceed = exports.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 ] }
  * ```
  *
@@ -2186,12 +2186,9 @@ const paginateEffect = exports.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(
@@ -2206,11 +2203,14 @@ const paginateEffect = exports.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
  */
@@ -2229,11 +2229,9 @@ const partition = exports.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(
@@ -2251,11 +2249,13 @@ const partition = exports.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
  */
@@ -2424,7 +2424,7 @@ const raceAll = exports.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 ] }
  * ```
  *
@@ -2465,7 +2465,7 @@ const refineOrDieWith = exports.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 ] }
  * ```
  *
@@ -2483,7 +2483,7 @@ const repeat = exports.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 ] }
  * ```
  *
@@ -2586,7 +2586,7 @@ const repeatElementsWith = exports.repeatElementsWith = internal.repeatElementsW
  *
  * 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 ] }
  * ```
  *
@@ -2836,7 +2836,7 @@ const runSum = exports.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 ] }
  * ```
  *
@@ -2905,7 +2905,7 @@ const scheduleWith = exports.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
@@ -3014,7 +3014,7 @@ const splitLines = exports.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 ] }
  * ```
  *
@@ -3045,7 +3045,7 @@ const suspend = exports.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 ] }
  * ```
  *
@@ -3062,7 +3062,7 @@ const take = exports.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 ] }
  * ```
  *
@@ -3080,7 +3080,7 @@ const takeRight = exports.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 ] }
  * ```
  *
@@ -3106,7 +3106,7 @@ const takeUntilEffect = exports.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 ] }
  * ```
  *
@@ -3127,7 +3127,7 @@ const takeWhile = exports.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
@@ -3208,7 +3208,7 @@ const tapSink = exports.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
@@ -3262,7 +3262,7 @@ const throttleEffect = exports.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
@@ -3338,7 +3338,7 @@ const toPubSub = exports.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 ] }
@@ -3415,7 +3415,7 @@ const transduce = exports.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 ] }
  * ```
  *
@@ -3451,7 +3451,7 @@ const unfoldChunkEffect = exports.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 ] }
  * ```
  *
@@ -3545,7 +3545,7 @@ const withSpan = exports.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' ] ] }
  * ```
  *
@@ -3580,7 +3580,7 @@ const zipFlatten = exports.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" ] ] }
  * ```
  *
@@ -3686,7 +3686,7 @@ const zipAllSortedByKeyWith = exports.zipAllSortedByKeyWith = internal.zipAllSor
  *   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" ] ] }
  * ```
  *
@@ -3717,7 +3717,7 @@ const zipAllWith = exports.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" ] ] }
  * ```
  *
@@ -3743,7 +3743,7 @@ const zipLatest = exports.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 ]
@@ -3808,7 +3808,7 @@ const zipRight = exports.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' ] ] }
  * ```
  *
@@ -3835,7 +3835,7 @@ const zipWithChunks = exports.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 } ],
@@ -3858,7 +3858,7 @@ const zipWithNext = exports.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 ],
@@ -3880,7 +3880,7 @@ const zipWithPrevious = exports.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' },
@@ -3920,7 +3920,7 @@ const zipWithPreviousAndNext = exports.zipWithPreviousAndNext = internal.zipWith
  *
  * 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 ] ]
@@ -3944,11 +3944,6 @@ const zipWithIndex = exports.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"
@@ -3963,6 +3958,11 @@ const zipWithIndex = exports.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
  */
@@ -3977,11 +3977,6 @@ const Do = exports.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"
@@ -3996,6 +3991,11 @@ const Do = exports.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
  */
@@ -4022,11 +4022,6 @@ const bindEffect = exports.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"
@@ -4041,6 +4036,11 @@ const bindEffect = exports.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
  */