effect 4.0.0-beta.102 → 4.0.0-beta.103

package/src/TxChunk.ts

@@ -35,7 +35,7 @@ const TypeId = "~effect/transactions/TxChunk"
  *
  * **Example** (Using a transactional chunk)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Chunk, Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -49,7 +49,6 @@ const TypeId = "~effect/transactions/TxChunk"
  *   // Single operations - no explicit transaction needed
  *   yield* TxChunk.append(txChunk, 4)
  *   const result = yield* TxChunk.get(txChunk)
- *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3, 4]
  *
  *   // Multi-step atomic operation - use explicit transaction
  *   yield* Effect.tx(
@@ -60,8 +59,10 @@ const TypeId = "~effect/transactions/TxChunk"
  *   )
  *
  *   const finalResult = yield* TxChunk.get(txChunk)
- *   console.log(Chunk.toReadonlyArray(finalResult)) // [0, 1, 2, 3, 4, 5]
+ *   return [Chunk.toArray(result), Chunk.toArray(finalResult)]
  * })
+ *
+ * await Effect.runPromise(program) // => [[1, 2, 3, 4], [0, 1, 2, 3, 4, 5]]
  * ```
  *
  * @category models
@@ -100,7 +101,7 @@ const TxChunkProto = {
  *
  * **Example** (Creating a TxChunk from a chunk)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Chunk, Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -110,8 +111,10 @@ const TxChunkProto = {
  *
  *   // Read the value - automatically transactional
  *   const result = yield* TxChunk.get(txChunk)
- *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3]
+ *   return Chunk.toArray(result)
  * })
+ *
+ * await Effect.runPromise(program) // => [1, 2, 3]
  * ```
  *
  * @category constructors
@@ -130,7 +133,7 @@ export const make = <A>(initial: Chunk.Chunk<A>): Effect.Effect<TxChunk<A>> =>
  *
  * **Example** (Creating an empty TxChunk)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -139,14 +142,15 @@ export const make = <A>(initial: Chunk.Chunk<A>): Effect.Effect<TxChunk<A>> =>
  *
  *   // Check if it's empty - automatically transactional
  *   const isEmpty = yield* TxChunk.isEmpty(txChunk)
- *   console.log(isEmpty) // true
  *
  *   // Add elements - automatically transactional
  *   yield* TxChunk.append(txChunk, 42)
  *
  *   const isStillEmpty = yield* TxChunk.isEmpty(txChunk)
- *   console.log(isStillEmpty) // false
+ *   return [isEmpty, isStillEmpty]
  * })
+ *
+ * await Effect.runPromise(program) // => [true, false]
  * ```
  *
  * @category constructors
@@ -165,7 +169,7 @@ export const empty = <A = never>(): Effect.Effect<TxChunk<A>> =>
  *
  * **Example** (Creating from an iterable)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Chunk, Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -174,7 +178,6 @@ export const empty = <A = never>(): Effect.Effect<TxChunk<A>> =>
  *
  *   // Read the contents - automatically transactional
  *   const chunk = yield* TxChunk.get(txChunk)
- *   console.log(Chunk.toReadonlyArray(chunk)) // [1, 2, 3, 4, 5]
  *
  *   // Multi-step atomic modification - use explicit transaction
  *   yield* Effect.tx(
@@ -185,8 +188,10 @@ export const empty = <A = never>(): Effect.Effect<TxChunk<A>> =>
  *   )
  *
  *   const updated = yield* TxChunk.get(txChunk)
- *   console.log(Chunk.toReadonlyArray(updated)) // [0, 1, 2, 3, 4, 5, 6]
+ *   return [Chunk.toArray(chunk), Chunk.toArray(updated)]
  * })
+ *
+ * await Effect.runPromise(program) // => [[1, 2, 3, 4, 5], [0, 1, 2, 3, 4, 5, 6]]
  * ```
  *
  * @category constructors
@@ -205,12 +210,13 @@ export const fromIterable = <A>(iterable: Iterable<A>): Effect.Effect<TxChunk<A>
  *
  * **Example** (Wrapping an existing TxRef)
  *
- * ```ts
- * import { Chunk, TxChunk, TxRef } from "effect"
+ * ```ts import.meta.vitest
+ * import { Chunk, Effect, TxChunk, TxRef } from "effect"
  *
  * // Create a TxChunk from an existing TxRef (advanced usage)
  * const ref = TxRef.makeUnsafe(Chunk.fromIterable([1, 2, 3]))
  * const txChunk = TxChunk.makeUnsafe(ref)
+ * Chunk.toArray(await Effect.runPromise(TxChunk.get(txChunk))) // => [1, 2, 3]
  * ```
  *
  * @category constructors
@@ -233,7 +239,7 @@ export const makeUnsafe = <A>(ref: TxRef.TxRef<Chunk.Chunk<A>>): TxChunk<A> => {
  *
  * **Example** (Modifying while returning a value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Chunk, Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -245,11 +251,11 @@ export const makeUnsafe = <A>(ref: TxRef.TxRef<Chunk.Chunk<A>>): TxChunk<A> => {
  *     Chunk.append(chunk, 4) // new value
  *   ])
  *
- *   console.log(oldSize) // 3
- *
  *   const newChunk = yield* TxChunk.get(txChunk)
- *   console.log(Chunk.toReadonlyArray(newChunk)) // [1, 2, 3, 4]
+ *   return [oldSize, Chunk.toArray(newChunk)]
  * })
+ *
+ * await Effect.runPromise(program) // => [3, [1, 2, 3, 4]]
  * ```
  *
  * @category combinators
@@ -266,7 +272,7 @@ export const modify: {
    *
    * **Example** (Modifying while returning a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -278,11 +284,11 @@ export const modify: {
    *     Chunk.append(chunk, 4) // new value
    *   ])
    *
-   *   console.log(oldSize) // 3
-   *
    *   const newChunk = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(newChunk)) // [1, 2, 3, 4]
+   *   return [oldSize, Chunk.toArray(newChunk)]
    * })
+   *
+   * await Effect.runPromise(program) // => [3, [1, 2, 3, 4]]
    * ```
    *
    * @category combinators
@@ -301,7 +307,7 @@ export const modify: {
    *
    * **Example** (Modifying while returning a value)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -313,11 +319,11 @@ export const modify: {
    *     Chunk.append(chunk, 4) // new value
    *   ])
    *
-   *   console.log(oldSize) // 3
-   *
    *   const newChunk = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(newChunk)) // [1, 2, 3, 4]
+   *   return [oldSize, Chunk.toArray(newChunk)]
    * })
+   *
+   * await Effect.runPromise(program) // => [3, [1, 2, 3, 4]]
    * ```
    *
    * @category combinators
@@ -345,7 +351,7 @@ export const modify: {
  *
  * **Example** (Updating the stored chunk)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Chunk, Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -355,8 +361,10 @@ export const modify: {
  *   yield* TxChunk.update(txChunk, (chunk) => Chunk.reverse(chunk))
  *
  *   const result = yield* TxChunk.get(txChunk)
- *   console.log(Chunk.toReadonlyArray(result)) // [3, 2, 1]
+ *   return Chunk.toArray(result)
  * })
+ *
+ * await Effect.runPromise(program) // => [3, 2, 1]
  * ```
  *
  * @category combinators
@@ -373,7 +381,7 @@ export const update: {
    *
    * **Example** (Updating the stored chunk)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -383,8 +391,10 @@ export const update: {
    *   yield* TxChunk.update(txChunk, (chunk) => Chunk.reverse(chunk))
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [3, 2, 1]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [3, 2, 1]
    * ```
    *
    * @category combinators
@@ -401,7 +411,7 @@ export const update: {
    *
    * **Example** (Updating the stored chunk)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -411,8 +421,10 @@ export const update: {
    *   yield* TxChunk.update(txChunk, (chunk) => Chunk.reverse(chunk))
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [3, 2, 1]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [3, 2, 1]
    * ```
    *
    * @category combinators
@@ -432,7 +444,7 @@ export const update: {
  *
  * **Example** (Reading the current chunk)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Chunk, Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -440,12 +452,10 @@ export const update: {
  *
  *   // Read the current value within a transaction
  *   const chunk = yield* TxChunk.get(txChunk)
- *   console.log(Chunk.toReadonlyArray(chunk)) // [1, 2, 3]
- *
- *   // The value is tracked for conflict detection
- *   const size = Chunk.size(chunk)
- *   console.log(size) // 3
+ *   return [Chunk.toArray(chunk), Chunk.size(chunk)]
  * })
+ *
+ * await Effect.runPromise(program) // => [[1, 2, 3], 3]
  * ```
  *
  * @category combinators
@@ -463,7 +473,7 @@ export const get = <A>(self: TxChunk<A>): Effect.Effect<Chunk.Chunk<A>> => TxRef
  *
  * **Example** (Replacing the stored chunk)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Chunk, Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -474,8 +484,10 @@ export const get = <A>(self: TxChunk<A>): Effect.Effect<Chunk.Chunk<A>> => TxRef
  *   yield* TxChunk.set(txChunk, newChunk)
  *
  *   const result = yield* TxChunk.get(txChunk)
- *   console.log(Chunk.toReadonlyArray(result)) // [10, 20, 30, 40]
+ *   return Chunk.toArray(result)
  * })
+ *
+ * await Effect.runPromise(program) // => [10, 20, 30, 40]
  * ```
  *
  * @category combinators
@@ -492,7 +504,7 @@ export const set: {
    *
    * **Example** (Replacing the stored chunk)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -503,8 +515,10 @@ export const set: {
    *   yield* TxChunk.set(txChunk, newChunk)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [10, 20, 30, 40]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [10, 20, 30, 40]
    * ```
    *
    * @category combinators
@@ -521,7 +535,7 @@ export const set: {
    *
    * **Example** (Replacing the stored chunk)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -532,8 +546,10 @@ export const set: {
    *   yield* TxChunk.set(txChunk, newChunk)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [10, 20, 30, 40]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [10, 20, 30, 40]
    * ```
    *
    * @category combinators
@@ -555,7 +571,7 @@ export const set: {
  *
  * **Example** (Appending an element)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Chunk, Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -565,8 +581,10 @@ export const set: {
  *   yield* TxChunk.append(txChunk, 4)
  *
  *   const result = yield* TxChunk.get(txChunk)
- *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3, 4]
+ *   return Chunk.toArray(result)
  * })
+ *
+ * await Effect.runPromise(program) // => [1, 2, 3, 4]
  * ```
  *
  * @category combinators
@@ -583,7 +601,7 @@ export const append: {
    *
    * **Example** (Appending an element)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -593,8 +611,10 @@ export const append: {
    *   yield* TxChunk.append(txChunk, 4)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3, 4]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [1, 2, 3, 4]
    * ```
    *
    * @category combinators
@@ -611,7 +631,7 @@ export const append: {
    *
    * **Example** (Appending an element)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -621,8 +641,10 @@ export const append: {
    *   yield* TxChunk.append(txChunk, 4)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3, 4]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [1, 2, 3, 4]
    * ```
    *
    * @category combinators
@@ -644,7 +666,7 @@ export const append: {
  *
  * **Example** (Prepending an element)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Chunk, Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -654,8 +676,10 @@ export const append: {
  *   yield* TxChunk.prepend(txChunk, 1)
  *
  *   const result = yield* TxChunk.get(txChunk)
- *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3, 4]
+ *   return Chunk.toArray(result)
  * })
+ *
+ * await Effect.runPromise(program) // => [1, 2, 3, 4]
  * ```
  *
  * @category combinators
@@ -672,7 +696,7 @@ export const prepend: {
    *
    * **Example** (Prepending an element)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -682,8 +706,10 @@ export const prepend: {
    *   yield* TxChunk.prepend(txChunk, 1)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3, 4]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [1, 2, 3, 4]
    * ```
    *
    * @category combinators
@@ -700,7 +726,7 @@ export const prepend: {
    *
    * **Example** (Prepending an element)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -710,8 +736,10 @@ export const prepend: {
    *   yield* TxChunk.prepend(txChunk, 1)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3, 4]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [1, 2, 3, 4]
    * ```
    *
    * @category combinators
@@ -728,7 +756,7 @@ export const prepend: {
  *
  * **Example** (Getting the size)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -736,13 +764,14 @@ export const prepend: {
  *
  *   // Get the current size - automatically transactional
  *   const currentSize = yield* TxChunk.size(txChunk)
- *   console.log(currentSize) // 5
  *
  *   // Size is tracked for conflict detection
  *   yield* TxChunk.append(txChunk, 6)
  *   const newSize = yield* TxChunk.size(txChunk)
- *   console.log(newSize) // 6
+ *   return [currentSize, newSize]
  * })
+ *
+ * await Effect.runPromise(program) // => [5, 6]
  * ```
  *
  * @category combinators
@@ -756,7 +785,7 @@ export const size = <A>(self: TxChunk<A>): Effect.Effect<number> =>
  *
  * **Example** (Checking for an empty chunk)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -767,12 +796,13 @@ export const size = <A>(self: TxChunk<A>): Effect.Effect<number> =>
  *   const isEmpty1 = yield* TxChunk.isEmpty(emptyChunk)
  *   const isEmpty2 = yield* TxChunk.isEmpty(nonEmptyChunk)
  *
- *   console.log(isEmpty1) // true
- *   console.log(isEmpty2) // false
+ *   return [isEmpty1, isEmpty2]
  * })
+ *
+ * await Effect.runPromise(program) // => [true, false]
  * ```
  *
- * @category combinators
+ * @category predicates
  * @since 4.0.0
  */
 export const isEmpty = <A>(self: TxChunk<A>): Effect.Effect<boolean> =>
@@ -783,7 +813,7 @@ export const isEmpty = <A>(self: TxChunk<A>): Effect.Effect<boolean> =>
  *
  * **Example** (Checking for a non-empty chunk)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -794,12 +824,13 @@ export const isEmpty = <A>(self: TxChunk<A>): Effect.Effect<boolean> =>
  *   const isNonEmpty1 = yield* TxChunk.isNonEmpty(emptyChunk)
  *   const isNonEmpty2 = yield* TxChunk.isNonEmpty(nonEmptyChunk)
  *
- *   console.log(isNonEmpty1) // false
- *   console.log(isNonEmpty2) // true
+ *   return [isNonEmpty1, isNonEmpty2]
  * })
+ *
+ * await Effect.runPromise(program) // => [false, true]
  * ```
  *
- * @category combinators
+ * @category predicates
  * @since 4.0.0
  */
 export const isNonEmpty = <A>(self: TxChunk<A>): Effect.Effect<boolean> =>
@@ -815,7 +846,7 @@ export const isNonEmpty = <A>(self: TxChunk<A>): Effect.Effect<boolean> =>
  *
  * **Example** (Taking leading elements)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Chunk, Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -825,8 +856,10 @@ export const isNonEmpty = <A>(self: TxChunk<A>): Effect.Effect<boolean> =>
  *   yield* TxChunk.take(txChunk, 3)
  *
  *   const result = yield* TxChunk.get(txChunk)
- *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3]
+ *   return Chunk.toArray(result)
  * })
+ *
+ * await Effect.runPromise(program) // => [1, 2, 3]
  * ```
  *
  * @category combinators
@@ -843,7 +876,7 @@ export const take: {
    *
    * **Example** (Taking leading elements)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -853,8 +886,10 @@ export const take: {
    *   yield* TxChunk.take(txChunk, 3)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [1, 2, 3]
    * ```
    *
    * @category combinators
@@ -871,7 +906,7 @@ export const take: {
    *
    * **Example** (Taking leading elements)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -881,8 +916,10 @@ export const take: {
    *   yield* TxChunk.take(txChunk, 3)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [1, 2, 3]
    * ```
    *
    * @category combinators
@@ -904,7 +941,7 @@ export const take: {
  *
  * **Example** (Dropping leading elements)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Chunk, Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -914,8 +951,10 @@ export const take: {
  *   yield* TxChunk.drop(txChunk, 2)
  *
  *   const result = yield* TxChunk.get(txChunk)
- *   console.log(Chunk.toReadonlyArray(result)) // [3, 4, 5]
+ *   return Chunk.toArray(result)
  * })
+ *
+ * await Effect.runPromise(program) // => [3, 4, 5]
  * ```
  *
  * @category combinators
@@ -932,7 +971,7 @@ export const drop: {
    *
    * **Example** (Dropping leading elements)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -942,8 +981,10 @@ export const drop: {
    *   yield* TxChunk.drop(txChunk, 2)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [3, 4, 5]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [3, 4, 5]
    * ```
    *
    * @category combinators
@@ -960,7 +1001,7 @@ export const drop: {
    *
    * **Example** (Dropping leading elements)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -970,8 +1011,10 @@ export const drop: {
    *   yield* TxChunk.drop(txChunk, 2)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [3, 4, 5]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [3, 4, 5]
    * ```
    *
    * @category combinators
@@ -993,7 +1036,7 @@ export const drop: {
  *
  * **Example** (Taking a slice)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Chunk, Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1003,8 +1046,10 @@ export const drop: {
  *   yield* TxChunk.slice(txChunk, 2, 5)
  *
  *   const result = yield* TxChunk.get(txChunk)
- *   console.log(Chunk.toReadonlyArray(result)) // [3, 4, 5]
+ *   return Chunk.toArray(result)
  * })
+ *
+ * await Effect.runPromise(program) // => [3, 4, 5]
  * ```
  *
  * @category combinators
@@ -1021,7 +1066,7 @@ export const slice: {
    *
    * **Example** (Taking a slice)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1031,8 +1076,10 @@ export const slice: {
    *   yield* TxChunk.slice(txChunk, 2, 5)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [3, 4, 5]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [3, 4, 5]
    * ```
    *
    * @category combinators
@@ -1049,7 +1096,7 @@ export const slice: {
    *
    * **Example** (Taking a slice)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1059,8 +1106,10 @@ export const slice: {
    *   yield* TxChunk.slice(txChunk, 2, 5)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [3, 4, 5]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [3, 4, 5]
    * ```
    *
    * @category combinators
@@ -1084,7 +1133,7 @@ export const slice: {
  *
  * **Example** (Mapping elements)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Chunk, Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1094,8 +1143,10 @@ export const slice: {
  *   yield* TxChunk.map(txChunk, (n) => n * 2)
  *
  *   const result = yield* TxChunk.get(txChunk)
- *   console.log(Chunk.toReadonlyArray(result)) // [2, 4, 6, 8]
+ *   return Chunk.toArray(result)
  * })
+ *
+ * await Effect.runPromise(program) // => [2, 4, 6, 8]
  * ```
  *
  * @category combinators
@@ -1113,7 +1164,7 @@ export const map: {
    *
    * **Example** (Mapping elements)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1123,8 +1174,10 @@ export const map: {
    *   yield* TxChunk.map(txChunk, (n) => n * 2)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [2, 4, 6, 8]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [2, 4, 6, 8]
    * ```
    *
    * @category combinators
@@ -1142,7 +1195,7 @@ export const map: {
    *
    * **Example** (Mapping elements)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1152,8 +1205,10 @@ export const map: {
    *   yield* TxChunk.map(txChunk, (n) => n * 2)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [2, 4, 6, 8]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [2, 4, 6, 8]
    * ```
    *
    * @category combinators
@@ -1175,7 +1230,7 @@ export const map: {
  *
  * **Example** (Filtering elements)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Chunk, Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1185,8 +1240,10 @@ export const map: {
  *   yield* TxChunk.filter(txChunk, (n) => n % 2 === 0)
  *
  *   const result = yield* TxChunk.get(txChunk)
- *   console.log(Chunk.toReadonlyArray(result)) // [2, 4, 6]
+ *   return Chunk.toArray(result)
  * })
+ *
+ * await Effect.runPromise(program) // => [2, 4, 6]
  * ```
  *
  * @category combinators
@@ -1203,7 +1260,7 @@ export const filter: {
    *
    * **Example** (Filtering elements)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1213,8 +1270,10 @@ export const filter: {
    *   yield* TxChunk.filter(txChunk, (n) => n % 2 === 0)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [2, 4, 6]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [2, 4, 6]
    * ```
    *
    * @category combinators
@@ -1231,7 +1290,7 @@ export const filter: {
    *
    * **Example** (Filtering elements)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1241,8 +1300,10 @@ export const filter: {
    *   yield* TxChunk.filter(txChunk, (n) => n % 2 === 0)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [2, 4, 6]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [2, 4, 6]
    * ```
    *
    * @category combinators
@@ -1259,7 +1320,7 @@ export const filter: {
    *
    * **Example** (Filtering elements)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1269,8 +1330,10 @@ export const filter: {
    *   yield* TxChunk.filter(txChunk, (n) => n % 2 === 0)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [2, 4, 6]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [2, 4, 6]
    * ```
    *
    * @category combinators
@@ -1287,7 +1350,7 @@ export const filter: {
    *
    * **Example** (Filtering elements)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1297,8 +1360,10 @@ export const filter: {
    *   yield* TxChunk.filter(txChunk, (n) => n % 2 === 0)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [2, 4, 6]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [2, 4, 6]
    * ```
    *
    * @category combinators
@@ -1321,7 +1386,7 @@ export const filter: {
  *
  * **Example** (Appending another chunk)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Chunk, Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1332,8 +1397,10 @@ export const filter: {
  *   yield* TxChunk.appendAll(txChunk, otherChunk)
  *
  *   const result = yield* TxChunk.get(txChunk)
- *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3, 4, 5, 6]
+ *   return Chunk.toArray(result)
  * })
+ *
+ * await Effect.runPromise(program) // => [1, 2, 3, 4, 5, 6]
  * ```
  *
  * @category combinators
@@ -1350,7 +1417,7 @@ export const appendAll: {
    *
    * **Example** (Appending another chunk)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1361,8 +1428,10 @@ export const appendAll: {
    *   yield* TxChunk.appendAll(txChunk, otherChunk)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3, 4, 5, 6]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [1, 2, 3, 4, 5, 6]
    * ```
    *
    * @category combinators
@@ -1379,7 +1448,7 @@ export const appendAll: {
    *
    * **Example** (Appending another chunk)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1390,8 +1459,10 @@ export const appendAll: {
    *   yield* TxChunk.appendAll(txChunk, otherChunk)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3, 4, 5, 6]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [1, 2, 3, 4, 5, 6]
    * ```
    *
    * @category combinators
@@ -1414,7 +1485,7 @@ export const appendAll: {
  *
  * **Example** (Prepending another chunk)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Chunk, Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1425,8 +1496,10 @@ export const appendAll: {
  *   yield* TxChunk.prependAll(txChunk, otherChunk)
  *
  *   const result = yield* TxChunk.get(txChunk)
- *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3, 4, 5, 6]
+ *   return Chunk.toArray(result)
  * })
+ *
+ * await Effect.runPromise(program) // => [1, 2, 3, 4, 5, 6]
  * ```
  *
  * @category combinators
@@ -1443,7 +1516,7 @@ export const prependAll: {
    *
    * **Example** (Prepending another chunk)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1454,8 +1527,10 @@ export const prependAll: {
    *   yield* TxChunk.prependAll(txChunk, otherChunk)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3, 4, 5, 6]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [1, 2, 3, 4, 5, 6]
    * ```
    *
    * @category combinators
@@ -1472,7 +1547,7 @@ export const prependAll: {
    *
    * **Example** (Prepending another chunk)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1483,8 +1558,10 @@ export const prependAll: {
    *   yield* TxChunk.prependAll(txChunk, otherChunk)
    *
    *   const result = yield* TxChunk.get(txChunk)
-   *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3, 4, 5, 6]
+   *   return Chunk.toArray(result)
    * })
+   *
+   * await Effect.runPromise(program) // => [1, 2, 3, 4, 5, 6]
    * ```
    *
    * @category combinators
@@ -1507,7 +1584,7 @@ export const prependAll: {
  *
  * **Example** (Concatenating TxChunks)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Chunk, Effect, TxChunk } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1518,12 +1595,13 @@ export const prependAll: {
  *   yield* TxChunk.concat(txChunk1, txChunk2)
  *
  *   const result = yield* TxChunk.get(txChunk1)
- *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3, 4, 5, 6]
  *
  *   // Original txChunk2 is unchanged
  *   const original = yield* TxChunk.get(txChunk2)
- *   console.log(Chunk.toReadonlyArray(original)) // [4, 5, 6]
+ *   return [Chunk.toArray(result), Chunk.toArray(original)]
  * })
+ *
+ * await Effect.runPromise(program) // => [[1, 2, 3, 4, 5, 6], [4, 5, 6]]
  * ```
  *
  * @category combinators
@@ -1540,7 +1618,7 @@ export const concat: {
    *
    * **Example** (Concatenating TxChunks)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1551,12 +1629,13 @@ export const concat: {
    *   yield* TxChunk.concat(txChunk1, txChunk2)
    *
    *   const result = yield* TxChunk.get(txChunk1)
-   *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3, 4, 5, 6]
    *
    *   // Original txChunk2 is unchanged
    *   const original = yield* TxChunk.get(txChunk2)
-   *   console.log(Chunk.toReadonlyArray(original)) // [4, 5, 6]
+   *   return [Chunk.toArray(result), Chunk.toArray(original)]
    * })
+   *
+   * await Effect.runPromise(program) // => [[1, 2, 3, 4, 5, 6], [4, 5, 6]]
    * ```
    *
    * @category combinators
@@ -1573,7 +1652,7 @@ export const concat: {
    *
    * **Example** (Concatenating TxChunks)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Chunk, Effect, TxChunk } from "effect"
    *
    * const program = Effect.gen(function*() {
@@ -1584,12 +1663,13 @@ export const concat: {
    *   yield* TxChunk.concat(txChunk1, txChunk2)
    *
    *   const result = yield* TxChunk.get(txChunk1)
-   *   console.log(Chunk.toReadonlyArray(result)) // [1, 2, 3, 4, 5, 6]
    *
    *   // Original txChunk2 is unchanged
    *   const original = yield* TxChunk.get(txChunk2)
-   *   console.log(Chunk.toReadonlyArray(original)) // [4, 5, 6]
+   *   return [Chunk.toArray(result), Chunk.toArray(original)]
    * })
+   *
+   * await Effect.runPromise(program) // => [[1, 2, 3, 4, 5, 6], [4, 5, 6]]
    * ```
    *
    * @category combinators