effect 3.10.18 → 3.11.0

package/src/Stream.ts

@@ -193,6 +193,7 @@ export const accumulateChunks: <A, E, R>(self: Stream<A, E, R>) => Stream<A, E,
  * stream is consumed.
  *
  * @example
+ * ```ts
  * import { Console, Effect, Stream } from "effect"
  *
  * // Simulating File operations
@@ -214,6 +215,7 @@ export const accumulateChunks: <A, E, R>(self: Stream<A, E, R>) => Stream<A, E,
  * // Opening file.txt
  * // Closing file.txt
  * // { _id: 'Chunk', values: [ [ 'Line 1', 'Line 2', 'Line 3' ] ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -379,12 +381,14 @@ export const aggregateWithinEither: {
  * Maps the success values of this stream to the specified constant value.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.range(1, 5).pipe(Stream.as(null))
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ null, null, null, null, null ] }
+ * ```
  *
  * @since 2.0.0
  * @category mapping
@@ -394,12 +398,14 @@ export const as: {
    * Maps the success values of this stream to the specified constant value.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.range(1, 5).pipe(Stream.as(null))
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ null, null, null, null, null ] }
+   * ```
    *
    * @since 2.0.0
    * @category mapping
@@ -409,12 +415,14 @@ export const as: {
    * Maps the success values of this stream to the specified constant value.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.range(1, 5).pipe(Stream.as(null))
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ null, null, null, null, null ] }
+   * ```
    *
    * @since 2.0.0
    * @category mapping
@@ -440,6 +448,7 @@ export {
    * executed if the `Fiber` executing this Effect is interrupted.
    *
    * @example
+   * ```ts
    * import type { StreamEmit } from "effect"
    * import { Chunk, Effect, Option, Stream } from "effect"
    *
@@ -462,6 +471,7 @@ export {
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 1, 2 ] }
    *
+   * ```
    * @since 2.0.0
    * @category constructors
    */
@@ -499,6 +509,7 @@ export const asyncEffect: <A, E = never, R = never>(
  * second argument with the `bufferSize` and `strategy` fields.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * Stream.asyncPush<string>((emit) =>
@@ -513,6 +524,7 @@ export const asyncEffect: <A, E = never, R = never>(
  *         clearInterval(handle)
  *       })
  *   ), { bufferSize: 16, strategy: "dropping" })
+ * ```
  *
  * @since 3.6.0
  * @category constructors
@@ -584,6 +596,7 @@ export const branchAfter: {
  * chunks before the slowest downstream stream.
  *
  * @example
+ * ```ts
  * import { Console, Effect, Fiber, Schedule, Stream } from "effect"
  *
  * const numbers = Effect.scoped(
@@ -653,6 +666,7 @@ export const branchAfter: {
  * // Logging to the Console: 19
  * // Logging to the Console: 20
  * // { _id: 'Chunk', values: [ undefined ] }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -664,6 +678,7 @@ export const broadcast: {
    * chunks before the slowest downstream stream.
    *
    * @example
+   * ```ts
    * import { Console, Effect, Fiber, Schedule, Stream } from "effect"
    *
    * const numbers = Effect.scoped(
@@ -733,6 +748,7 @@ export const broadcast: {
    * // Logging to the Console: 19
    * // Logging to the Console: 20
    * // { _id: 'Chunk', values: [ undefined ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -751,6 +767,7 @@ export const broadcast: {
    * chunks before the slowest downstream stream.
    *
    * @example
+   * ```ts
    * import { Console, Effect, Fiber, Schedule, Stream } from "effect"
    *
    * const numbers = Effect.scoped(
@@ -820,6 +837,7 @@ export const broadcast: {
    * // Logging to the Console: 19
    * // Logging to the Console: 20
    * // { _id: 'Chunk', values: [ undefined ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -1040,6 +1058,7 @@ export const broadcastedQueuesDynamic: {
  *       of 2 for better performance.
  *
  * @example
+ * ```ts
  * import { Console, Effect, Schedule, Stream } from "effect"
  *
  * const stream = Stream.range(1, 10).pipe(
@@ -1066,6 +1085,7 @@ export const broadcastedQueuesDynamic: {
  * // after buffering: 5
  * // before buffering: 10
  * // ...
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -1080,6 +1100,7 @@ export const buffer: {
    *       of 2 for better performance.
    *
    * @example
+   * ```ts
    * import { Console, Effect, Schedule, Stream } from "effect"
    *
    * const stream = Stream.range(1, 10).pipe(
@@ -1106,6 +1127,7 @@ export const buffer: {
    * // after buffering: 5
    * // before buffering: 10
    * // ...
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -1125,6 +1147,7 @@ export const buffer: {
    *       of 2 for better performance.
    *
    * @example
+   * ```ts
    * import { Console, Effect, Schedule, Stream } from "effect"
    *
    * const stream = Stream.range(1, 10).pipe(
@@ -1151,6 +1174,7 @@ export const buffer: {
    * // after buffering: 5
    * // before buffering: 10
    * // ...
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -1430,12 +1454,14 @@ export const catchSomeCause: {
  * elements are equal.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.make(1, 1, 1, 2, 2, 3, 4).pipe(Stream.changes)
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3, 4 ] }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -1661,6 +1687,7 @@ export const combineChunks: {
  * specified stream.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const s1 = Stream.make(1, 2, 3)
@@ -1670,6 +1697,7 @@ export const combineChunks: {
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3, 4, 5 ] }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -1681,6 +1709,7 @@ export const concat: {
    * specified stream.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const s1 = Stream.make(1, 2, 3)
@@ -1690,6 +1719,7 @@ export const concat: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 1, 2, 3, 4, 5 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -1701,6 +1731,7 @@ export const concat: {
    * specified stream.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const s1 = Stream.make(1, 2, 3)
@@ -1710,6 +1741,7 @@ export const concat: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 1, 2, 3, 4, 5 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -1721,6 +1753,7 @@ export const concat: {
  * Concatenates all of the streams in the chunk to one stream.
  *
  * @example
+ * ```ts
  * import { Chunk, Effect, Stream } from "effect"
  *
  * const s1 = Stream.make(1, 2, 3)
@@ -1737,6 +1770,7 @@ export const concat: {
  * //     5, 6, 7, 8
  * //   ]
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -1751,6 +1785,7 @@ export const concatAll: <A, E, R>(streams: Chunk.Chunk<Stream<A, E, R>>) => Stre
  * See also `Stream.zip` for the more common point-wise variant.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const s1 = Stream.make(1, 2, 3)
@@ -1765,6 +1800,7 @@ export const concatAll: <A, E, R>(streams: Chunk.Chunk<Stream<A, E, R>>) => Stre
  * //     [ 1, "a" ], [ 1, "b" ], [ 2, "a" ], [ 2, "b" ], [ 3, "a" ], [ 3, "b" ]
  * //   ]
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -1778,6 +1814,7 @@ export const cross: {
    * See also `Stream.zip` for the more common point-wise variant.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const s1 = Stream.make(1, 2, 3)
@@ -1792,6 +1829,7 @@ export const cross: {
    * //     [ 1, "a" ], [ 1, "b" ], [ 2, "a" ], [ 2, "b" ], [ 3, "a" ], [ 3, "b" ]
    * //   ]
    * // }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -1805,6 +1843,7 @@ export const cross: {
    * See also `Stream.zip` for the more common point-wise variant.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const s1 = Stream.make(1, 2, 3)
@@ -1819,6 +1858,7 @@ export const cross: {
    * //     [ 1, "a" ], [ 1, "b" ], [ 2, "a" ], [ 2, "b" ], [ 3, "a" ], [ 3, "b" ]
    * //   ]
    * // }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -1953,6 +1993,7 @@ export const crossWith: {
  * has paused typing so as to not prematurely recommend results.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * let last = Date.now()
@@ -1990,6 +2031,7 @@ export const crossWith: {
  * // Received 8 after 1ms
  * // > Emitted 8 after 101ms
  * // { _id: 'Chunk', values: [ 3, 6, 8 ] }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -2007,6 +2049,7 @@ export const debounce: {
    * has paused typing so as to not prematurely recommend results.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * let last = Date.now()
@@ -2044,6 +2087,7 @@ export const debounce: {
    * // Received 8 after 1ms
    * // > Emitted 8 after 101ms
    * // { _id: 'Chunk', values: [ 3, 6, 8 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -2061,6 +2105,7 @@ export const debounce: {
    * has paused typing so as to not prematurely recommend results.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * let last = Date.now()
@@ -2098,6 +2143,7 @@ export const debounce: {
    * // Received 8 after 1ms
    * // > Emitted 8 after 101ms
    * // { _id: 'Chunk', values: [ 3, 6, 8 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -2231,6 +2277,7 @@ export const distributedWithDynamic: {
  * elements. Useful for sequencing effects using streams:
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * // We create a stream and immediately drain it.
@@ -2238,6 +2285,7 @@ export const distributedWithDynamic: {
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [] }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -2455,12 +2503,14 @@ export const either: <A, E, R>(self: Stream<A, E, R>) => Stream<Either.Either<A,
  * The empty stream.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.empty
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -2471,6 +2521,7 @@ export const empty: Stream<never> = internal.empty
  * Executes the provided finalizer after this stream's finalizers run.
  *
  * @example
+ * ```ts
  * import { Console, Effect, Stream } from "effect"
  *
  * const program = Stream.fromEffect(Console.log("Application Logic.")).pipe(
@@ -2485,6 +2536,7 @@ export const empty: Stream<never> = internal.empty
  * // Finalizing the stream
  * // Doing some other works after stream's finalization
  * // { _id: 'Chunk', values: [ undefined, undefined ] }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -2494,6 +2546,7 @@ export const ensuring: {
    * Executes the provided finalizer after this stream's finalizers run.
    *
    * @example
+   * ```ts
    * import { Console, Effect, Stream } from "effect"
    *
    * const program = Stream.fromEffect(Console.log("Application Logic.")).pipe(
@@ -2508,6 +2561,7 @@ export const ensuring: {
    * // Finalizing the stream
    * // Doing some other works after stream's finalization
    * // { _id: 'Chunk', values: [ undefined, undefined ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -2517,6 +2571,7 @@ export const ensuring: {
    * Executes the provided finalizer after this stream's finalizers run.
    *
    * @example
+   * ```ts
    * import { Console, Effect, Stream } from "effect"
    *
    * const program = Stream.fromEffect(Console.log("Application Logic.")).pipe(
@@ -2531,6 +2586,7 @@ export const ensuring: {
    * // Finalizing the stream
    * // Doing some other works after stream's finalization
    * // { _id: 'Chunk', values: [ undefined, undefined ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -2614,6 +2670,7 @@ export const execute: <X, E, R>(effect: Effect.Effect<X, E, R>) => Stream<never,
  * Terminates with the specified error.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.fail("Uh oh!")
@@ -2624,6 +2681,7 @@ export const execute: <X, E, R>(effect: Effect.Effect<X, E, R>) => Stream<never,
  * //   _tag: 'Failure',
  * //   cause: { _id: 'Cause', _tag: 'Fail', failure: 'Uh oh!' }
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -2658,12 +2716,14 @@ export const failCauseSync: <E>(evaluate: LazyArg<Cause.Cause<E>>) => Stream<nev
  * Filters the elements emitted by this stream using the provided function.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.range(1, 11).pipe(Stream.filter((n) => n % 2 === 0))
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 2, 4, 6, 8, 10 ] }
+ * ```
  *
  * @since 2.0.0
  * @category filtering
@@ -2673,12 +2733,14 @@ export const filter: {
    * Filters the elements emitted by this stream using the provided function.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.range(1, 11).pipe(Stream.filter((n) => n % 2 === 0))
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 2, 4, 6, 8, 10 ] }
+   * ```
    *
    * @since 2.0.0
    * @category filtering
@@ -2688,12 +2750,14 @@ export const filter: {
    * Filters the elements emitted by this stream using the provided function.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.range(1, 11).pipe(Stream.filter((n) => n % 2 === 0))
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 2, 4, 6, 8, 10 ] }
+   * ```
    *
    * @since 2.0.0
    * @category filtering
@@ -2703,12 +2767,14 @@ export const filter: {
    * Filters the elements emitted by this stream using the provided function.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.range(1, 11).pipe(Stream.filter((n) => n % 2 === 0))
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 2, 4, 6, 8, 10 ] }
+   * ```
    *
    * @since 2.0.0
    * @category filtering
@@ -2718,12 +2784,14 @@ export const filter: {
    * Filters the elements emitted by this stream using the provided function.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.range(1, 11).pipe(Stream.filter((n) => n % 2 === 0))
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 2, 4, 6, 8, 10 ] }
+   * ```
    *
    * @since 2.0.0
    * @category filtering
@@ -2869,6 +2937,7 @@ export const filterMapWhileEffect: {
  * when it ends.
  *
  * @example
+ * ```ts
  * import { Console, Effect, Stream } from "effect"
  *
  * const application = Stream.fromEffect(Console.log("Application Logic."))
@@ -2890,6 +2959,7 @@ export const filterMapWhileEffect: {
  * // Deleting dir: tmp
  * // Temporary directory was deleted.
  * // { _id: 'Chunk', values: [ undefined, undefined ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -3136,6 +3206,7 @@ export const forever: <A, E, R>(self: Stream<A, E, R>) => Stream<A, E, R> = inte
  * Creates a stream from an `AsyncIterable`.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const myAsyncIterable = async function*() {
@@ -3150,6 +3221,7 @@ export const forever: <A, E, R>(self: Stream<A, E, R>) => Stream<A, E, R> = inte
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2 ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -3181,6 +3253,7 @@ export const toChannel: <A, E, R>(
  * Creates a stream from a `Chunk` of values.
  *
  * @example
+ * ```ts
  * import { Chunk, Effect, Stream } from "effect"
  *
  * // Creating a stream with values from a single Chunk
@@ -3188,6 +3261,7 @@ export const toChannel: <A, E, R>(
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3 ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -3244,6 +3318,7 @@ export const fromChunkQueue: <A>(
  * Creates a stream from an arbitrary number of chunks.
  *
  * @example
+ * ```ts
  * import { Chunk, Effect, Stream } from "effect"
  *
  * // Creating a stream with values from multiple Chunks
@@ -3251,6 +3326,7 @@ export const fromChunkQueue: <A>(
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3, 4, 5, 6 ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -3262,12 +3338,14 @@ export const fromChunks: <A>(...chunks: Array<Chunk.Chunk<A>>) => Stream<A> = in
  * with the failure value of this effect.
  *
  * @example
+ * ```ts
  * import { Effect, Random, Stream } from "effect"
  *
  * const stream = Stream.fromEffect(Random.nextInt)
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // Example Output: { _id: 'Chunk', values: [ 922694024 ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -3336,6 +3414,7 @@ export const fromTPubSub: <A>(pubsub: TPubSub<A>) => Stream<A> = internal.fromTP
  * Creates a new `Stream` from an iterable collection of values.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const numbers = [1, 2, 3]
@@ -3344,6 +3423,7 @@ export const fromTPubSub: <A>(pubsub: TPubSub<A>) => Stream<A> = internal.fromTP
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3 ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -3354,6 +3434,7 @@ export const fromIterable: <A>(iterable: Iterable<A>) => Stream<A> = internal.fr
  * Creates a stream from an effect producing a value of type `Iterable<A>`.
  *
  * @example
+ * ```ts
  * import { Context, Effect, Stream } from "effect"
  *
  * class Database extends Context.Tag("Database")<
@@ -3369,6 +3450,7 @@ export const fromIterable: <A>(iterable: Iterable<A>) => Stream<A> = internal.fr
  * //   Stream.runCollect(stream.pipe(Stream.provideService(Database, { getUsers: Effect.succeed(["user1", "user2"]) })))
  * // ).then(console.log)
  * // { _id: 'Chunk', values: [ 'user1', 'user2' ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -3505,6 +3587,7 @@ export const fromReadableStreamByob: {
  * schedule, continuing for as long as the schedule continues.
  *
  * @example
+ * ```ts
  * import { Effect, Schedule, Stream } from "effect"
  *
  * // Emits values every 1 second for a total of 5 emissions
@@ -3516,6 +3599,7 @@ export const fromReadableStreamByob: {
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4 ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -3553,6 +3637,7 @@ export const groupAdjacentBy: {
  * More powerful version of `Stream.groupByKey`.
  *
  * @example
+ * ```ts
  * import { Chunk, Effect, GroupBy, Stream } from "effect"
  *
  * const groupByKeyResult = Stream.fromIterable([
@@ -3580,6 +3665,7 @@ export const groupAdjacentBy: {
  * //   _id: 'Chunk',
  * //   values: [ [ 'M', 1 ], [ 'J', 3 ], [ 'R', 2 ], [ 'P', 2 ] ]
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category grouping
@@ -3589,6 +3675,7 @@ export const groupBy: {
    * More powerful version of `Stream.groupByKey`.
    *
    * @example
+   * ```ts
    * import { Chunk, Effect, GroupBy, Stream } from "effect"
    *
    * const groupByKeyResult = Stream.fromIterable([
@@ -3616,6 +3703,7 @@ export const groupBy: {
    * //   _id: 'Chunk',
    * //   values: [ [ 'M', 1 ], [ 'J', 3 ], [ 'R', 2 ], [ 'P', 2 ] ]
    * // }
+   * ```
    *
    * @since 2.0.0
    * @category grouping
@@ -3628,6 +3716,7 @@ export const groupBy: {
    * More powerful version of `Stream.groupByKey`.
    *
    * @example
+   * ```ts
    * import { Chunk, Effect, GroupBy, Stream } from "effect"
    *
    * const groupByKeyResult = Stream.fromIterable([
@@ -3655,6 +3744,7 @@ export const groupBy: {
    * //   _id: 'Chunk',
    * //   values: [ [ 'M', 1 ], [ 'J', 3 ], [ 'R', 2 ], [ 'P', 2 ] ]
    * // }
+   * ```
    *
    * @since 2.0.0
    * @category grouping
@@ -3797,6 +3887,7 @@ export const groupByKey: {
  * Partitions the stream with specified `chunkSize`.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.range(0, 8).pipe(Stream.grouped(3))
@@ -3811,6 +3902,7 @@ export const groupByKey: {
  * //     [length]: 3
  * //   ]
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category grouping
@@ -3820,6 +3912,7 @@ export const grouped: {
    * Partitions the stream with specified `chunkSize`.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.range(0, 8).pipe(Stream.grouped(3))
@@ -3834,6 +3927,7 @@ export const grouped: {
    * //     [length]: 3
    * //   ]
    * // }
+   * ```
    *
    * @since 2.0.0
    * @category grouping
@@ -3843,6 +3937,7 @@ export const grouped: {
    * Partitions the stream with specified `chunkSize`.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.range(0, 8).pipe(Stream.grouped(3))
@@ -3857,6 +3952,7 @@ export const grouped: {
    * //     [length]: 3
    * //   ]
    * // }
+   * ```
    *
    * @since 2.0.0
    * @category grouping
@@ -3869,6 +3965,7 @@ export const grouped: {
  * `duration` has passed, whichever is satisfied first.
  *
  * @example
+ * ```ts
  * import { Chunk, Effect, Schedule, Stream } from "effect"
  *
  * const stream = Stream.range(0, 9).pipe(
@@ -3904,6 +4001,7 @@ export const grouped: {
  * //     ]
  * //   }
  * // ]
+ * ```
  *
  * @since 2.0.0
  * @category grouping
@@ -3914,6 +4012,7 @@ export const groupedWithin: {
    * `duration` has passed, whichever is satisfied first.
    *
    * @example
+   * ```ts
    * import { Chunk, Effect, Schedule, Stream } from "effect"
    *
    * const stream = Stream.range(0, 9).pipe(
@@ -3949,6 +4048,7 @@ export const groupedWithin: {
    * //     ]
    * //   }
    * // ]
+   * ```
    *
    * @since 2.0.0
    * @category grouping
@@ -3962,6 +4062,7 @@ export const groupedWithin: {
    * `duration` has passed, whichever is satisfied first.
    *
    * @example
+   * ```ts
    * import { Chunk, Effect, Schedule, Stream } from "effect"
    *
    * const stream = Stream.range(0, 9).pipe(
@@ -3997,6 +4098,7 @@ export const groupedWithin: {
    * //     ]
    * //   }
    * // ]
+   * ```
    *
    * @since 2.0.0
    * @category grouping
@@ -4127,6 +4229,7 @@ export const identity: <A, E = never, R = never>() => Stream<A, E, R> = internal
  * pulled.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const s1 = Stream.make(1, 2, 3)
@@ -4136,6 +4239,7 @@ export const identity: <A, E = never, R = never>() => Stream<A, E, R> = internal
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 4, 2, 5, 3, 6 ] }
+ * ```
  * @since 2.0.0
  * @category utils
  */
@@ -4147,6 +4251,7 @@ export const interleave: {
    * pulled.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const s1 = Stream.make(1, 2, 3)
@@ -4156,6 +4261,7 @@ export const interleave: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 1, 4, 2, 5, 3, 6 ] }
+   * ```
    * @since 2.0.0
    * @category utils
    */
@@ -4167,6 +4273,7 @@ export const interleave: {
    * pulled.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const s1 = Stream.make(1, 2, 3)
@@ -4176,6 +4283,7 @@ export const interleave: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 1, 4, 2, 5, 3, 6 ] }
+   * ```
    * @since 2.0.0
    * @category utils
    */
@@ -4192,6 +4300,7 @@ export const interleave: {
  * ignored.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const s1 = Stream.make(1, 3, 5, 7, 9)
@@ -4209,6 +4318,7 @@ export const interleave: {
  * //     8, 5, 10, 7, 9
  * //   ]
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -4224,6 +4334,7 @@ export const interleaveWith: {
    * ignored.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const s1 = Stream.make(1, 3, 5, 7, 9)
@@ -4241,6 +4352,7 @@ export const interleaveWith: {
    * //     8, 5, 10, 7, 9
    * //   ]
    * // }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -4259,6 +4371,7 @@ export const interleaveWith: {
    * ignored.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const s1 = Stream.make(1, 3, 5, 7, 9)
@@ -4276,6 +4389,7 @@ export const interleaveWith: {
    * //     8, 5, 10, 7, 9
    * //   ]
    * // }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -4291,6 +4405,7 @@ export const interleaveWith: {
  * Intersperse stream with provided `element`.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.make(1, 2, 3, 4, 5).pipe(Stream.intersperse(0))
@@ -4303,6 +4418,7 @@ export const interleaveWith: {
  * //     0, 4, 0, 5
  * //   ]
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -4312,6 +4428,7 @@ export const intersperse: {
    * Intersperse stream with provided `element`.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.make(1, 2, 3, 4, 5).pipe(Stream.intersperse(0))
@@ -4324,6 +4441,7 @@ export const intersperse: {
    * //     0, 4, 0, 5
    * //   ]
    * // }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -4333,6 +4451,7 @@ export const intersperse: {
    * Intersperse stream with provided `element`.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.make(1, 2, 3, 4, 5).pipe(Stream.intersperse(0))
@@ -4345,6 +4464,7 @@ export const intersperse: {
    * //     0, 4, 0, 5
    * //   ]
    * // }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -4356,6 +4476,7 @@ export const intersperse: {
  * Intersperse the specified element, also adding a prefix and a suffix.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.make(1, 2, 3, 4, 5).pipe(
@@ -4375,6 +4496,7 @@ export const intersperse: {
  * //     ']'
  * //   ]
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -4384,6 +4506,7 @@ export const intersperseAffixes: {
    * Intersperse the specified element, also adding a prefix and a suffix.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.make(1, 2, 3, 4, 5).pipe(
@@ -4403,6 +4526,7 @@ export const intersperseAffixes: {
    * //     ']'
    * //   ]
    * // }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -4414,6 +4538,7 @@ export const intersperseAffixes: {
    * Intersperse the specified element, also adding a prefix and a suffix.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.make(1, 2, 3, 4, 5).pipe(
@@ -4433,6 +4558,7 @@ export const intersperseAffixes: {
    * //     ']'
    * //   ]
    * // }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -4550,6 +4676,7 @@ export const interruptWhenDeferred: {
  * f(f(f(a))), ...
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * // An infinite Stream of numbers starting from 1 and incrementing
@@ -4557,6 +4684,7 @@ export const interruptWhenDeferred: {
  *
  * // 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 ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -4567,12 +4695,14 @@ export const iterate: <A>(value: A, next: (value: A) => A) => Stream<A> = intern
  * Creates a stream from an sequence of values.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.make(1, 2, 3)
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3 ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -4583,12 +4713,14 @@ export const make: <As extends Array<any>>(...as: As) => Stream<As[number]> = in
  * Transforms the elements of this stream using the supplied function.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.make(1, 2, 3).pipe(Stream.map((n) => n + 1))
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 2, 3, 4 ] }
+ * ```
  *
  * @since 2.0.0
  * @category mapping
@@ -4598,12 +4730,14 @@ export const map: {
    * Transforms the elements of this stream using the supplied function.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.make(1, 2, 3).pipe(Stream.map((n) => n + 1))
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 2, 3, 4 ] }
+   * ```
    *
    * @since 2.0.0
    * @category mapping
@@ -4613,12 +4747,14 @@ export const map: {
    * Transforms the elements of this stream using the supplied function.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.make(1, 2, 3).pipe(Stream.map((n) => n + 1))
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 2, 3, 4 ] }
+   * ```
    *
    * @since 2.0.0
    * @category mapping
@@ -4630,6 +4766,7 @@ export const map: {
  * Statefully maps over the elements of this stream to produce new elements.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const runningTotal = (stream: Stream.Stream<number>): Stream.Stream<number> =>
@@ -4640,6 +4777,7 @@ export const map: {
  * //   console.log
  * // )
  * // { _id: "Chunk", values: [ 0, 1, 3, 6, 10, 15, 21 ] }
+ * ```
  *
  * @since 2.0.0
  * @category mapping
@@ -4649,6 +4787,7 @@ export const mapAccum: {
    * Statefully maps over the elements of this stream to produce new elements.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const runningTotal = (stream: Stream.Stream<number>): Stream.Stream<number> =>
@@ -4659,6 +4798,7 @@ export const mapAccum: {
    * //   console.log
    * // )
    * // { _id: "Chunk", values: [ 0, 1, 3, 6, 10, 15, 21 ] }
+   * ```
    *
    * @since 2.0.0
    * @category mapping
@@ -4668,6 +4808,7 @@ export const mapAccum: {
    * Statefully maps over the elements of this stream to produce new elements.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const runningTotal = (stream: Stream.Stream<number>): Stream.Stream<number> =>
@@ -4678,6 +4819,7 @@ export const mapAccum: {
    * //   console.log
    * // )
    * // { _id: "Chunk", values: [ 0, 1, 3, 6, 10, 15, 21 ] }
+   * ```
    *
    * @since 2.0.0
    * @category mapping
@@ -4805,6 +4947,7 @@ export const mapChunksEffect: {
  * output of this stream.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const numbers = Stream.make("1-2-3", "4-5", "6").pipe(
@@ -4814,6 +4957,7 @@ export const mapChunksEffect: {
  *
  * // Effect.runPromise(Stream.runCollect(numbers)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3, 4, 5, 6 ] }
+ * ```
  *
  * @since 2.0.0
  * @category mapping
@@ -4824,6 +4968,7 @@ export const mapConcat: {
    * output of this stream.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const numbers = Stream.make("1-2-3", "4-5", "6").pipe(
@@ -4833,6 +4978,7 @@ export const mapConcat: {
    *
    * // Effect.runPromise(Stream.runCollect(numbers)).then(console.log)
    * // { _id: 'Chunk', values: [ 1, 2, 3, 4, 5, 6 ] }
+   * ```
    *
    * @since 2.0.0
    * @category mapping
@@ -4843,6 +4989,7 @@ export const mapConcat: {
    * output of this stream.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const numbers = Stream.make("1-2-3", "4-5", "6").pipe(
@@ -4852,6 +4999,7 @@ export const mapConcat: {
    *
    * // Effect.runPromise(Stream.runCollect(numbers)).then(console.log)
    * // { _id: 'Chunk', values: [ 1, 2, 3, 4, 5, 6 ] }
+   * ```
    *
    * @since 2.0.0
    * @category mapping
@@ -4951,6 +5099,7 @@ export const mapConcatEffect: {
  * Maps over elements of the stream with the specified effectful function.
  *
  * @example
+ * ```ts
  * import { Effect, Random, Stream } from "effect"
  *
  * const stream = Stream.make(10, 20, 30).pipe(
@@ -4959,6 +5108,7 @@ export const mapConcatEffect: {
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // Example Output: { _id: 'Chunk', values: [ 7, 19, 8 ] }
+ * ```
  *
  * @since 2.0.0
  * @category mapping
@@ -4968,6 +5118,7 @@ export const mapEffect: {
    * Maps over elements of the stream with the specified effectful function.
    *
    * @example
+   * ```ts
    * import { Effect, Random, Stream } from "effect"
    *
    * const stream = Stream.make(10, 20, 30).pipe(
@@ -4976,6 +5127,7 @@ export const mapEffect: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // Example Output: { _id: 'Chunk', values: [ 7, 19, 8 ] }
+   * ```
    *
    * @since 2.0.0
    * @category mapping
@@ -4990,6 +5142,7 @@ export const mapEffect: {
    * Maps over elements of the stream with the specified effectful function.
    *
    * @example
+   * ```ts
    * import { Effect, Random, Stream } from "effect"
    *
    * const stream = Stream.make(10, 20, 30).pipe(
@@ -4998,6 +5151,7 @@ export const mapEffect: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // Example Output: { _id: 'Chunk', values: [ 7, 19, 8 ] }
+   * ```
    *
    * @since 2.0.0
    * @category mapping
@@ -5010,6 +5164,7 @@ export const mapEffect: {
    * Maps over elements of the stream with the specified effectful function.
    *
    * @example
+   * ```ts
    * import { Effect, Random, Stream } from "effect"
    *
    * const stream = Stream.make(10, 20, 30).pipe(
@@ -5018,6 +5173,7 @@ export const mapEffect: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // Example Output: { _id: 'Chunk', values: [ 7, 19, 8 ] }
+   * ```
    *
    * @since 2.0.0
    * @category mapping
@@ -5033,6 +5189,7 @@ export const mapEffect: {
    * Maps over elements of the stream with the specified effectful function.
    *
    * @example
+   * ```ts
    * import { Effect, Random, Stream } from "effect"
    *
    * const stream = Stream.make(10, 20, 30).pipe(
@@ -5041,6 +5198,7 @@ export const mapEffect: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // Example Output: { _id: 'Chunk', values: [ 7, 19, 8 ] }
+   * ```
    *
    * @since 2.0.0
    * @category mapping
@@ -5105,6 +5263,7 @@ export const mapErrorCause: {
  * no termination strategy is specified.
  *
  * @example
+ * ```ts
  * import { Effect, Schedule, Stream } from "effect"
  *
  * const s1 = Stream.make(1, 2, 3).pipe(
@@ -5118,6 +5277,7 @@ export const mapErrorCause: {
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 4, 2, 3, 5, 6 ] }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -5130,6 +5290,7 @@ export const merge: {
    * no termination strategy is specified.
    *
    * @example
+   * ```ts
    * import { Effect, Schedule, Stream } from "effect"
    *
    * const s1 = Stream.make(1, 2, 3).pipe(
@@ -5143,6 +5304,7 @@ export const merge: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 1, 4, 2, 3, 5, 6 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -5158,6 +5320,7 @@ export const merge: {
    * no termination strategy is specified.
    *
    * @example
+   * ```ts
    * import { Effect, Schedule, Stream } from "effect"
    *
    * const s1 = Stream.make(1, 2, 3).pipe(
@@ -5171,6 +5334,7 @@ export const merge: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 1, 4, 2, 3, 5, 6 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -5228,12 +5392,14 @@ export const mergeAll: {
  * @since 3.8.5
  *
  * @example
+ * ```ts
  * import { Stream } from "effect"
  * // Stream.Stream<{ _tag: "a"; value: number; } | { _tag: "b"; value: string; }>
  * const res = Stream.mergeWithTag({
  *    a: Stream.make(0),
  *    b: Stream.make("")
  * }, { concurrency: "unbounded" })
+ * ```
  */
 export const mergeWithTag: {
   /**
@@ -5242,12 +5408,14 @@ export const mergeWithTag: {
    * @since 3.8.5
    *
    * @example
+   * ```ts
    * import { Stream } from "effect"
    * // Stream.Stream<{ _tag: "a"; value: number; } | { _tag: "b"; value: string; }>
    * const res = Stream.mergeWithTag({
    *    a: Stream.make(0),
    *    b: Stream.make("")
    * }, { concurrency: "unbounded" })
+   * ```
    */
   <S extends { [k in string]: Stream<any, any, any> }>(
     streams: S,
@@ -5266,12 +5434,14 @@ export const mergeWithTag: {
    * @since 3.8.5
    *
    * @example
+   * ```ts
    * import { Stream } from "effect"
    * // Stream.Stream<{ _tag: "a"; value: number; } | { _tag: "b"; value: string; }>
    * const res = Stream.mergeWithTag({
    *    a: Stream.make(0),
    *    b: Stream.make("")
    * }, { concurrency: "unbounded" })
+   * ```
    */
   (
     options: {
@@ -5293,6 +5463,7 @@ export const mergeWithTag: {
  * no termination strategy is specified.
  *
  * @example
+ * ```ts
  * import { Effect, Schedule, Stream } from "effect"
  *
  * const s1 = Stream.make("1", "2", "3").pipe(
@@ -5309,6 +5480,7 @@ export const mergeWithTag: {
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 4, 2, 3, 5, 6 ] }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -5322,6 +5494,7 @@ export const mergeWith: {
    * no termination strategy is specified.
    *
    * @example
+   * ```ts
    * import { Effect, Schedule, Stream } from "effect"
    *
    * const s1 = Stream.make("1", "2", "3").pipe(
@@ -5338,6 +5511,7 @@ export const mergeWith: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 1, 4, 2, 3, 5, 6 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -5358,6 +5532,7 @@ export const mergeWith: {
    * no termination strategy is specified.
    *
    * @example
+   * ```ts
    * import { Effect, Schedule, Stream } from "effect"
    *
    * const s1 = Stream.make("1", "2", "3").pipe(
@@ -5374,6 +5549,7 @@ export const mergeWith: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 1, 4, 2, 3, 5, 6 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -5490,6 +5666,7 @@ export const never: Stream<never> = internal.never
  * Adds an effect to be executed at the end of the stream.
  *
  * @example
+ * ```ts
  * import { Console, Effect, Stream } from "effect"
  *
  * const stream = Stream.make(1, 2, 3).pipe(
@@ -5504,6 +5681,7 @@ export const never: Stream<never> = internal.never
  * // after mapping: 6
  * // Stream ended
  * // { _id: 'Chunk', values: [ 2, 4, 6 ] }
+ * ```
  *
  * @since 3.6.0
  * @category sequencing
@@ -5513,6 +5691,7 @@ export const onEnd: {
    * Adds an effect to be executed at the end of the stream.
    *
    * @example
+   * ```ts
    * import { Console, Effect, Stream } from "effect"
    *
    * const stream = Stream.make(1, 2, 3).pipe(
@@ -5527,6 +5706,7 @@ export const onEnd: {
    * // after mapping: 6
    * // Stream ended
    * // { _id: 'Chunk', values: [ 2, 4, 6 ] }
+   * ```
    *
    * @since 3.6.0
    * @category sequencing
@@ -5536,6 +5716,7 @@ export const onEnd: {
    * Adds an effect to be executed at the end of the stream.
    *
    * @example
+   * ```ts
    * import { Console, Effect, Stream } from "effect"
    *
    * const stream = Stream.make(1, 2, 3).pipe(
@@ -5550,6 +5731,7 @@ export const onEnd: {
    * // after mapping: 6
    * // Stream ended
    * // { _id: 'Chunk', values: [ 2, 4, 6 ] }
+   * ```
    *
    * @since 3.6.0
    * @category sequencing
@@ -5624,6 +5806,7 @@ export const onDone: {
  * Adds an effect to be executed at the start of the stream.
  *
  * @example
+ * ```ts
  * import { Console, Effect, Stream } from "effect"
  *
  * const stream = Stream.make(1, 2, 3).pipe(
@@ -5638,6 +5821,7 @@ export const onDone: {
  * // after mapping: 4
  * // after mapping: 6
  * // { _id: 'Chunk', values: [ 2, 4, 6 ] }
+ * ```
  *
  * @since 3.6.0
  * @category sequencing
@@ -5647,6 +5831,7 @@ export const onStart: {
    * Adds an effect to be executed at the start of the stream.
    *
    * @example
+   * ```ts
    * import { Console, Effect, Stream } from "effect"
    *
    * const stream = Stream.make(1, 2, 3).pipe(
@@ -5661,6 +5846,7 @@ export const onStart: {
    * // after mapping: 4
    * // after mapping: 6
    * // { _id: 'Chunk', values: [ 2, 4, 6 ] }
+   * ```
    *
    * @since 3.6.0
    * @category sequencing
@@ -5670,6 +5856,7 @@ export const onStart: {
    * Adds an effect to be executed at the start of the stream.
    *
    * @example
+   * ```ts
    * import { Console, Effect, Stream } from "effect"
    *
    * const stream = Stream.make(1, 2, 3).pipe(
@@ -5684,6 +5871,7 @@ export const onStart: {
    * // after mapping: 4
    * // after mapping: 6
    * // { _id: 'Chunk', values: [ 2, 4, 6 ] }
+   * ```
    *
    * @since 3.6.0
    * @category sequencing
@@ -5916,6 +6104,7 @@ export const orElseSucceed: {
  * APIs, hence the name.
  *
  * @example
+ * ```ts
  * import { Effect, Option, Stream } from "effect"
  *
  * const stream = Stream.paginate(0, (n) => [
@@ -5925,6 +6114,7 @@ export const orElseSucceed: {
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 0, 1, 2, 3 ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -5972,11 +6162,12 @@ export const paginateEffect: <S, A, E, R>(
 
 /**
  * Partition a stream using a predicate. The first stream will contain all
- * element evaluated to true and the second one will contain all element
- * evaluated to false. The faster stream may advance by up to buffer elements
+ * element evaluated to false and the second one will contain all element
+ * evaluated to true. The faster stream may advance by up to buffer elements
  * further than the slower one.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const partition = Stream.range(1, 10).pipe(
@@ -5985,15 +6176,16 @@ export const paginateEffect: <S, A, E, R>(
  *
  * const program = Effect.scoped(
  *   Effect.gen(function*() {
- *     const [evens, odds] = yield* partition
- *     console.log(yield* Stream.runCollect(evens))
+ *     const [odds, evens] = yield* partition
  *     console.log(yield* Stream.runCollect(odds))
+ *     console.log(yield* Stream.runCollect(evens))
  *   })
  * )
  *
  * // Effect.runPromise(program)
- * // { _id: 'Chunk', values: [ 2, 4, 6, 8, 10 ] }
  * // { _id: 'Chunk', values: [ 1, 3, 5, 7, 9 ] }
+ * // { _id: 'Chunk', values: [ 2, 4, 6, 8, 10 ] }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -6001,11 +6193,12 @@ export const paginateEffect: <S, A, E, R>(
 export const partition: {
   /**
    * Partition a stream using a predicate. The first stream will contain all
-   * element evaluated to true and the second one will contain all element
-   * evaluated to false. The faster stream may advance by up to buffer elements
+   * element evaluated to false and the second one will contain all element
+   * evaluated to true. The faster stream may advance by up to buffer elements
    * further than the slower one.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const partition = Stream.range(1, 10).pipe(
@@ -6014,15 +6207,16 @@ export const partition: {
    *
    * const program = Effect.scoped(
    *   Effect.gen(function*() {
-   *     const [evens, odds] = yield* partition
-   *     console.log(yield* Stream.runCollect(evens))
+   *     const [odds, evens] = yield* partition
    *     console.log(yield* Stream.runCollect(odds))
+   *     console.log(yield* Stream.runCollect(evens))
    *   })
    * )
    *
    * // Effect.runPromise(program)
-   * // { _id: 'Chunk', values: [ 2, 4, 6, 8, 10 ] }
    * // { _id: 'Chunk', values: [ 1, 3, 5, 7, 9 ] }
+   * // { _id: 'Chunk', values: [ 2, 4, 6, 8, 10 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -6035,11 +6229,12 @@ export const partition: {
   ) => Effect.Effect<[excluded: Stream<Exclude<C, B>, E, never>, satisfying: Stream<B, E, never>], E, R | Scope.Scope>
   /**
    * Partition a stream using a predicate. The first stream will contain all
-   * element evaluated to true and the second one will contain all element
-   * evaluated to false. The faster stream may advance by up to buffer elements
+   * element evaluated to false and the second one will contain all element
+   * evaluated to true. The faster stream may advance by up to buffer elements
    * further than the slower one.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const partition = Stream.range(1, 10).pipe(
@@ -6048,15 +6243,16 @@ export const partition: {
    *
    * const program = Effect.scoped(
    *   Effect.gen(function*() {
-   *     const [evens, odds] = yield* partition
-   *     console.log(yield* Stream.runCollect(evens))
+   *     const [odds, evens] = yield* partition
    *     console.log(yield* Stream.runCollect(odds))
+   *     console.log(yield* Stream.runCollect(evens))
    *   })
    * )
    *
    * // Effect.runPromise(program)
-   * // { _id: 'Chunk', values: [ 2, 4, 6, 8, 10 ] }
    * // { _id: 'Chunk', values: [ 1, 3, 5, 7, 9 ] }
+   * // { _id: 'Chunk', values: [ 2, 4, 6, 8, 10 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -6069,11 +6265,12 @@ export const partition: {
   ) => Effect.Effect<[excluded: Stream<A, E, never>, satisfying: Stream<A, E, never>], E, Scope.Scope | R>
   /**
    * Partition a stream using a predicate. The first stream will contain all
-   * element evaluated to true and the second one will contain all element
-   * evaluated to false. The faster stream may advance by up to buffer elements
+   * element evaluated to false and the second one will contain all element
+   * evaluated to true. The faster stream may advance by up to buffer elements
    * further than the slower one.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const partition = Stream.range(1, 10).pipe(
@@ -6082,15 +6279,16 @@ export const partition: {
    *
    * const program = Effect.scoped(
    *   Effect.gen(function*() {
-   *     const [evens, odds] = yield* partition
-   *     console.log(yield* Stream.runCollect(evens))
+   *     const [odds, evens] = yield* partition
    *     console.log(yield* Stream.runCollect(odds))
+   *     console.log(yield* Stream.runCollect(evens))
    *   })
    * )
    *
    * // Effect.runPromise(program)
-   * // { _id: 'Chunk', values: [ 2, 4, 6, 8, 10 ] }
    * // { _id: 'Chunk', values: [ 1, 3, 5, 7, 9 ] }
+   * // { _id: 'Chunk', values: [ 2, 4, 6, 8, 10 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -6102,11 +6300,12 @@ export const partition: {
   ): Effect.Effect<[excluded: Stream<Exclude<C, B>, E, never>, satisfying: Stream<B, E, never>], E, R | Scope.Scope>
   /**
    * Partition a stream using a predicate. The first stream will contain all
-   * element evaluated to true and the second one will contain all element
-   * evaluated to false. The faster stream may advance by up to buffer elements
+   * element evaluated to false and the second one will contain all element
+   * evaluated to true. The faster stream may advance by up to buffer elements
    * further than the slower one.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const partition = Stream.range(1, 10).pipe(
@@ -6115,15 +6314,16 @@ export const partition: {
    *
    * const program = Effect.scoped(
    *   Effect.gen(function*() {
-   *     const [evens, odds] = yield* partition
-   *     console.log(yield* Stream.runCollect(evens))
+   *     const [odds, evens] = yield* partition
    *     console.log(yield* Stream.runCollect(odds))
+   *     console.log(yield* Stream.runCollect(evens))
    *   })
    * )
    *
    * // Effect.runPromise(program)
-   * // { _id: 'Chunk', values: [ 2, 4, 6, 8, 10 ] }
    * // { _id: 'Chunk', values: [ 1, 3, 5, 7, 9 ] }
+   * // { _id: 'Chunk', values: [ 2, 4, 6, 8, 10 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -6140,6 +6340,7 @@ export const partition: {
  * up to buffer elements further than the slower one.
  *
  * @example
+ * ```ts
  * import { Effect, Either, Stream } from "effect"
  *
  * const partition = Stream.range(1, 9).pipe(
@@ -6160,6 +6361,7 @@ export const partition: {
  * // Effect.runPromise(program)
  * // { _id: 'Chunk', values: [ 2, 4, 6, 8 ] }
  * // { _id: 'Chunk', values: [ 1, 3, 5, 7, 9 ] }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -6170,6 +6372,7 @@ export const partitionEither: {
    * up to buffer elements further than the slower one.
    *
    * @example
+   * ```ts
    * import { Effect, Either, Stream } from "effect"
    *
    * const partition = Stream.range(1, 9).pipe(
@@ -6190,6 +6393,7 @@ export const partitionEither: {
    * // Effect.runPromise(program)
    * // { _id: 'Chunk', values: [ 2, 4, 6, 8 ] }
    * // { _id: 'Chunk', values: [ 1, 3, 5, 7, 9 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -6205,6 +6409,7 @@ export const partitionEither: {
    * up to buffer elements further than the slower one.
    *
    * @example
+   * ```ts
    * import { Effect, Either, Stream } from "effect"
    *
    * const partition = Stream.range(1, 9).pipe(
@@ -6225,6 +6430,7 @@ export const partitionEither: {
    * // Effect.runPromise(program)
    * // { _id: 'Chunk', values: [ 2, 4, 6, 8 ] }
    * // { _id: 'Chunk', values: [ 1, 3, 5, 7, 9 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -6596,6 +6802,7 @@ export const provideSomeLayer: {
  * Any upstream failures will cause the returned stream to fail.
  *
  * @example
+ * ```ts
  * import { Stream, Schedule, Console, Effect } from "effect"
  *
  * const stream = Stream.fromSchedule(Schedule.spaced('2 millis')).pipe(
@@ -6612,6 +6819,7 @@ export const provideSomeLayer: {
  * // 3
  * // 4
  * // 5
+ * ```
  * @since 3.7.0
  * @category racing
  */
@@ -6623,6 +6831,7 @@ export const race: {
    * Any upstream failures will cause the returned stream to fail.
    *
    * @example
+   * ```ts
    * import { Stream, Schedule, Console, Effect } from "effect"
    *
    * const stream = Stream.fromSchedule(Schedule.spaced('2 millis')).pipe(
@@ -6639,6 +6848,7 @@ export const race: {
    * // 3
    * // 4
    * // 5
+   * ```
    * @since 3.7.0
    * @category racing
    */
@@ -6650,6 +6860,7 @@ export const race: {
    * Any upstream failures will cause the returned stream to fail.
    *
    * @example
+   * ```ts
    * import { Stream, Schedule, Console, Effect } from "effect"
    *
    * const stream = Stream.fromSchedule(Schedule.spaced('2 millis')).pipe(
@@ -6666,6 +6877,7 @@ export const race: {
    * // 3
    * // 4
    * // 5
+   * ```
    * @since 3.7.0
    * @category racing
    */
@@ -6679,6 +6891,7 @@ export const race: {
  * Any upstream failures will cause the returned stream to fail.
  *
  * @example
+ * ```ts
  * import { Stream, Schedule, Console, Effect } from "effect"
  *
  * const stream = Stream.raceAll(
@@ -6695,6 +6908,7 @@ export const race: {
  * // 3
  * // 4
  * // 5
+ * ```
  * @since 3.5.0
  * @category racing
  */
@@ -6710,6 +6924,7 @@ export const raceAll: <S extends ReadonlyArray<Stream<any, any, any>>>(
  * Constructs a stream from a range of integers, including both endpoints.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * // A Stream with a range of numbers from 1 to 5
@@ -6717,6 +6932,7 @@ export const raceAll: <S extends ReadonlyArray<Stream<any, any, any>>>(
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3, 4, 5 ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -6810,12 +7026,14 @@ export const refineOrDieWith: {
  * execute normally, and then repeat again according to the provided schedule.
  *
  * @example
+ * ```ts
  * import { Effect, Schedule, Stream } from "effect"
  *
  * const stream = Stream.repeat(Stream.succeed(1), Schedule.forever)
  *
  * // Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 1, 1, 1, 1 ] }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -6826,12 +7044,14 @@ export const repeat: {
    * execute normally, and then repeat again according to the provided schedule.
    *
    * @example
+   * ```ts
    * import { Effect, Schedule, Stream } from "effect"
    *
    * const stream = Stream.repeat(Stream.succeed(1), Schedule.forever)
    *
    * // Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
    * // { _id: 'Chunk', values: [ 1, 1, 1, 1, 1 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -6842,12 +7062,14 @@ export const repeat: {
    * execute normally, and then repeat again according to the provided schedule.
    *
    * @example
+   * ```ts
    * import { Effect, Schedule, Stream } from "effect"
    *
    * const stream = Stream.repeat(Stream.succeed(1), Schedule.forever)
    *
    * // Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
    * // { _id: 'Chunk', values: [ 1, 1, 1, 1, 1 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -6860,12 +7082,14 @@ export const repeat: {
  * forever.
  *
  * @example
+ * ```ts
  * import { Effect, Random, Stream } from "effect"
  *
  * const stream = Stream.repeatEffect(Random.nextInt)
  *
  * // Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
  * // Example Output: { _id: 'Chunk', values: [ 3891571149, 4239494205, 2352981603, 2339111046, 1488052210 ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -6898,6 +7122,7 @@ export const repeatEffectChunkOption: <A, E, R>(
  * with `None`.
  *
  * @example
+ * ```ts
  * // In this example, we're draining an Iterator to create a stream from it
  * import { Stream, Effect, Option } from "effect"
  *
@@ -6912,6 +7137,7 @@ export const repeatEffectChunkOption: <A, E, R>(
  *       })
  *     )
  *   )
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -7061,12 +7287,14 @@ export const repeatElementsWith: {
  * Repeats the provided value infinitely.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.repeatValue(0)
  *
  * // Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
  * // { _id: 'Chunk', values: [ 0, 0, 0, 0, 0 ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -7192,8 +7420,7 @@ export const run: {
  * @since 2.0.0
  * @category destructors
  */
-export const runCollect: <A, E, R>(self: Stream<A, E, R>) => Effect.Effect<Chunk.Chunk<A>, E, Exclude<R, Scope.Scope>> =
-  internal.runCollect
+export const runCollect: <A, E, R>(self: Stream<A, E, R>) => Effect.Effect<Chunk.Chunk<A>, E, R> = internal.runCollect
 
 /**
  * Runs the stream and emits the number of elements processed
@@ -7201,8 +7428,7 @@ export const runCollect: <A, E, R>(self: Stream<A, E, R>) => Effect.Effect<Chunk
  * @since 2.0.0
  * @category destructors
  */
-export const runCount: <A, E, R>(self: Stream<A, E, R>) => Effect.Effect<number, E, Exclude<R, Scope.Scope>> =
-  internal.runCount
+export const runCount: <A, E, R>(self: Stream<A, E, R>) => Effect.Effect<number, E, R> = internal.runCount
 
 /**
  * Runs the stream only for its effects. The emitted elements are discarded.
@@ -7210,8 +7436,7 @@ export const runCount: <A, E, R>(self: Stream<A, E, R>) => Effect.Effect<number,
  * @since 2.0.0
  * @category destructors
  */
-export const runDrain: <A, E, R>(self: Stream<A, E, R>) => Effect.Effect<void, E, Exclude<R, Scope.Scope>> =
-  internal.runDrain
+export const runDrain: <A, E, R>(self: Stream<A, E, R>) => Effect.Effect<void, E, R> = internal.runDrain
 
 /**
  * Executes a pure fold over the stream of values - reduces all elements in
@@ -7228,7 +7453,7 @@ export const runFold: {
    * @since 2.0.0
    * @category destructors
    */
-  <S, A>(s: S, f: (s: S, a: A) => S): <E, R>(self: Stream<A, E, R>) => Effect.Effect<S, E, Exclude<R, Scope.Scope>>
+  <S, A>(s: S, f: (s: S, a: A) => S): <E, R>(self: Stream<A, E, R>) => Effect.Effect<S, E, R>
   /**
    * Executes a pure fold over the stream of values - reduces all elements in
    * the stream to a value of type `S`.
@@ -7236,7 +7461,7 @@ export const runFold: {
    * @since 2.0.0
    * @category destructors
    */
-  <A, E, R, S>(self: Stream<A, E, R>, s: S, f: (s: S, a: A) => S): Effect.Effect<S, E, Exclude<R, Scope.Scope>>
+  <A, E, R, S>(self: Stream<A, E, R>, s: S, f: (s: S, a: A) => S): Effect.Effect<S, E, R>
 } = internal.runFold
 
 /**
@@ -7343,11 +7568,7 @@ export const runFoldWhile: {
    * @since 2.0.0
    * @category destructors
    */
-  <S, A>(
-    s: S,
-    cont: Predicate<S>,
-    f: (s: S, a: A) => S
-  ): <E, R>(self: Stream<A, E, R>) => Effect.Effect<S, E, Exclude<R, Scope.Scope>>
+  <S, A>(s: S, cont: Predicate<S>, f: (s: S, a: A) => S): <E, R>(self: Stream<A, E, R>) => Effect.Effect<S, E, R>
   /**
    * Reduces the elements in the stream to a value of type `S`. Stops the fold
    * early when the condition is not fulfilled. Example:
@@ -7355,12 +7576,7 @@ export const runFoldWhile: {
    * @since 2.0.0
    * @category destructors
    */
-  <A, E, R, S>(
-    self: Stream<A, E, R>,
-    s: S,
-    cont: Predicate<S>,
-    f: (s: S, a: A) => S
-  ): Effect.Effect<S, E, Exclude<R, Scope.Scope>>
+  <A, E, R, S>(self: Stream<A, E, R>, s: S, cont: Predicate<S>, f: (s: S, a: A) => S): Effect.Effect<S, E, R>
 } = internal.runFoldWhile
 
 /**
@@ -7852,12 +8068,14 @@ export const runSum: <E, R>(self: Stream<number, E, R>) => Effect.Effect<number,
  * intermediate results of type `S` given an initial S.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.range(1, 6).pipe(Stream.scan(0, (a, b) => a + b))
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 0,  1,  3, 6, 10, 15, 21 ] }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -7868,12 +8086,14 @@ export const scan: {
    * intermediate results of type `S` given an initial S.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.range(1, 6).pipe(Stream.scan(0, (a, b) => a + b))
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 0,  1,  3, 6, 10, 15, 21 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -7884,12 +8104,14 @@ export const scan: {
    * intermediate results of type `S` given an initial S.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.range(1, 6).pipe(Stream.scan(0, (a, b) => a + b))
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 0,  1,  3, 6, 10, 15, 21 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -8064,6 +8286,7 @@ export const scheduleWith: {
  * Creates a single-valued stream from a scoped resource.
  *
  * @example
+ * ```ts
  * import { Console, Effect, Stream } from "effect"
  *
  * // Creating a single-valued stream from a scoped resource
@@ -8080,6 +8303,7 @@ export const scheduleWith: {
  * // use
  * // release
  * // { _id: 'Chunk', values: [ undefined ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -8087,6 +8311,17 @@ export const scheduleWith: {
 export const scoped: <A, E, R>(effect: Effect.Effect<A, E, R>) => Stream<A, E, Exclude<R, Scope.Scope>> =
   internal.scoped
 
+/**
+ * Use a function that receives a scope and returns an effect to emit an output
+ * element. The output element will be the result of the returned effect, if
+ * successful.
+ *
+ * @since 3.11.0
+ * @category constructors
+ */
+export const scopedWith: <A, E, R>(f: (scope: Scope.Scope) => Effect.Effect<A, E, R>) => Stream<A, E, R> =
+  internal.scopedWith
+
 /**
  * Emits a sliding window of `n` elements.
  *
@@ -8358,6 +8593,7 @@ export const splitLines: <E, R>(self: Stream<string, E, R>) => Stream<string, E,
  * Creates a single-valued pure stream.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * // A Stream with a single number
@@ -8365,6 +8601,7 @@ export const splitLines: <E, R>(self: Stream<string, E, R>) => Stream<string, E,
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 3 ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -8391,12 +8628,14 @@ export const suspend: <A, E, R>(stream: LazyArg<Stream<A, E, R>>) => Stream<A, E
  * Takes the specified number of elements from this stream.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.take(Stream.iterate(0, (n) => n + 1), 5)
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4 ] }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -8406,12 +8645,14 @@ export const take: {
    * Takes the specified number of elements from this stream.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.take(Stream.iterate(0, (n) => n + 1), 5)
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -8421,12 +8662,14 @@ export const take: {
    * Takes the specified number of elements from this stream.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.take(Stream.iterate(0, (n) => n + 1), 5)
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -8438,12 +8681,14 @@ export const take: {
  * Takes the last specified number of elements from this stream.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.takeRight(Stream.make(1, 2, 3, 4, 5, 6), 3)
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 4, 5, 6 ] }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -8453,12 +8698,14 @@ export const takeRight: {
    * Takes the last specified number of elements from this stream.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.takeRight(Stream.make(1, 2, 3, 4, 5, 6), 3)
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 4, 5, 6 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -8468,12 +8715,14 @@ export const takeRight: {
    * Takes the last specified number of elements from this stream.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.takeRight(Stream.make(1, 2, 3, 4, 5, 6), 3)
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 4, 5, 6 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -8486,12 +8735,14 @@ export const takeRight: {
  * `true`.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.takeUntil(Stream.iterate(0, (n) => n + 1), (n) => n === 4)
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4 ] }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -8502,12 +8753,14 @@ export const takeUntil: {
    * `true`.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.takeUntil(Stream.iterate(0, (n) => n + 1), (n) => n === 4)
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -8518,12 +8771,14 @@ export const takeUntil: {
    * `true`.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.takeUntil(Stream.iterate(0, (n) => n + 1), (n) => n === 4)
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -8567,12 +8822,14 @@ export const takeUntilEffect: {
  * evaluates to `true`.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.takeWhile(Stream.iterate(0, (n) => n + 1), (n) => n < 5)
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4 ] }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -8583,12 +8840,14 @@ export const takeWhile: {
    * evaluates to `true`.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.takeWhile(Stream.iterate(0, (n) => n + 1), (n) => n < 5)
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -8599,12 +8858,14 @@ export const takeWhile: {
    * evaluates to `true`.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.takeWhile(Stream.iterate(0, (n) => n + 1), (n) => n < 5)
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -8615,12 +8876,14 @@ export const takeWhile: {
    * evaluates to `true`.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.takeWhile(Stream.iterate(0, (n) => n + 1), (n) => n < 5)
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -8631,12 +8894,14 @@ export const takeWhile: {
    * evaluates to `true`.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.takeWhile(Stream.iterate(0, (n) => n + 1), (n) => n < 5)
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -8648,6 +8913,7 @@ export const takeWhile: {
  * Adds an effect to consumption of every element of the stream.
  *
  * @example
+ * ```ts
  * import { Console, Effect, Stream } from "effect"
  *
  * const stream = Stream.make(1, 2, 3).pipe(
@@ -8664,6 +8930,7 @@ export const takeWhile: {
  * // before mapping: 3
  * // after mapping: 6
  * // { _id: 'Chunk', values: [ 2, 4, 6 ] }
+ * ```
  *
  * @since 2.0.0
  * @category sequencing
@@ -8673,6 +8940,7 @@ export const tap: {
    * Adds an effect to consumption of every element of the stream.
    *
    * @example
+   * ```ts
    * import { Console, Effect, Stream } from "effect"
    *
    * const stream = Stream.make(1, 2, 3).pipe(
@@ -8689,6 +8957,7 @@ export const tap: {
    * // before mapping: 3
    * // after mapping: 6
    * // { _id: 'Chunk', values: [ 2, 4, 6 ] }
+   * ```
    *
    * @since 2.0.0
    * @category sequencing
@@ -8700,6 +8969,7 @@ export const tap: {
    * Adds an effect to consumption of every element of the stream.
    *
    * @example
+   * ```ts
    * import { Console, Effect, Stream } from "effect"
    *
    * const stream = Stream.make(1, 2, 3).pipe(
@@ -8716,6 +8986,7 @@ export const tap: {
    * // before mapping: 3
    * // after mapping: 6
    * // { _id: 'Chunk', values: [ 2, 4, 6 ] }
+   * ```
    *
    * @since 2.0.0
    * @category sequencing
@@ -8856,6 +9127,7 @@ export const tapSink: {
  * Defaults to the "shape" strategy.
  *
  * @example
+ * ```ts
  * import { Chunk, Effect, Schedule, Stream } from "effect"
  *
  * let last = Date.now()
@@ -8891,6 +9163,7 @@ export const tapSink: {
  * // Received 5 after 52ms
  * // > Emitted 5 after 49ms
  * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4, 5 ] }
+ * ```
  *
  * @since 2.0.0
  * @category utils
@@ -8910,6 +9183,7 @@ export const throttle: {
    * Defaults to the "shape" strategy.
    *
    * @example
+   * ```ts
    * import { Chunk, Effect, Schedule, Stream } from "effect"
    *
    * let last = Date.now()
@@ -8945,6 +9219,7 @@ export const throttle: {
    * // Received 5 after 52ms
    * // > Emitted 5 after 49ms
    * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4, 5 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -8972,6 +9247,7 @@ export const throttle: {
    * Defaults to the "shape" strategy.
    *
    * @example
+   * ```ts
    * import { Chunk, Effect, Schedule, Stream } from "effect"
    *
    * let last = Date.now()
@@ -9007,6 +9283,7 @@ export const throttle: {
    * // Received 5 after 52ms
    * // > Emitted 5 after 49ms
    * // { _id: 'Chunk', values: [ 0, 1, 2, 3, 4, 5 ] }
+   * ```
    *
    * @since 2.0.0
    * @category utils
@@ -9097,6 +9374,7 @@ export const throttleEffect: {
  * A stream that emits void values spaced by the specified duration.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * let last = Date.now()
@@ -9116,6 +9394,7 @@ export const throttleEffect: {
  * // tick after 1002ms
  * // tick after 1002ms
  * // { _id: 'Chunk', values: [ undefined, undefined, undefined, undefined, undefined ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -9287,6 +9566,7 @@ export const toPubSub: {
  * the stream's output.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * // Simulate a chunked stream
@@ -9311,6 +9591,7 @@ export const toPubSub: {
  * //   "_id": "Option",
  * //   "_tag": "None"
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category destructors
@@ -9530,12 +9811,14 @@ export const transduce: {
  * Creates a stream by peeling off the "layers" of a value of type `S`.
  *
  * @example
+ * ```ts
  * import { Effect, Option, Stream } from "effect"
  *
  * const stream = Stream.unfold(1, (n) => Option.some([n, n + 1]))
  *
  * // Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
  * // { _id: 'Chunk', values: [ 1, 2, 3, 4, 5 ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -9570,6 +9853,7 @@ export const unfoldChunkEffect: <S, A, E, R>(
  * `S`.
  *
  * @example
+ * ```ts
  * import { Effect, Option, Random, Stream } from "effect"
  *
  * const stream = Stream.unfoldEffect(1, (n) =>
@@ -9579,6 +9863,7 @@ export const unfoldChunkEffect: <S, A, E, R>(
  *
  * // Effect.runPromise(Stream.runCollect(stream.pipe(Stream.take(5)))).then(console.log)
  * // { _id: 'Chunk', values: [ 1, -1, -1, -1, -1 ] }
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -9594,6 +9879,7 @@ export {
    * A stream that contains a single `void` value.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.void
@@ -9601,6 +9887,7 @@ export {
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ undefined ] }
    *
+   * ```
    * @since 2.0.0
    * @category constructors
    */
@@ -9626,6 +9913,18 @@ export const unwrapScoped: <A, E2, R2, E, R>(
   effect: Effect.Effect<Stream<A, E2, R2>, E, R>
 ) => Stream<A, E | E2, R2 | Exclude<R, Scope.Scope>> = internal.unwrapScoped
 
+/**
+ * Creates a stream produced from a function which receives a `Scope` and
+ * returns an `Effect`. The resulting stream will emit a single element, which
+ * will be the result of the returned effect, if successful.
+ *
+ * @since 3.11.0
+ * @category constructors
+ */
+export const unwrapScopedWith: <A, E2, R2, E, R>(
+  f: (scope: Scope.Scope) => Effect.Effect<Stream<A, E2, R2>, E, R>
+) => Stream<A, E | E2, R | R2> = internal.unwrapScopedWith
+
 /**
  * Updates the specified service within the context of the `Stream`.
  *
@@ -9788,6 +10087,7 @@ export const withSpan: {
  * The new stream will end when one of the sides ends.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * // We create two streams and zip them together.
@@ -9798,6 +10098,7 @@ export const withSpan: {
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ [ 1, 'a' ], [ 2, 'b' ], [ 3, 'c' ] ] }
+ * ```
  *
  * @since 2.0.0
  * @category zipping
@@ -9810,6 +10111,7 @@ export const zip: {
    * The new stream will end when one of the sides ends.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * // We create two streams and zip them together.
@@ -9820,6 +10122,7 @@ export const zip: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ [ 1, 'a' ], [ 2, 'b' ], [ 3, 'c' ] ] }
+   * ```
    *
    * @since 2.0.0
    * @category zipping
@@ -9832,6 +10135,7 @@ export const zip: {
    * The new stream will end when one of the sides ends.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * // We create two streams and zip them together.
@@ -9842,6 +10146,7 @@ export const zip: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ [ 1, 'a' ], [ 2, 'b' ], [ 3, 'c' ] ] }
+   * ```
    *
    * @since 2.0.0
    * @category zipping
@@ -9894,6 +10199,7 @@ export const zipFlatten: {
  * have different lengths and one of the streams has ended before the other.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.zipAll(Stream.make(1, 2, 3, 4, 5, 6), {
@@ -9904,6 +10210,7 @@ export const zipFlatten: {
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: "Chunk", values: [ [ 1, "a" ], [ 2, "b" ], [ 3, "c" ], [ 4, "x" ], [ 5, "x" ], [ 6, "x" ] ] }
+ * ```
  *
  * @since 2.0.0
  * @category zipping
@@ -9917,6 +10224,7 @@ export const zipAll: {
    * have different lengths and one of the streams has ended before the other.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.zipAll(Stream.make(1, 2, 3, 4, 5, 6), {
@@ -9927,6 +10235,7 @@ export const zipAll: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: "Chunk", values: [ [ 1, "a" ], [ 2, "b" ], [ 3, "c" ], [ 4, "x" ], [ 5, "x" ], [ 6, "x" ] ] }
+   * ```
    *
    * @since 2.0.0
    * @category zipping
@@ -9942,6 +10251,7 @@ export const zipAll: {
    * have different lengths and one of the streams has ended before the other.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.zipAll(Stream.make(1, 2, 3, 4, 5, 6), {
@@ -9952,6 +10262,7 @@ export const zipAll: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: "Chunk", values: [ [ 1, "a" ], [ 2, "b" ], [ 3, "c" ], [ 4, "x" ], [ 5, "x" ], [ 6, "x" ] ] }
+   * ```
    *
    * @since 2.0.0
    * @category zipping
@@ -10283,6 +10594,7 @@ export const zipAllSortedByKeyWith: {
  * lengths and one of the streams has ended before the other.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.zipAllWith(Stream.make(1, 2, 3, 4, 5, 6), {
@@ -10294,6 +10606,7 @@ export const zipAllSortedByKeyWith: {
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: "Chunk", values: [ [ 0, "a" ], [ 1, "b" ], [ 2, "c" ], [ 4, "x" ], [ 5, "x" ], [ 6, "x" ] ] }
+ * ```
  *
  * @since 2.0.0
  * @category zipping
@@ -10307,6 +10620,7 @@ export const zipAllWith: {
    * lengths and one of the streams has ended before the other.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.zipAllWith(Stream.make(1, 2, 3, 4, 5, 6), {
@@ -10318,6 +10632,7 @@ export const zipAllWith: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: "Chunk", values: [ [ 0, "a" ], [ 1, "b" ], [ 2, "c" ], [ 4, "x" ], [ 5, "x" ], [ 6, "x" ] ] }
+   * ```
    *
    * @since 2.0.0
    * @category zipping
@@ -10338,6 +10653,7 @@ export const zipAllWith: {
    * lengths and one of the streams has ended before the other.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * const stream = Stream.zipAllWith(Stream.make(1, 2, 3, 4, 5, 6), {
@@ -10349,6 +10665,7 @@ export const zipAllWith: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: "Chunk", values: [ [ 0, "a" ], [ 1, "b" ], [ 2, "c" ], [ 4, "x" ], [ 5, "x" ], [ 6, "x" ] ] }
+   * ```
    *
    * @since 2.0.0
    * @category zipping
@@ -10374,6 +10691,7 @@ export const zipAllWith: {
  * used for zipping.
  *
  * @example
+ * ```ts
  * import { Effect, Schedule, Stream } from "effect"
  *
  * const s1 = Stream.make(1, 2, 3).pipe(
@@ -10388,6 +10706,7 @@ export const zipAllWith: {
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: "Chunk", values: [ [ 1, "a" ], [ 1, "b" ], [ 2, "b" ], [ 2, "c" ], [ 2, "d" ], [ 3, "d" ] ] }
+ * ```
  *
  * @since 2.0.0
  * @category zipping
@@ -10403,6 +10722,7 @@ export const zipLatest: {
    * used for zipping.
    *
    * @example
+   * ```ts
    * import { Effect, Schedule, Stream } from "effect"
    *
    * const s1 = Stream.make(1, 2, 3).pipe(
@@ -10417,6 +10737,7 @@ export const zipLatest: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: "Chunk", values: [ [ 1, "a" ], [ 1, "b" ], [ 2, "b" ], [ 2, "c" ], [ 2, "d" ], [ 3, "d" ] ] }
+   * ```
    *
    * @since 2.0.0
    * @category zipping
@@ -10432,6 +10753,7 @@ export const zipLatest: {
    * used for zipping.
    *
    * @example
+   * ```ts
    * import { Effect, Schedule, Stream } from "effect"
    *
    * const s1 = Stream.make(1, 2, 3).pipe(
@@ -10446,6 +10768,7 @@ export const zipLatest: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: "Chunk", values: [ [ 1, "a" ], [ 1, "b" ], [ 2, "b" ], [ 2, "c" ], [ 2, "d" ], [ 3, "d" ] ] }
+   * ```
    *
    * @since 2.0.0
    * @category zipping
@@ -10462,6 +10785,7 @@ export const zipLatest: {
  * used for zipping.
  *
  * @example
+ * ```ts
  * import { Stream, Schedule, Console, Effect } from "effect"
  *
  * const stream = Stream.zipLatestAll(
@@ -10479,6 +10803,7 @@ export const zipLatest: {
  * // [ 3, 1, 0 ]
  * // [ 3, 1, 1 ]
  * // .....
+ * ```
  *
  * @since 3.3.0
  * @category zipping
@@ -10611,6 +10936,7 @@ export const zipRight: {
  * The new stream will end when one of the sides ends.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * // We create two streams and zip them with custom logic.
@@ -10622,6 +10948,7 @@ export const zipRight: {
  *
  * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
  * // { _id: 'Chunk', values: [ [ 0, 'a' ], [ 1, 'b' ], [ 2, 'c' ] ] }
+ * ```
  *
  * @since 2.0.0
  * @category zipping
@@ -10634,6 +10961,7 @@ export const zipWith: {
    * The new stream will end when one of the sides ends.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * // We create two streams and zip them with custom logic.
@@ -10645,6 +10973,7 @@ export const zipWith: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ [ 0, 'a' ], [ 1, 'b' ], [ 2, 'c' ] ] }
+   * ```
    *
    * @since 2.0.0
    * @category zipping
@@ -10660,6 +10989,7 @@ export const zipWith: {
    * The new stream will end when one of the sides ends.
    *
    * @example
+   * ```ts
    * import { Effect, Stream } from "effect"
    *
    * // We create two streams and zip them with custom logic.
@@ -10671,6 +11001,7 @@ export const zipWith: {
    *
    * // Effect.runPromise(Stream.runCollect(stream)).then(console.log)
    * // { _id: 'Chunk', values: [ [ 0, 'a' ], [ 1, 'b' ], [ 2, 'c' ] ] }
+   * ```
    *
    * @since 2.0.0
    * @category zipping
@@ -10731,6 +11062,7 @@ export const zipWithChunks: {
  * Zips each element with the next element if present.
  *
  * @example
+ * ```ts
  * import { Chunk, Effect, Stream } from "effect"
  *
  * const stream = Stream.zipWithNext(Stream.make(1, 2, 3, 4))
@@ -10742,6 +11074,7 @@ export const zipWithChunks: {
  * //   [ 3, { _id: 'Option', _tag: 'Some', value: 4 } ],
  * //   [ 4, { _id: 'Option', _tag: 'None' } ]
  * // ]
+ * ```
  *
  * @since 2.0.0
  * @category zipping
@@ -10753,6 +11086,7 @@ export const zipWithNext: <A, E, R>(self: Stream<A, E, R>) => Stream<[A, Option.
  * `None`.
  *
  * @example
+ * ```ts
  * import { Chunk, Effect, Stream } from "effect"
  *
  * const stream = Stream.zipWithPrevious(Stream.make(1, 2, 3, 4))
@@ -10764,6 +11098,7 @@ export const zipWithNext: <A, E, R>(self: Stream<A, E, R>) => Stream<[A, Option.
  * //   [ { _id: 'Option', _tag: 'Some', value: 2 }, 3 ],
  * //   [ { _id: 'Option', _tag: 'Some', value: 3 }, 4 ]
  * // ]
+ * ```
  *
  * @since 2.0.0
  * @category zipping
@@ -10775,6 +11110,7 @@ export const zipWithPrevious: <A, E, R>(self: Stream<A, E, R>) => Stream<[Option
  * Zips each element with both the previous and next element.
  *
  * @example
+ * ```ts
  * import { Chunk, Effect, Stream } from "effect"
  *
  * const stream = Stream.zipWithPreviousAndNext(Stream.make(1, 2, 3, 4))
@@ -10802,6 +11138,7 @@ export const zipWithPrevious: <A, E, R>(self: Stream<A, E, R>) => Stream<[Option
  * //     { _id: 'Option', _tag: 'None' }
  * //   ]
  * // ]
+ * ```
  *
  * @since 2.0.0
  * @category zipping
@@ -10814,6 +11151,7 @@ export const zipWithPreviousAndNext: <A, E, R>(
  * Zips this stream together with the index of elements.
  *
  * @example
+ * ```ts
  * import { Effect, Stream } from "effect"
  *
  * const stream = Stream.make("Mary", "James", "Robert", "Patricia")
@@ -10825,6 +11163,7 @@ export const zipWithPreviousAndNext: <A, E, R>(
  * //   _id: 'Chunk',
  * //   values: [ [ 'Mary', 0 ], [ 'James', 1 ], [ 'Robert', 2 ], [ 'Patricia', 3 ] ]
  * // }
+ * ```
  *
  * @since 2.0.0
  * @category zipping
@@ -10851,6 +11190,7 @@ export const zipWithIndex: <A, E, R>(self: Stream<A, E, R>) => Stream<[A, number
  * @see {@link let_ let}
  *
  * @example
+ * ```ts
  * import { Chunk, Effect, pipe, Stream } from "effect"
  *
  * const result = pipe(
@@ -10860,6 +11200,7 @@ export const zipWithIndex: <A, E, R>(self: Stream<A, E, R>) => Stream<[A, number
  *   Stream.let("sum", ({ x, y }) => x + y)
  * )
  * assert.deepStrictEqual(Effect.runSync(Stream.runCollect(result)), Chunk.of({ x: 2, y: 3, sum: 5 }))
+ * ```
  *
  * @category do notation
  * @since 2.0.0
@@ -10882,6 +11223,7 @@ export const Do: Stream<{}> = internal.Do
  * @see {@link let_ let}
  *
  * @example
+ * ```ts
  * import { Chunk, Effect, pipe, Stream } from "effect"
  *
  * const result = pipe(
@@ -10891,6 +11233,7 @@ export const Do: Stream<{}> = internal.Do
  *   Stream.let("sum", ({ x, y }) => x + y)
  * )
  * assert.deepStrictEqual(Effect.runSync(Stream.runCollect(result)), Chunk.of({ x: 2, y: 3, sum: 5 }))
+ * ```
  *
  * @category do notation
  * @since 2.0.0
@@ -10912,6 +11255,7 @@ export const bind: {
    * @see {@link let_ let}
    *
    * @example
+   * ```ts
    * import { Chunk, Effect, pipe, Stream } from "effect"
    *
    * const result = pipe(
@@ -10921,6 +11265,7 @@ export const bind: {
    *   Stream.let("sum", ({ x, y }) => x + y)
    * )
    * assert.deepStrictEqual(Effect.runSync(Stream.runCollect(result)), Chunk.of({ x: 2, y: 3, sum: 5 }))
+   * ```
    *
    * @category do notation
    * @since 2.0.0
@@ -10948,6 +11293,7 @@ export const bind: {
    * @see {@link let_ let}
    *
    * @example
+   * ```ts
    * import { Chunk, Effect, pipe, Stream } from "effect"
    *
    * const result = pipe(
@@ -10957,6 +11303,7 @@ export const bind: {
    *   Stream.let("sum", ({ x, y }) => x + y)
    * )
    * assert.deepStrictEqual(Effect.runSync(Stream.runCollect(result)), Chunk.of({ x: 2, y: 3, sum: 5 }))
+   * ```
    *
    * @category do notation
    * @since 2.0.0
@@ -11034,6 +11381,7 @@ export const bindEffect: {
  * @see {@link let_ let}
  *
  * @example
+ * ```ts
  * import { Chunk, Effect, pipe, Stream } from "effect"
  *
  * const result = pipe(
@@ -11043,6 +11391,7 @@ export const bindEffect: {
  *   Stream.let("sum", ({ x, y }) => x + y)
  * )
  * assert.deepStrictEqual(Effect.runSync(Stream.runCollect(result)), Chunk.of({ x: 2, y: 3, sum: 5 }))
+ * ```
  *
  * @category do notation
  * @since 2.0.0
@@ -11064,6 +11413,7 @@ export const bindTo: {
    * @see {@link let_ let}
    *
    * @example
+   * ```ts
    * import { Chunk, Effect, pipe, Stream } from "effect"
    *
    * const result = pipe(
@@ -11073,6 +11423,7 @@ export const bindTo: {
    *   Stream.let("sum", ({ x, y }) => x + y)
    * )
    * assert.deepStrictEqual(Effect.runSync(Stream.runCollect(result)), Chunk.of({ x: 2, y: 3, sum: 5 }))
+   * ```
    *
    * @category do notation
    * @since 2.0.0
@@ -11094,6 +11445,7 @@ export const bindTo: {
    * @see {@link let_ let}
    *
    * @example
+   * ```ts
    * import { Chunk, Effect, pipe, Stream } from "effect"
    *
    * const result = pipe(
@@ -11103,6 +11455,7 @@ export const bindTo: {
    *   Stream.let("sum", ({ x, y }) => x + y)
    * )
    * assert.deepStrictEqual(Effect.runSync(Stream.runCollect(result)), Chunk.of({ x: 2, y: 3, sum: 5 }))
+   * ```
    *
    * @category do notation
    * @since 2.0.0
@@ -11139,6 +11492,7 @@ export {
    * @see {@link bindEffect}
    *
    * @example
+   * ```ts
    * import { Chunk, Effect, pipe, Stream } from "effect"
    *
    * const result = pipe(
@@ -11149,6 +11503,7 @@ export {
    * )
    * assert.deepStrictEqual(Effect.runSync(Stream.runCollect(result)), Chunk.of({ x: 2, y: 3, sum: 5 }))
    *
+   * ```
    * @category do notation
    * @since 2.0.0
    */