effect 4.0.0-beta.99 → 4.0.0-rc.109

package/dist/FiberMap.d.ts

@@ -14,7 +14,7 @@ declare const TypeId = "~effect/FiberMap";
  *
  * **Example** (Managing fibers in a map)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, FiberMap } from "effect"
  *
  * // Create a FiberMap with string keys
@@ -26,9 +26,11 @@ declare const TypeId = "~effect/FiberMap";
  *   yield* FiberMap.run(map, "task2", Effect.never)
  *
  *   // Get the size of the map
- *   const size = yield* FiberMap.size(map)
- *   console.log(size) // 2
+ *   return yield* FiberMap.size(map)
  * })
+ *
+ * const actual = await Effect.runPromise(Effect.scoped(program))
+ * actual // => 2
  * ```
  *
  * @category models
@@ -53,19 +55,20 @@ export interface FiberMap<in out K, out A = unknown, out E = unknown> extends Pi
  *
  * **Example** (Checking if a value is a FiberMap)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, FiberMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const map = yield* FiberMap.make<string>()
  *
- *   console.log(FiberMap.isFiberMap(map)) // true
- *   console.log(FiberMap.isFiberMap({})) // false
- *   console.log(FiberMap.isFiberMap(null)) // false
+ *   return [FiberMap.isFiberMap(map), FiberMap.isFiberMap({}), FiberMap.isFiberMap(null)]
  * })
+ *
+ * const actual = await Effect.runPromise(Effect.scoped(program))
+ * actual // => [true, false, false]
  * ```
  *
- * @category refinements
+ * @category guards
  * @since 2.0.0
  */
 export declare const isFiberMap: (u: unknown) => u is FiberMap<unknown>;
@@ -81,20 +84,24 @@ export declare const isFiberMap: (u: unknown) => u is FiberMap<unknown>;
  *
  * **Example** (Creating a scoped FiberMap)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, FiberMap } from "effect"
  *
- * Effect.gen(function*() {
+ * const program = Effect.gen(function*() {
  *   const map = yield* FiberMap.make<string>()
  *
  *   // run some effects and add the fibers to the map
  *   yield* FiberMap.run(map, "fiber a", Effect.never)
  *   yield* FiberMap.run(map, "fiber b", Effect.never)
  *
- *   yield* Effect.sleep(1000)
+ *   yield* Effect.yieldNow
+ *   return yield* FiberMap.size(map)
  * }).pipe(
  *   Effect.scoped // The fibers will be interrupted when the scope is closed
  * )
+ *
+ * const actual = await Effect.runPromise(program)
+ * actual // => 2
  * ```
  *
  * @category constructors
@@ -113,7 +120,7 @@ export declare const make: <K, A = unknown, E = unknown>() => Effect.Effect<Fibe
  *
  * **Example** (Creating a scoped runtime)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Fiber, FiberMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -124,11 +131,11 @@ export declare const make: <K, A = unknown, E = unknown>() => Effect.Effect<Fibe
  *   const fiber2 = run("task2", Effect.succeed("World"))
  *
  *   // Join the fibers to get their successful values
- *   const result1 = yield* Fiber.join(fiber1)
- *   const result2 = yield* Fiber.join(fiber2)
- *
- *   console.log(result1, result2) // "Hello", "World"
+ *   return [yield* Fiber.join(fiber1), yield* Fiber.join(fiber2)]
  * })
+ *
+ * const actual = await Effect.runPromise(Effect.scoped(program))
+ * actual // => ["Hello", "World"]
  * ```
  *
  * @category constructors
@@ -155,7 +162,7 @@ export declare const makeRuntime: <R, K, E = unknown, A = unknown>() => Effect.E
  *
  * **Example** (Creating a promise runtime)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, FiberMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -166,11 +173,11 @@ export declare const makeRuntime: <R, K, E = unknown, A = unknown>() => Effect.E
  *   const promise2 = run("task2", Effect.succeed("World"))
  *
  *   // Convert to Effect and await
- *   const result1 = yield* Effect.promise(() => promise1)
- *   const result2 = yield* Effect.promise(() => promise2)
- *
- *   console.log(result1, result2) // "Hello", "World"
+ *   return [yield* Effect.promise(() => promise1), yield* Effect.promise(() => promise2)]
  * })
+ *
+ * const actual = await Effect.runPromise(Effect.scoped(program))
+ * actual // => ["Hello", "World"]
  * ```
  *
  * @category constructors
@@ -196,7 +203,7 @@ export declare const makeRuntimePromise: <R, K, A = unknown, E = unknown>() => E
  *
  * **Example** (Adding a fiber unsafely)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Deferred, Effect, Fiber, FiberMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -210,9 +217,11 @@ export declare const makeRuntimePromise: <R, K, A = unknown, E = unknown>() => E
  *   yield* Deferred.succeed(deferred, "Hello")
  *
  *   // Join the fiber to get its successful value
- *   const result = yield* Fiber.join(fiber)
- *   console.log(result) // "Hello"
+ *   return yield* Fiber.join(fiber)
  * })
+ *
+ * const actual = await Effect.runPromise(Effect.scoped(program))
+ * actual // => "Hello"
  * ```
  *
  * @category combinators
@@ -236,7 +245,7 @@ export declare const setUnsafe: {
      *
      * **Example** (Adding a fiber unsafely)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Deferred, Effect, Fiber, FiberMap } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -250,9 +259,11 @@ export declare const setUnsafe: {
      *   yield* Deferred.succeed(deferred, "Hello")
      *
      *   // Join the fiber to get its successful value
-     *   const result = yield* Fiber.join(fiber)
-     *   console.log(result) // "Hello"
+     *   return yield* Fiber.join(fiber)
      * })
+     *
+     * const actual = await Effect.runPromise(Effect.scoped(program))
+     * actual // => "Hello"
      * ```
      *
      * @category combinators
@@ -279,7 +290,7 @@ export declare const setUnsafe: {
      *
      * **Example** (Adding a fiber unsafely)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Deferred, Effect, Fiber, FiberMap } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -293,9 +304,11 @@ export declare const setUnsafe: {
      *   yield* Deferred.succeed(deferred, "Hello")
      *
      *   // Join the fiber to get its successful value
-     *   const result = yield* Fiber.join(fiber)
-     *   console.log(result) // "Hello"
+     *   return yield* Fiber.join(fiber)
      * })
+     *
+     * const actual = await Effect.runPromise(Effect.scoped(program))
+     * actual // => "Hello"
      * ```
      *
      * @category combinators
@@ -319,7 +332,7 @@ export declare const setUnsafe: {
  *
  * **Example** (Adding a fiber)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Deferred, Effect, Fiber, FiberMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -333,9 +346,11 @@ export declare const setUnsafe: {
  *   yield* Deferred.succeed(deferred, "Hello")
  *
  *   // Join the fiber to get its successful value
- *   const result = yield* Fiber.join(fiber)
- *   console.log(result) // "Hello"
+ *   return yield* Fiber.join(fiber)
  * })
+ *
+ * const actual = await Effect.runPromise(Effect.scoped(program))
+ * actual // => "Hello"
  * ```
  *
  * @category combinators
@@ -355,7 +370,7 @@ export declare const set: {
      *
      * **Example** (Adding a fiber)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Deferred, Effect, Fiber, FiberMap } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -369,9 +384,11 @@ export declare const set: {
      *   yield* Deferred.succeed(deferred, "Hello")
      *
      *   // Join the fiber to get its successful value
-     *   const result = yield* Fiber.join(fiber)
-     *   console.log(result) // "Hello"
+     *   return yield* Fiber.join(fiber)
      * })
+     *
+     * const actual = await Effect.runPromise(Effect.scoped(program))
+     * actual // => "Hello"
      * ```
      *
      * @category combinators
@@ -394,7 +411,7 @@ export declare const set: {
      *
      * **Example** (Adding a fiber)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Deferred, Effect, Fiber, FiberMap } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -408,9 +425,11 @@ export declare const set: {
      *   yield* Deferred.succeed(deferred, "Hello")
      *
      *   // Join the fiber to get its successful value
-     *   const result = yield* Fiber.join(fiber)
-     *   console.log(result) // "Hello"
+     *   return yield* Fiber.join(fiber)
      * })
+     *
+     * const actual = await Effect.runPromise(Effect.scoped(program))
+     * actual // => "Hello"
      * ```
      *
      * @category combinators
@@ -431,8 +450,8 @@ export declare const set: {
  *
  * **Example** (Retrieving a fiber unsafely)
  *
- * ```ts
- * import { Deferred, Effect, Fiber, FiberMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Deferred, Effect, Fiber, FiberMap, Option } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const map = yield* FiberMap.make<string>()
@@ -444,13 +463,13 @@ export declare const set: {
  *
  *   // Retrieve the fiber
  *   const retrieved = FiberMap.getUnsafe(map, "greeting")
- *   if (retrieved._tag === "Some") {
- *     yield* Deferred.succeed(deferred, "Hello")
- *
- *     const result = yield* Fiber.join(retrieved.value)
- *     console.log(result) // "Hello"
- *   }
+ *   yield* Deferred.succeed(deferred, "Hello")
+ *   const result = yield* Fiber.join(fiber)
+ *   return Option.map(retrieved, () => result)
  * })
+ *
+ * const actual = await Effect.runPromise(Effect.scoped(program))
+ * actual // => Option.some("Hello")
  * ```
  *
  * @category combinators
@@ -467,8 +486,8 @@ export declare const getUnsafe: {
      *
      * **Example** (Retrieving a fiber unsafely)
      *
-     * ```ts
-     * import { Deferred, Effect, Fiber, FiberMap } from "effect"
+     * ```ts import.meta.vitest
+     * import { Deferred, Effect, Fiber, FiberMap, Option } from "effect"
      *
      * const program = Effect.gen(function*() {
      *   const map = yield* FiberMap.make<string>()
@@ -480,13 +499,13 @@ export declare const getUnsafe: {
      *
      *   // Retrieve the fiber
      *   const retrieved = FiberMap.getUnsafe(map, "greeting")
-     *   if (retrieved._tag === "Some") {
-     *     yield* Deferred.succeed(deferred, "Hello")
-     *
-     *     const result = yield* Fiber.join(retrieved.value)
-     *     console.log(result) // "Hello"
-     *   }
+     *   yield* Deferred.succeed(deferred, "Hello")
+     *   const result = yield* Fiber.join(fiber)
+     *   return Option.map(retrieved, () => result)
      * })
+     *
+     * const actual = await Effect.runPromise(Effect.scoped(program))
+     * actual // => Option.some("Hello")
      * ```
      *
      * @category combinators
@@ -503,8 +522,8 @@ export declare const getUnsafe: {
      *
      * **Example** (Retrieving a fiber unsafely)
      *
-     * ```ts
-     * import { Deferred, Effect, Fiber, FiberMap } from "effect"
+     * ```ts import.meta.vitest
+     * import { Deferred, Effect, Fiber, FiberMap, Option } from "effect"
      *
      * const program = Effect.gen(function*() {
      *   const map = yield* FiberMap.make<string>()
@@ -516,13 +535,13 @@ export declare const getUnsafe: {
      *
      *   // Retrieve the fiber
      *   const retrieved = FiberMap.getUnsafe(map, "greeting")
-     *   if (retrieved._tag === "Some") {
-     *     yield* Deferred.succeed(deferred, "Hello")
-     *
-     *     const result = yield* Fiber.join(retrieved.value)
-     *     console.log(result) // "Hello"
-     *   }
+     *   yield* Deferred.succeed(deferred, "Hello")
+     *   const result = yield* Fiber.join(fiber)
+     *   return Option.map(retrieved, () => result)
      * })
+     *
+     * const actual = await Effect.runPromise(Effect.scoped(program))
+     * actual // => Option.some("Hello")
      * ```
      *
      * @category combinators
@@ -539,8 +558,8 @@ export declare const getUnsafe: {
  *
  * **Example** (Retrieving a fiber)
  *
- * ```ts
- * import { Deferred, Effect, Fiber, FiberMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Deferred, Effect, Fiber, FiberMap, Option } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const map = yield* FiberMap.make<string>()
@@ -552,13 +571,13 @@ export declare const getUnsafe: {
  *
  *   // Retrieve the fiber with error handling
  *   const retrieved = yield* FiberMap.get(map, "greeting")
- *   if (retrieved._tag === "Some") {
- *     yield* Deferred.succeed(deferred, "Hello")
- *
- *     const result = yield* Fiber.join(retrieved.value)
- *     console.log(result) // "Hello"
- *   }
+ *   yield* Deferred.succeed(deferred, "Hello")
+ *   const result = yield* Fiber.join(fiber)
+ *   return Option.map(retrieved, () => result)
  * })
+ *
+ * const actual = await Effect.runPromise(Effect.scoped(program))
+ * actual // => Option.some("Hello")
  * ```
  *
  * @category combinators
@@ -574,8 +593,8 @@ export declare const get: {
      *
      * **Example** (Retrieving a fiber)
      *
-     * ```ts
-     * import { Deferred, Effect, Fiber, FiberMap } from "effect"
+     * ```ts import.meta.vitest
+     * import { Deferred, Effect, Fiber, FiberMap, Option } from "effect"
      *
      * const program = Effect.gen(function*() {
      *   const map = yield* FiberMap.make<string>()
@@ -587,13 +606,13 @@ export declare const get: {
      *
      *   // Retrieve the fiber with error handling
      *   const retrieved = yield* FiberMap.get(map, "greeting")
-     *   if (retrieved._tag === "Some") {
-     *     yield* Deferred.succeed(deferred, "Hello")
-     *
-     *     const result = yield* Fiber.join(retrieved.value)
-     *     console.log(result) // "Hello"
-     *   }
+     *   yield* Deferred.succeed(deferred, "Hello")
+     *   const result = yield* Fiber.join(fiber)
+     *   return Option.map(retrieved, () => result)
      * })
+     *
+     * const actual = await Effect.runPromise(Effect.scoped(program))
+     * actual // => Option.some("Hello")
      * ```
      *
      * @category combinators
@@ -609,8 +628,8 @@ export declare const get: {
      *
      * **Example** (Retrieving a fiber)
      *
-     * ```ts
-     * import { Deferred, Effect, Fiber, FiberMap } from "effect"
+     * ```ts import.meta.vitest
+     * import { Deferred, Effect, Fiber, FiberMap, Option } from "effect"
      *
      * const program = Effect.gen(function*() {
      *   const map = yield* FiberMap.make<string>()
@@ -622,13 +641,13 @@ export declare const get: {
      *
      *   // Retrieve the fiber with error handling
      *   const retrieved = yield* FiberMap.get(map, "greeting")
-     *   if (retrieved._tag === "Some") {
-     *     yield* Deferred.succeed(deferred, "Hello")
-     *
-     *     const result = yield* Fiber.join(retrieved.value)
-     *     console.log(result) // "Hello"
-     *   }
+     *   yield* Deferred.succeed(deferred, "Hello")
+     *   const result = yield* Fiber.join(fiber)
+     *   return Option.map(retrieved, () => result)
      * })
+     *
+     * const actual = await Effect.runPromise(Effect.scoped(program))
+     * actual // => Option.some("Hello")
      * ```
      *
      * @category combinators
@@ -641,7 +660,7 @@ export declare const get: {
  *
  * **Example** (Checking if a key exists unsafely)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, FiberMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -651,9 +670,11 @@ export declare const get: {
  *   yield* FiberMap.run(map, "task1", Effect.never)
  *
  *   // Check if keys exist
- *   console.log(FiberMap.hasUnsafe(map, "task1")) // true
- *   console.log(FiberMap.hasUnsafe(map, "task2")) // false
+ *   return [FiberMap.hasUnsafe(map, "task1"), FiberMap.hasUnsafe(map, "task2")]
  * })
+ *
+ * const actual = await Effect.runPromise(Effect.scoped(program))
+ * actual // => [true, false]
  * ```
  *
  * @category combinators
@@ -665,7 +686,7 @@ export declare const hasUnsafe: {
      *
      * **Example** (Checking if a key exists unsafely)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, FiberMap } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -675,9 +696,11 @@ export declare const hasUnsafe: {
      *   yield* FiberMap.run(map, "task1", Effect.never)
      *
      *   // Check if keys exist
-     *   console.log(FiberMap.hasUnsafe(map, "task1")) // true
-     *   console.log(FiberMap.hasUnsafe(map, "task2")) // false
+     *   return [FiberMap.hasUnsafe(map, "task1"), FiberMap.hasUnsafe(map, "task2")]
      * })
+     *
+     * const actual = await Effect.runPromise(Effect.scoped(program))
+     * actual // => [true, false]
      * ```
      *
      * @category combinators
@@ -689,7 +712,7 @@ export declare const hasUnsafe: {
      *
      * **Example** (Checking if a key exists unsafely)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, FiberMap } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -699,9 +722,11 @@ export declare const hasUnsafe: {
      *   yield* FiberMap.run(map, "task1", Effect.never)
      *
      *   // Check if keys exist
-     *   console.log(FiberMap.hasUnsafe(map, "task1")) // true
-     *   console.log(FiberMap.hasUnsafe(map, "task2")) // false
+     *   return [FiberMap.hasUnsafe(map, "task1"), FiberMap.hasUnsafe(map, "task2")]
      * })
+     *
+     * const actual = await Effect.runPromise(Effect.scoped(program))
+     * actual // => [true, false]
      * ```
      *
      * @category combinators
@@ -715,7 +740,7 @@ export declare const hasUnsafe: {
  *
  * **Example** (Checking if a key exists)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, FiberMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -725,12 +750,11 @@ export declare const hasUnsafe: {
  *   yield* FiberMap.run(map, "task1", Effect.never)
  *
  *   // Check if keys exist using Effect
- *   const exists1 = yield* FiberMap.has(map, "task1")
- *   const exists2 = yield* FiberMap.has(map, "task2")
- *
- *   console.log(exists1) // true
- *   console.log(exists2) // false
+ *   return [yield* FiberMap.has(map, "task1"), yield* FiberMap.has(map, "task2")]
  * })
+ *
+ * const actual = await Effect.runPromise(Effect.scoped(program))
+ * actual // => [true, false]
  * ```
  *
  * @category combinators
@@ -743,7 +767,7 @@ export declare const has: {
      *
      * **Example** (Checking if a key exists)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, FiberMap } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -753,12 +777,11 @@ export declare const has: {
      *   yield* FiberMap.run(map, "task1", Effect.never)
      *
      *   // Check if keys exist using Effect
-     *   const exists1 = yield* FiberMap.has(map, "task1")
-     *   const exists2 = yield* FiberMap.has(map, "task2")
-     *
-     *   console.log(exists1) // true
-     *   console.log(exists2) // false
+     *   return [yield* FiberMap.has(map, "task1"), yield* FiberMap.has(map, "task2")]
      * })
+     *
+     * const actual = await Effect.runPromise(Effect.scoped(program))
+     * actual // => [true, false]
      * ```
      *
      * @category combinators
@@ -771,7 +794,7 @@ export declare const has: {
      *
      * **Example** (Checking if a key exists)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, FiberMap } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -781,12 +804,11 @@ export declare const has: {
      *   yield* FiberMap.run(map, "task1", Effect.never)
      *
      *   // Check if keys exist using Effect
-     *   const exists1 = yield* FiberMap.has(map, "task1")
-     *   const exists2 = yield* FiberMap.has(map, "task2")
-     *
-     *   console.log(exists1) // true
-     *   console.log(exists2) // false
+     *   return [yield* FiberMap.has(map, "task1"), yield* FiberMap.has(map, "task2")]
      * })
+     *
+     * const actual = await Effect.runPromise(Effect.scoped(program))
+     * actual // => [true, false]
      * ```
      *
      * @category combinators
@@ -799,7 +821,7 @@ export declare const has: {
  *
  * **Example** (Removing a fiber)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, FiberMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -809,13 +831,16 @@ export declare const has: {
  *   yield* FiberMap.run(map, "task1", Effect.never)
  *   yield* FiberMap.run(map, "task2", Effect.never)
  *
- *   console.log(yield* FiberMap.size(map)) // 2
+ *   const sizeBefore = yield* FiberMap.size(map)
  *
  *   // Remove a specific fiber (this will interrupt it)
  *   yield* FiberMap.remove(map, "task1")
  *
- *   console.log(yield* FiberMap.size(map)) // 1
+ *   return [sizeBefore, yield* FiberMap.size(map)]
  * })
+ *
+ * const actual = await Effect.runPromise(Effect.scoped(program))
+ * actual // => [2, 1]
  * ```
  *
  * @category combinators
@@ -827,7 +852,7 @@ export declare const remove: {
      *
      * **Example** (Removing a fiber)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, FiberMap } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -837,13 +862,16 @@ export declare const remove: {
      *   yield* FiberMap.run(map, "task1", Effect.never)
      *   yield* FiberMap.run(map, "task2", Effect.never)
      *
-     *   console.log(yield* FiberMap.size(map)) // 2
+     *   const sizeBefore = yield* FiberMap.size(map)
      *
      *   // Remove a specific fiber (this will interrupt it)
      *   yield* FiberMap.remove(map, "task1")
      *
-     *   console.log(yield* FiberMap.size(map)) // 1
+     *   return [sizeBefore, yield* FiberMap.size(map)]
      * })
+     *
+     * const actual = await Effect.runPromise(Effect.scoped(program))
+     * actual // => [2, 1]
      * ```
      *
      * @category combinators
@@ -855,7 +883,7 @@ export declare const remove: {
      *
      * **Example** (Removing a fiber)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, FiberMap } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -865,13 +893,16 @@ export declare const remove: {
      *   yield* FiberMap.run(map, "task1", Effect.never)
      *   yield* FiberMap.run(map, "task2", Effect.never)
      *
-     *   console.log(yield* FiberMap.size(map)) // 2
+     *   const sizeBefore = yield* FiberMap.size(map)
      *
      *   // Remove a specific fiber (this will interrupt it)
      *   yield* FiberMap.remove(map, "task1")
      *
-     *   console.log(yield* FiberMap.size(map)) // 1
+     *   return [sizeBefore, yield* FiberMap.size(map)]
      * })
+     *
+     * const actual = await Effect.runPromise(Effect.scoped(program))
+     * actual // => [2, 1]
      * ```
      *
      * @category combinators
@@ -884,7 +915,7 @@ export declare const remove: {
  *
  * **Example** (Clearing all fibers)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, FiberMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -895,13 +926,16 @@ export declare const remove: {
  *   yield* FiberMap.run(map, "task2", Effect.never)
  *   yield* FiberMap.run(map, "task3", Effect.never)
  *
- *   console.log(yield* FiberMap.size(map)) // 3
+ *   const sizeBefore = yield* FiberMap.size(map)
  *
  *   // Clear all fibers (this will interrupt all of them)
  *   yield* FiberMap.clear(map)
  *
- *   console.log(yield* FiberMap.size(map)) // 0
+ *   return [sizeBefore, yield* FiberMap.size(map)]
  * })
+ *
+ * const actual = await Effect.runPromise(Effect.scoped(program))
+ * actual // => [3, 0]
  * ```
  *
  * @category combinators
@@ -918,7 +952,7 @@ export declare const clear: <K, A, E>(self: FiberMap<K, A, E>) => Effect.Effect<
  *
  * **Example** (Forking effects into a map)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Fiber, FiberMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -931,10 +965,11 @@ export declare const clear: <K, A, E>(self: FiberMap<K, A, E>) => Effect.Effect<
  *   // Join the fibers to get their successful values
  *   const result1 = yield* Fiber.join(fiber1)
  *   const result2 = yield* Fiber.join(fiber2)
- *
- *   console.log(result1, result2) // "Hello", "World"
- *   console.log(yield* FiberMap.size(map)) // 0 (fibers are removed after completion)
+ *   return [result1, result2, yield* FiberMap.size(map)]
  * })
+ *
+ * const actual = await Effect.runPromise(Effect.scoped(program))
+ * actual // => ["Hello", "World", 0]
  * ```
  *
  * @category combinators
@@ -951,7 +986,7 @@ export declare const run: {
      *
      * **Example** (Forking effects into a map)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, Fiber, FiberMap } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -964,10 +999,11 @@ export declare const run: {
      *   // Join the fibers to get their successful values
      *   const result1 = yield* Fiber.join(fiber1)
      *   const result2 = yield* Fiber.join(fiber2)
-     *
-     *   console.log(result1, result2) // "Hello", "World"
-     *   console.log(yield* FiberMap.size(map)) // 0 (fibers are removed after completion)
+     *   return [result1, result2, yield* FiberMap.size(map)]
      * })
+     *
+     * const actual = await Effect.runPromise(Effect.scoped(program))
+     * actual // => ["Hello", "World", 0]
      * ```
      *
      * @category combinators
@@ -988,7 +1024,7 @@ export declare const run: {
      *
      * **Example** (Forking effects into a map)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { Effect, Fiber, FiberMap } from "effect"
      *
      * const program = Effect.gen(function*() {
@@ -1001,10 +1037,11 @@ export declare const run: {
      *   // Join the fibers to get their successful values
      *   const result1 = yield* Fiber.join(fiber1)
      *   const result2 = yield* Fiber.join(fiber2)
-     *
-     *   console.log(result1, result2) // "Hello", "World"
-     *   console.log(yield* FiberMap.size(map)) // 0 (fibers are removed after completion)
+     *   return [result1, result2, yield* FiberMap.size(map)]
      * })
+     *
+     * const actual = await Effect.runPromise(Effect.scoped(program))
+     * actual // => ["Hello", "World", 0]
      * ```
      *
      * @category combinators
@@ -1027,26 +1064,29 @@ export declare const run: {
  *
  * **Example** (Capturing a runtime)
  *
- * ```ts
- * import { Context, Effect, FiberMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Context, Effect, Fiber, FiberMap } from "effect"
  *
- * interface Users {
- *   readonly _: unique symbol
- * }
- * const Users = Context.Service<Users, {
- *   getAll: Effect.Effect<Array<unknown>>
- * }>("Users")
+ * class Users extends Context.Service<Users, {
+ *   readonly getAll: Effect.Effect<Array<unknown>>
+ * }>()("Users") {}
  *
- * Effect.gen(function*() {
+ * const program = Effect.gen(function*() {
  *   const map = yield* FiberMap.make<string>()
  *   const run = yield* FiberMap.runtime(map)<Users>()
  *
  *   // run some effects and add the fibers to the map
- *   run("effect-a", Effect.andThen(Users, (_) => _.getAll))
- *   run("effect-b", Effect.andThen(Users, (_) => _.getAll))
+ *   const fiberA = run("effect-a", Effect.andThen(Users, (_) => _.getAll))
+ *   const fiberB = run("effect-b", Effect.andThen(Users, (_) => _.getAll))
+ *   return [(yield* Fiber.join(fiberA)).length, (yield* Fiber.join(fiberB)).length]
  * }).pipe(
  *   Effect.scoped // The fibers will be interrupted when the scope is closed
  * )
+ *
+ * const actual = await Effect.runPromise(Effect.provideService(program, Users, {
+ *   getAll: Effect.succeed([])
+ * }))
+ * actual // => [0, 0]
  * ```
  *
  * @category combinators
@@ -1069,7 +1109,7 @@ export declare const runtime: <K, A, E>(self: FiberMap<K, A, E>) => <R = never>(
  *
  * **Example** (Running effects as promises)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, FiberMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1081,11 +1121,11 @@ export declare const runtime: <K, A, E>(self: FiberMap<K, A, E>) => <R = never>(
  *   const promise2 = runPromise("task2", Effect.succeed("World"))
  *
  *   // Convert promises back to Effects and await
- *   const result1 = yield* Effect.promise(() => promise1)
- *   const result2 = yield* Effect.promise(() => promise2)
- *
- *   console.log(result1, result2) // "Hello", "World"
+ *   return [yield* Effect.promise(() => promise1), yield* Effect.promise(() => promise2)]
  * })
+ *
+ * const actual = await Effect.runPromise(Effect.scoped(program))
+ * actual // => ["Hello", "World"]
  * ```
  *
  * @category combinators
@@ -1100,20 +1140,23 @@ export declare const runtimePromise: <K, A, E>(self: FiberMap<K, A, E>) => <R =
  *
  * **Example** (Checking the map size)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, FiberMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const map = yield* FiberMap.make<string>()
  *
- *   console.log(yield* FiberMap.size(map)) // 0
+ *   const sizeBefore = yield* FiberMap.size(map)
  *
  *   // Add some fibers
  *   yield* FiberMap.run(map, "task1", Effect.never)
  *   yield* FiberMap.run(map, "task2", Effect.never)
  *
- *   console.log(yield* FiberMap.size(map)) // 2
+ *   return [sizeBefore, yield* FiberMap.size(map)]
  * })
+ *
+ * const actual = await Effect.runPromise(Effect.scoped(program))
+ * actual // => [0, 2]
  * ```
  *
  * @category combinators
@@ -1132,16 +1175,19 @@ export declare const size: <K, A, E>(self: FiberMap<K, A, E>) => Effect.Effect<n
  *
  * **Example** (Joining failing fibers)
  *
- * ```ts
- * import { Effect, FiberMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, Exit, FiberMap } from "effect"
  *
- * Effect.gen(function*() {
+ * const program = Effect.gen(function*() {
  *   const map = yield* FiberMap.make()
  *   yield* FiberMap.set(map, "a", Effect.runFork(Effect.fail("error")))
  *
  *   // parent fiber will fail with "error"
  *   yield* FiberMap.join(map)
  * })
+ *
+ * const actual = await Effect.runPromise(Effect.exit(Effect.scoped(program)))
+ * actual // => Exit.fail("error")
  * ```
  *
  * @category combinators
@@ -1154,24 +1200,23 @@ export declare const join: <K, A, E>(self: FiberMap<K, A, E>) => Effect.Effect<v
  *
  * **Example** (Waiting for an empty map)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, FiberMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const map = yield* FiberMap.make<string>()
  *
- *   // Add some fibers that will complete after a delay
- *   yield* FiberMap.run(map, "task1", Effect.sleep(1000))
- *   yield* FiberMap.run(map, "task2", Effect.sleep(2000))
- *
- *   console.log("Waiting for all fibers to complete...")
+ *   yield* FiberMap.run(map, "task1", Effect.yieldNow)
+ *   yield* FiberMap.run(map, "task2", Effect.yieldNow)
  *
  *   // Wait for the map to be empty
  *   yield* FiberMap.awaitEmpty(map)
  *
- *   console.log("All fibers completed!")
- *   console.log(yield* FiberMap.size(map)) // 0
+ *   return yield* FiberMap.size(map)
  * })
+ *
+ * const actual = await Effect.runPromise(Effect.scoped(program))
+ * actual // => 0
  * ```
  *
  * @category combinators