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

package/dist/TxHashMap.js

@@ -42,7 +42,7 @@ const TxHashMapProto = {
  *
  * **Example** (Creating an empty map)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -50,17 +50,15 @@ const TxHashMapProto = {
  *   const emptyMap = yield* TxHashMap.empty<string, number>()
  *
  *   // Verify it's empty
- *   const isEmpty = yield* TxHashMap.isEmpty(emptyMap)
- *   console.log(isEmpty) // true
- *
- *   const size = yield* TxHashMap.size(emptyMap)
- *   console.log(size) // 0
+ *   yield* TxHashMap.isEmpty(emptyMap) // => true
+ *   yield* TxHashMap.size(emptyMap) // => 0
  *
  *   // Start adding elements
  *   yield* TxHashMap.set(emptyMap, "first", 1)
- *   const newSize = yield* TxHashMap.size(emptyMap)
- *   console.log(newSize) // 1
+ *   return yield* TxHashMap.size(emptyMap)
  * })
+ *
+ * await Effect.runPromise(program) // => 1
  * ```
  *
  * @category constructors
@@ -77,8 +75,8 @@ export const empty = () => Effect.gen(function* () {
  *
  * **Example** (Creating a map from entries)
  *
- * ```ts
- * import { Effect, TxHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, Option, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   // Create a user directory
@@ -89,16 +87,14 @@ export const empty = () => Effect.gen(function* () {
  *   )
  *
  *   // Check the initial size
- *   const size = yield* TxHashMap.size(userMap)
- *   console.log(size) // 3
+ *   yield* TxHashMap.size(userMap) // => 3
  *
  *   // Access users
- *   const alice = yield* TxHashMap.get(userMap, "alice")
- *   console.log(alice) // Option.some({ name: "Alice Smith", role: "admin" })
- *
- *   const nonExistent = yield* TxHashMap.get(userMap, "david")
- *   console.log(nonExistent) // Option.none()
+ *   yield* TxHashMap.get(userMap, "alice") // => Option.some({ name: "Alice Smith", role: "admin" })
+ *   return yield* TxHashMap.get(userMap, "david")
  * })
+ *
+ * await Effect.runPromise(program) // => Option.none()
  * ```
  *
  * @category constructors
@@ -116,8 +112,8 @@ export const make = (...entries) => Effect.gen(function* () {
  *
  * **Example** (Creating a map from an iterable)
  *
- * ```ts
- * import { Effect, TxHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, Option, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   // Create from various iterable sources
@@ -131,16 +127,15 @@ export const make = (...entries) => Effect.gen(function* () {
  *   const configMap = yield* TxHashMap.fromIterable(configEntries)
  *
  *   // Verify the configuration was loaded
- *   const size = yield* TxHashMap.size(configMap)
- *   console.log(size) // 4
- *
- *   const dbHost = yield* TxHashMap.get(configMap, "database.host")
- *   console.log(dbHost) // Option.some("localhost")
+ *   yield* TxHashMap.size(configMap) // => 4
+ *   yield* TxHashMap.get(configMap, "database.host") // => Option.some("localhost")
  *
  *   // Can also create from Map, Set of tuples, etc.
  *   const jsMap = new Map([["key1", "value1"], ["key2", "value2"]])
- *   const txMapFromJs = yield* TxHashMap.fromIterable(jsMap)
+ *   return yield* TxHashMap.fromIterable(jsMap)
  * })
+ *
+ * await Effect.runPromise(program)
  * ```
  *
  * @category constructors
@@ -158,7 +153,7 @@ export const fromIterable = entries => Effect.gen(function* () {
  *
  * **Example** (Looking up values safely)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Option, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -168,18 +163,14 @@ export const fromIterable = entries => Effect.gen(function* () {
  *   )
  *
  *   // Safe lookup - returns Option
- *   const alice = yield* TxHashMap.get(userMap, "alice")
- *   console.log(alice) // Option.some({ name: "Alice", role: "admin" })
- *
- *   const nonExistent = yield* TxHashMap.get(userMap, "charlie")
- *   console.log(nonExistent) // Option.none()
+ *   yield* TxHashMap.get(userMap, "alice") // => Option.some({ name: "Alice", role: "admin" })
+ *   yield* TxHashMap.get(userMap, "charlie") // => Option.none()
  *
  *   // Use with pipe syntax for type-safe access
- *   const bobRole = yield* TxHashMap.get(userMap, "bob")
- *   if (bobRole._tag === "Some") {
- *     console.log(bobRole.value.role) // "user"
- *   }
+ *   return yield* TxHashMap.get(userMap, "bob")
  * })
+ *
+ * await Effect.runPromise(program) // => Option.some({ name: "Bob", role: "user" })
  * ```
  *
  * @category combinators
@@ -199,8 +190,8 @@ export const get = /*#__PURE__*/dual(2, (self, key) => Effect.gen(function* () {
  *
  * **Example** (Setting values)
  *
- * ```ts
- * import { Effect, TxHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, Option, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const inventory = yield* TxHashMap.make(
@@ -210,17 +201,18 @@ export const get = /*#__PURE__*/dual(2, (self, key) => Effect.gen(function* () {
  *
  *   // Update existing item
  *   yield* TxHashMap.set(inventory, "laptop", 3)
- *   const laptopStock = yield* TxHashMap.get(inventory, "laptop")
- *   console.log(laptopStock) // Option.some(3)
+ *   yield* TxHashMap.get(inventory, "laptop") // => Option.some(3)
  *
  *   // Add new item
  *   yield* TxHashMap.set(inventory, "keyboard", 15)
- *   const keyboardStock = yield* TxHashMap.get(inventory, "keyboard")
- *   console.log(keyboardStock) // Option.some(15)
+ *   yield* TxHashMap.get(inventory, "keyboard") // => Option.some(15)
  *
  *   // Use with pipe syntax
  *   yield* TxHashMap.set("tablet", 8)(inventory)
+ *   return yield* TxHashMap.get(inventory, "tablet")
  * })
+ *
+ * await Effect.runPromise(program) // => Option.some(8)
  * ```
  *
  * @category combinators
@@ -232,7 +224,7 @@ export const set = /*#__PURE__*/dual(3, (self, key, value) => TxRef.update(self.
  *
  * **Example** (Checking for keys)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -243,19 +235,17 @@ export const set = /*#__PURE__*/dual(3, (self, key, value) => TxRef.update(self.
  *   )
  *
  *   // Check if users exist
- *   const hasAlice = yield* TxHashMap.has(permissions, "alice")
- *   console.log(hasAlice) // true
- *
- *   const hasDavid = yield* TxHashMap.has(permissions, "david")
- *   console.log(hasDavid) // false
+ *   yield* TxHashMap.has(permissions, "alice") // => true
+ *   yield* TxHashMap.has(permissions, "david") // => false
  *
  *   // Use direct method call for type-safe access
- *   const hasBob = yield* TxHashMap.has(permissions, "bob")
- *   console.log(hasBob) // true
+ *   return yield* TxHashMap.has(permissions, "bob")
  * })
+ *
+ * await Effect.runPromise(program) // => true
  * ```
  *
- * @category combinators
+ * @category predicates
  * @since 2.0.0
  */
 export const has = /*#__PURE__*/dual(2, (self, key) => Effect.gen(function* () {
@@ -272,7 +262,7 @@ export const has = /*#__PURE__*/dual(2, (self, key) => Effect.gen(function* () {
  *
  * **Example** (Removing keys)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -283,20 +273,17 @@ export const has = /*#__PURE__*/dual(2, (self, key) => Effect.gen(function* () {
  *   )
  *
  *   // Remove expired user
- *   const removed = yield* TxHashMap.remove(cache, "user:3")
- *   console.log(removed) // true (key existed and was removed)
+ *   yield* TxHashMap.remove(cache, "user:3") // => true
  *
  *   // Try to remove non-existent key
- *   const notRemoved = yield* TxHashMap.remove(cache, "user:999")
- *   console.log(notRemoved) // false (key didn't exist)
+ *   yield* TxHashMap.remove(cache, "user:999") // => false
  *
  *   // Verify removal
- *   const hasUser3 = yield* TxHashMap.has(cache, "user:3")
- *   console.log(hasUser3) // false
- *
- *   const size = yield* TxHashMap.size(cache)
- *   console.log(size) // 2
+ *   yield* TxHashMap.has(cache, "user:3") // => false
+ *   return yield* TxHashMap.size(cache)
  * })
+ *
+ * await Effect.runPromise(program) // => 2
  * ```
  *
  * @category combinators
@@ -320,7 +307,7 @@ export const remove = /*#__PURE__*/dual(2, (self, key) => Effect.gen(function* (
  *
  * **Example** (Clearing all entries)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -331,19 +318,17 @@ export const remove = /*#__PURE__*/dual(2, (self, key) => Effect.gen(function* (
  *   )
  *
  *   // Check initial state
- *   const initialSize = yield* TxHashMap.size(sessionMap)
- *   console.log(initialSize) // 3
+ *   yield* TxHashMap.size(sessionMap) // => 3
  *
  *   // Clear all sessions (e.g., during maintenance)
  *   yield* TxHashMap.clear(sessionMap)
  *
  *   // Verify cleared
- *   const finalSize = yield* TxHashMap.size(sessionMap)
- *   console.log(finalSize) // 0
- *
- *   const isEmpty = yield* TxHashMap.isEmpty(sessionMap)
- *   console.log(isEmpty) // true
+ *   yield* TxHashMap.size(sessionMap) // => 0
+ *   return yield* TxHashMap.isEmpty(sessionMap)
  * })
+ *
+ * await Effect.runPromise(program) // => true
  * ```
  *
  * @category combinators
@@ -355,7 +340,7 @@ export const clear = self => TxRef.set(self.ref, HashMap.empty());
  *
  * **Example** (Counting entries)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -365,19 +350,18 @@ export const clear = self => TxRef.set(self.ref, HashMap.empty());
  *     ["users", 50]
  *   )
  *
- *   const count = yield* TxHashMap.size(metrics)
- *   console.log(count) // 3
+ *   yield* TxHashMap.size(metrics) // => 3
  *
  *   // Add more metrics
  *   yield* TxHashMap.set(metrics, "response_time", 250)
- *   const newCount = yield* TxHashMap.size(metrics)
- *   console.log(newCount) // 4
+ *   yield* TxHashMap.size(metrics) // => 4
  *
  *   // Remove a metric
  *   yield* TxHashMap.remove(metrics, "errors")
- *   const finalCount = yield* TxHashMap.size(metrics)
- *   console.log(finalCount) // 3
+ *   return yield* TxHashMap.size(metrics)
  * })
+ *
+ * await Effect.runPromise(program) // => 3
  * ```
  *
  * @category combinators
@@ -392,28 +376,27 @@ export const size = self => Effect.gen(function* () {
  *
  * **Example** (Checking for an empty map)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   // Start with empty map
  *   const cache = yield* TxHashMap.empty<string, any>()
- *   const empty = yield* TxHashMap.isEmpty(cache)
- *   console.log(empty) // true
+ *   yield* TxHashMap.isEmpty(cache) // => true
  *
  *   // Add an item
  *   yield* TxHashMap.set(cache, "key1", "value1")
- *   const stillEmpty = yield* TxHashMap.isEmpty(cache)
- *   console.log(stillEmpty) // false
+ *   yield* TxHashMap.isEmpty(cache) // => false
  *
  *   // Clear and check again
  *   yield* TxHashMap.clear(cache)
- *   const emptyAgain = yield* TxHashMap.isEmpty(cache)
- *   console.log(emptyAgain) // true
+ *   return yield* TxHashMap.isEmpty(cache)
  * })
+ *
+ * await Effect.runPromise(program) // => true
  * ```
  *
- * @category combinators
+ * @category predicates
  * @since 2.0.0
  */
 export const isEmpty = self => Effect.gen(function* () {
@@ -425,23 +408,23 @@ export const isEmpty = self => Effect.gen(function* () {
  *
  * **Example** (Checking for a non-empty map)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const inventory = yield* TxHashMap.make(["laptop", 5])
  *
- *   const hasItems = yield* TxHashMap.isNonEmpty(inventory)
- *   console.log(hasItems) // true
+ *   yield* TxHashMap.isNonEmpty(inventory) // => true
  *
  *   // Clear inventory
  *   yield* TxHashMap.clear(inventory)
- *   const stillHasItems = yield* TxHashMap.isNonEmpty(inventory)
- *   console.log(stillHasItems) // false
+ *   return yield* TxHashMap.isNonEmpty(inventory)
  * })
+ *
+ * await Effect.runPromise(program) // => false
  * ```
  *
- * @category combinators
+ * @category predicates
  * @since 4.0.0
  */
 export const isNonEmpty = self => Effect.map(isEmpty(self), empty => !empty);
@@ -455,8 +438,8 @@ export const isNonEmpty = self => Effect.map(isEmpty(self), empty => !empty);
  *
  * **Example** (Updating existing values)
  *
- * ```ts
- * import { Effect, TxHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, Option, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const counters = yield* TxHashMap.make(
@@ -470,10 +453,9 @@ export const isNonEmpty = self => Effect.map(isEmpty(self), empty => !empty);
  *     "downloads",
  *     (count) => count + 1
  *   )
- *   console.log(oldDownloads) // Option.some(100)
+ *   oldDownloads // => Option.some(100)
  *
- *   const newDownloads = yield* TxHashMap.get(counters, "downloads")
- *   console.log(newDownloads) // Option.some(101)
+ *   yield* TxHashMap.get(counters, "downloads") // => Option.some(101)
  *
  *   // Try to modify non-existent key
  *   const nonExistent = yield* TxHashMap.modify(
@@ -481,11 +463,14 @@ export const isNonEmpty = self => Effect.map(isEmpty(self), empty => !empty);
  *     "clicks",
  *     (count) => count + 1
  *   )
- *   console.log(nonExistent) // Option.none()
+ *   nonExistent // => Option.none()
  *
  *   // Update views counter with direct method call
  *   yield* TxHashMap.modify(counters, "views", (views) => views * 2)
+ *   return yield* TxHashMap.get(counters, "views")
  * })
+ *
+ * await Effect.runPromise(program) // => Option.some(500)
  * ```
  *
  * @category combinators
@@ -512,42 +497,34 @@ export const modify = /*#__PURE__*/dual(3, (self, key, f) => Effect.gen(function
  *
  * **Example** (Updating values with Option)
  *
- * ```ts
- * import { Effect, TxHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, Option, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const storage = yield* TxHashMap.make<string, string | number>([
  *     "file1.txt",
  *     "content1"
  *   ], ["access_count", 0])
+ *   const increment = Option.map((value: string | number) => typeof value === "number" ? value + 1 : value)
  *
  *   // Increment existing counter
- *   yield* TxHashMap.modifyAt(storage, "access_count", (current) =>
- *     current._tag === "Some" && typeof current.value === "number"
- *       ? { ...current, value: current.value + 1 }
- *       : current
- *   )
- *   const count1 = yield* TxHashMap.get(storage, "access_count")
- *   console.log(count1) // Option.some(1)
+ *   yield* TxHashMap.modifyAt(storage, "access_count", increment)
+ *   yield* TxHashMap.get(storage, "access_count") // => Option.some(1)
  *
  *   // Increment existing counter again
- *   yield* TxHashMap.modifyAt(storage, "access_count", (current) =>
- *     current._tag === "Some" && typeof current.value === "number"
- *       ? { ...current, value: current.value + 1 }
- *       : current
- *   )
- *   const count2 = yield* TxHashMap.get(storage, "access_count")
- *   console.log(count2) // Option.some(2)
+ *   yield* TxHashMap.modifyAt(storage, "access_count", increment)
+ *   yield* TxHashMap.get(storage, "access_count") // => Option.some(2)
  *
  *   // Update an existing string entry
- *   yield* TxHashMap.modifyAt(storage, "file1.txt", (current) =>
- *     current._tag === "Some" && typeof current.value === "string"
- *       ? { ...current, value: `${current.value}.bak` }
- *       : current
+ *   yield* TxHashMap.modifyAt(
+ *     storage,
+ *     "file1.txt",
+ *     Option.map((value) => typeof value === "string" ? `${value}.bak` : value)
  *   )
- *   const backup = yield* TxHashMap.get(storage, "file1.txt")
- *   console.log(backup) // Option.some("content1.bak")
+ *   return yield* TxHashMap.get(storage, "file1.txt")
  * })
+ *
+ * await Effect.runPromise(program) // => Option.some("content1.bak")
  * ```
  *
  * @category combinators
@@ -568,7 +545,7 @@ export const modifyAt = /*#__PURE__*/dual(3, (self, key, f) => Effect.gen(functi
  *
  * **Example** (Reading keys)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Option, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -578,17 +555,21 @@ export const modifyAt = /*#__PURE__*/dual(3, (self, key, f) => Effect.gen(functi
  *     ["charlie", "moderator"]
  *   )
  *
- *   const usernames = yield* TxHashMap.keys(userRoles)
- *   console.log(usernames.sort()) // ["alice", "bob", "charlie"]
+ *   const usernames = (yield* TxHashMap.keys(userRoles)).sort()
+ *   usernames // => ["alice", "bob", "charlie"]
  *
  *   // Useful for iteration
+ *   const assignments: Array<string> = []
  *   for (const username of usernames) {
  *     const role = yield* TxHashMap.get(userRoles, username)
  *     if (role._tag === "Some") {
- *       console.log(`${username}: ${role.value}`)
+ *       assignments.push(`${username}: ${role.value}`)
  *     }
  *   }
+ *   return assignments
  * })
+ *
+ * await Effect.runPromise(program) // => ["alice: admin", "bob: user", "charlie: moderator"]
  * ```
  *
  * @category combinators
@@ -603,7 +584,7 @@ export const keys = self => Effect.gen(function* () {
  *
  * **Example** (Reading values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -613,18 +594,19 @@ export const keys = self => Effect.gen(function* () {
  *     ["charlie", 92]
  *   )
  *
- *   const allScores = yield* TxHashMap.values(scores)
- *   console.log(allScores.sort((a, b) => a - b)) // [87, 92, 95]
+ *   const allScores = (yield* TxHashMap.values(scores)).sort((a, b) => a - b)
+ *   allScores // => [87, 92, 95]
  *
  *   // Calculate average
  *   const average = allScores.reduce((sum, score) => sum + score, 0) /
  *     allScores.length
- *   console.log(average.toFixed(2)) // "91.33"
+ *   average.toFixed(2) // => "91.33"
  *
  *   // Find maximum
- *   const maxScore = Math.max(...allScores)
- *   console.log(maxScore) // 95
+ *   return Math.max(...allScores)
  * })
+ *
+ * await Effect.runPromise(program) // => 95
  * ```
  *
  * @category combinators
@@ -639,7 +621,7 @@ export const values = self => Effect.gen(function* () {
  *
  * **Example** (Reading entries)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -649,19 +631,10 @@ export const values = self => Effect.gen(function* () {
  *     ["ssl", "false"]
  *   )
  *
- *   const allEntries = yield* TxHashMap.entries(config)
- *   const sortedEntries = allEntries.toSorted(([left], [right]) => left.localeCompare(right))
- *   console.log(sortedEntries)
- *   // [["host", "localhost"], ["port", "3000"], ["ssl", "false"]]
- *
- *   // Process configuration entries
- *   for (const [key, value] of sortedEntries) {
- *     console.log(`${key}=${value}`)
- *   }
- *   // host=localhost
- *   // port=3000
- *   // ssl=false
+ *   return (yield* TxHashMap.entries(config)).toSorted(([left], [right]) => left.localeCompare(right))
  * })
+ *
+ * await Effect.runPromise(program) // => [["host", "localhost"], ["port", "3000"], ["ssl", "false"]]
  * ```
  *
  * @category combinators
@@ -676,8 +649,8 @@ export const entries = self => Effect.gen(function* () {
  *
  * **Example** (Taking immutable snapshots)
  *
- * ```ts
- * import { Effect, HashMap, TxHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, HashMap, Option, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const liveData = yield* TxHashMap.make(
@@ -694,13 +667,14 @@ export const entries = self => Effect.gen(function* () {
  *   yield* TxHashMap.set(liveData, "wind_speed", 5.3)
  *
  *   // Snapshot remains unchanged
- *   console.log(HashMap.size(snapshot)) // 3
- *   console.log(HashMap.get(snapshot, "temperature")) // Option.some(22.5)
+ *   HashMap.size(snapshot) // => 3
+ *   HashMap.get(snapshot, "temperature") // => Option.some(22.5)
  *
  *   // Can use regular HashMap operations on snapshot
- *   const tempReading = HashMap.get(snapshot, "temperature")
- *   const humidityReading = HashMap.get(snapshot, "humidity")
+ *   return HashMap.get(snapshot, "humidity")
  * })
+ *
+ * await Effect.runPromise(program) // => Option.some(45.2)
  * ```
  *
  * @category combinators
@@ -718,8 +692,8 @@ export const snapshot = self => TxRef.get(self.ref);
  *
  * **Example** (Merging HashMaps)
  *
- * ```ts
- * import { Effect, HashMap, TxHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, HashMap, Option, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   // Create initial user preferences
@@ -740,18 +714,13 @@ export const snapshot = self => TxRef.get(self.ref);
  *   yield* TxHashMap.union(userPrefs, newSettings)
  *
  *   // Check the merged result
- *   const theme = yield* TxHashMap.get(userPrefs, "theme")
- *   console.log(theme) // Option.some("dark") - overridden
- *
- *   const language = yield* TxHashMap.get(userPrefs, "language")
- *   console.log(language) // Option.some("en") - preserved
- *
- *   const timezone = yield* TxHashMap.get(userPrefs, "timezone")
- *   console.log(timezone) // Option.some("UTC") - newly added
- *
- *   const size = yield* TxHashMap.size(userPrefs)
- *   console.log(size) // 5 total settings
+ *   yield* TxHashMap.get(userPrefs, "theme") // => Option.some("dark")
+ *   yield* TxHashMap.get(userPrefs, "language") // => Option.some("en")
+ *   yield* TxHashMap.get(userPrefs, "timezone") // => Option.some("UTC")
+ *   return yield* TxHashMap.size(userPrefs)
  * })
+ *
+ * await Effect.runPromise(program) // => 5
  * ```
  *
  * @category combinators
@@ -768,8 +737,8 @@ export const union = /*#__PURE__*/dual(2, (self, other) => TxRef.update(self.ref
  *
  * **Example** (Removing multiple keys)
  *
- * ```ts
- * import { Effect, TxHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, Option, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   // Create a cache with temporary data
@@ -781,23 +750,24 @@ export const union = /*#__PURE__*/dual(2, (self, other) => TxRef.update(self.ref
  *     ["temp_data_2", { value: "also_temporary" }]
  *   )
  *
- *   console.log(yield* TxHashMap.size(cache)) // 5
+ *   yield* TxHashMap.size(cache) // => 5
  *
  *   // Remove expired sessions and temporary data
  *   const keysToRemove = ["session_1", "session_2", "temp_data_1", "temp_data_2"]
  *   yield* TxHashMap.removeMany(cache, keysToRemove)
  *
- *   console.log(yield* TxHashMap.size(cache)) // 1
+ *   yield* TxHashMap.size(cache) // => 1
  *
  *   // Verify only the valid session remains
- *   const remainingSession = yield* TxHashMap.get(cache, "session_3")
- *   console.log(remainingSession) // Option.some({ user: "charlie", expires: "2024-12-31" })
+ *   yield* TxHashMap.get(cache, "session_3") // => Option.some({ user: "charlie", expires: "2024-12-31" })
  *
  *   // Can also remove from Set, Array, or any iterable
  *   const moreKeysToRemove = new Set(["session_3"])
  *   yield* TxHashMap.removeMany(cache, moreKeysToRemove)
- *   console.log(yield* TxHashMap.isEmpty(cache)) // true
+ *   return yield* TxHashMap.isEmpty(cache)
  * })
+ *
+ * await Effect.runPromise(program) // => true
  * ```
  *
  * @category combinators
@@ -814,8 +784,8 @@ export const removeMany = /*#__PURE__*/dual(2, (self, keys) => TxRef.update(self
  *
  * **Example** (Setting multiple entries)
  *
- * ```ts
- * import { Effect, TxHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, Option, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   // Create an empty product catalog
@@ -836,7 +806,7 @@ export const removeMany = /*#__PURE__*/dual(2, (self, keys) => TxRef.update(self
  *
  *   yield* TxHashMap.setMany(catalog, initialProducts)
  *
- *   console.log(yield* TxHashMap.size(catalog)) // 4
+ *   yield* TxHashMap.size(catalog) // => 4
  *
  *   // Update prices with a new batch
  *   const priceUpdates: Array<
@@ -849,16 +819,18 @@ export const removeMany = /*#__PURE__*/dual(2, (self, keys) => TxRef.update(self
  *
  *   yield* TxHashMap.setMany(catalog, priceUpdates)
  *
- *   console.log(yield* TxHashMap.size(catalog)) // 5 (4 original + 1 new)
+ *   yield* TxHashMap.size(catalog) // => 5
  *
  *   // Verify the updates
- *   const laptop = yield* TxHashMap.get(catalog, "laptop")
- *   console.log(laptop) // Option.some({ price: 899, stock: 5 })
+ *   yield* TxHashMap.get(catalog, "laptop") // => Option.some({ price: 899, stock: 5 })
  *
  *   // Can also use Map, Set of tuples, or any iterable of entries
  *   const jsMap = new Map([["tablet", { price: 399, stock: 3 }]])
  *   yield* TxHashMap.setMany(catalog, jsMap)
+ *   return yield* TxHashMap.get(catalog, "tablet")
  * })
+ *
+ * await Effect.runPromise(program) // => Option.some({ price: 399, stock: 3 })
  * ```
  *
  * @category combinators
@@ -870,16 +842,16 @@ export const setMany = /*#__PURE__*/dual(2, (self, entries) => TxRef.update(self
  *
  * **Example** (Checking TxHashMap values)
  *
- * ```ts
- * import { Effect, TxHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, Exit, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   const txMap = yield* TxHashMap.make(["key", "value"])
  *
- *   console.log(TxHashMap.isTxHashMap(txMap)) // true
- *   console.log(TxHashMap.isTxHashMap({})) // false
- *   console.log(TxHashMap.isTxHashMap(null)) // false
- *   console.log(TxHashMap.isTxHashMap("not a map")) // false
+ *   TxHashMap.isTxHashMap(txMap) // => true
+ *   TxHashMap.isTxHashMap({}) // => false
+ *   TxHashMap.isTxHashMap(null) // => false
+ *   TxHashMap.isTxHashMap("not a map") // => false
  *
  *   // Useful for type guards in runtime checks
  *   const validateInput = (value: unknown) => {
@@ -889,7 +861,12 @@ export const setMany = /*#__PURE__*/dual(2, (self, entries) => TxRef.update(self
  *     }
  *     return Effect.fail("Invalid input")
  *   }
+ *
+ *   yield* Effect.exit(validateInput(null)) // => Exit.fail("Invalid input")
+ *   return yield* Effect.exit(validateInput(txMap))
  * })
+ *
+ * await Effect.runPromise(program) // => Exit.succeed("Valid TxHashMap")
  * ```
  *
  * @category guards
@@ -909,8 +886,8 @@ export const isTxHashMap = value => {
  *
  * **Example** (Looking up values with precomputed hashes)
  *
- * ```ts
- * import { Effect, Hash, TxHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, Hash, Option, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   // Create a cache with user sessions
@@ -925,16 +902,17 @@ export const isTxHashMap = value => {
  *
  *   // Use hash-optimized lookup for performance in hot paths
  *   const session = yield* TxHashMap.getHash(cache, sessionId, precomputedHash)
- *   console.log(session) // Option.some({ userId: "user1", lastActive: ... })
+ *   session // => Option.some({ userId: "user1", lastActive: 1_700_000_000_000 })
  *
  *   // This avoids recomputing the hash when you already have it
- *   const invalidSession = yield* TxHashMap.getHash(
+ *   return yield* TxHashMap.getHash(
  *     cache,
  *     "invalid",
  *     Hash.string("invalid")
  *   )
- *   console.log(invalidSession) // Option.none()
  * })
+ *
+ * await Effect.runPromise(program) // => Option.none()
  * ```
  *
  * @category combinators
@@ -952,7 +930,7 @@ export const getHash = /*#__PURE__*/dual(3, (self, key, hash) => TxRef.get(self.
  *
  * **Example** (Checking keys with precomputed hashes)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Hash, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -967,29 +945,30 @@ export const getHash = /*#__PURE__*/dual(3, (self, key, hash) => TxRef.get(self.
  *   const roleHash = Hash.string(role)
  *
  *   // Use hash-optimized existence check
- *   const hasAdminRole = yield* TxHashMap.hasHash(permissions, role, roleHash)
- *   console.log(hasAdminRole) // true
+ *   yield* TxHashMap.hasHash(permissions, role, roleHash) // => true
  *
  *   // Check non-existent role
- *   const hasGuestRole = yield* TxHashMap.hasHash(
+ *   yield* TxHashMap.hasHash(
  *     permissions,
  *     "guest",
  *     Hash.string("guest")
- *   )
- *   console.log(hasGuestRole) // false
+ *   ) // => false
  *
  *   // Useful in hot paths where hash is computed once and reused
  *   const roles = ["admin", "user", "moderator"]
  *   const roleHashes = roles.map((role) => [role, Hash.string(role)] as const)
- *
+ *   const results: Array<string> = []
  *   for (const [role, hash] of roleHashes) {
  *     const exists = yield* TxHashMap.hasHash(permissions, role, hash)
- *     console.log(`Role ${role}: ${exists}`)
+ *     results.push(`Role ${role}: ${exists}`)
  *   }
+ *   return results
  * })
+ *
+ * await Effect.runPromise(program) // => ["Role admin: true", "Role user: true", "Role moderator: false"]
  * ```
  *
- * @category combinators
+ * @category predicates
  * @since 4.0.0
  */
 export const hasHash = /*#__PURE__*/dual(3, (self, key, hash) => TxRef.get(self.ref).pipe(Effect.map(map => HashMap.hasHash(map, key, hash))));
@@ -1003,8 +982,8 @@ export const hasHash = /*#__PURE__*/dual(3, (self, key, hash) => TxRef.get(self.
  *
  * **Example** (Mapping values)
  *
- * ```ts
- * import { Effect, TxHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, Option, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   // Create a user profile map
@@ -1021,21 +1000,20 @@ export const hasHash = /*#__PURE__*/dual(3, (self, key, hash) => TxRef.get(self.
  *   )
  *
  *   // Check the transformed values
- *   const aliceGreeting = yield* TxHashMap.get(greetings, "alice")
- *   console.log(aliceGreeting) // Option.some("Hello, Alice! (User: alice)")
+ *   yield* TxHashMap.get(greetings, "alice") // => Option.some("Hello, Alice! (User: alice)")
  *
  *   // Data-last usage with pipe
  *   const ages = yield* profiles.pipe(
  *     TxHashMap.map((profile) => profile.age)
  *   )
  *
- *   const aliceAge = yield* TxHashMap.get(ages, "alice")
- *   console.log(aliceAge) // Option.some(30)
+ *   yield* TxHashMap.get(ages, "alice") // => Option.some(30)
  *
  *   // Original map is unchanged
- *   const originalAlice = yield* TxHashMap.get(profiles, "alice")
- *   console.log(originalAlice) // Option.some({ name: "Alice", age: 30, active: true })
+ *   return yield* TxHashMap.get(profiles, "alice")
  * })
+ *
+ * await Effect.runPromise(program) // => Option.some({ name: "Alice", age: 30, active: true })
  * ```
  *
  * @category combinators
@@ -1056,7 +1034,7 @@ export const map = /*#__PURE__*/dual(2, (self, f) => Effect.gen(function* () {
  *
  * **Example** (Filtering entries)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1074,24 +1052,24 @@ export const map = /*#__PURE__*/dual(2, (self, f) => Effect.gen(function* () {
  *     (product) => product.category === "electronics" && product.stock > 0
  *   )
  *
- *   const size = yield* TxHashMap.size(electronicsInStock)
- *   console.log(size) // 2 (laptop and mouse)
+ *   yield* TxHashMap.size(electronicsInStock) // => 2
  *
  *   // Data-last usage with pipe
  *   const expensiveItems = yield* inventory.pipe(
  *     TxHashMap.filter((product) => product.price > 500)
  *   )
  *
- *   const expensiveSize = yield* TxHashMap.size(expensiveItems)
- *   console.log(expensiveSize) // 2 (laptop and phone)
+ *   yield* TxHashMap.size(expensiveItems) // => 2
  *
  *   // Type guard usage
- *   const highValueItems = yield* TxHashMap.filter(
+ *   return yield* TxHashMap.filter(
  *     inventory,
  *     (product): product is typeof product & { price: number } =>
  *       product.price > 50
  *   )
  * })
+ *
+ * await Effect.runPromise(program)
  * ```
  *
  * @category combinators
@@ -1108,7 +1086,7 @@ export const filter = /*#__PURE__*/dual(2, (self, predicate) => Effect.gen(funct
  *
  * **Example** (Reducing entries)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1124,12 +1102,9 @@ export const filter = /*#__PURE__*/dual(2, (self, predicate) => Effect.gen(funct
  *   const totalSales = yield* TxHashMap.reduce(
  *     sales,
  *     0,
- *     (total, amount, quarter) => {
- *       console.log(`Adding ${quarter}: ${amount}`)
- *       return total + amount
- *     }
+ *     (total, amount) => total + amount
  *   )
- *   console.log(`Total sales: ${totalSales}`) // 80000
+ *   totalSales // => 80000
  *
  *   // Data-last usage with pipe
  *   const quarterlyReport = yield* sales.pipe(
@@ -1142,16 +1117,10 @@ export const filter = /*#__PURE__*/dual(2, (self, predicate) => Effect.gen(funct
  *       })
  *     )
  *   )
- *   console.log(quarterlyReport) // { quarters: 4, total: 80000, max: 25000 }
- *
- *   // Build a summary string
- *   const summary = yield* TxHashMap.reduce(
- *     sales,
- *     "",
- *     (acc, amount, quarter) => acc + `${quarter}: $${amount.toLocaleString()}\n`
- *   )
- *   console.log(summary)
+ *   return quarterlyReport
  * })
+ *
+ * await Effect.runPromise(program) // => { quarters: 4, total: 80000, max: 25000 }
  * ```
  *
  * @category combinators
@@ -1169,7 +1138,7 @@ export const reduce = /*#__PURE__*/dual(3, (self, zero, f) => TxRef.get(self.ref
  *
  * **Example** (Filtering and mapping entries)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Option, Result, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1197,10 +1166,8 @@ export const reduce = /*#__PURE__*/dual(3, (self, zero, f) => TxRef.get(self.ref
  *   )
  *
  *   const aliceData = yield* TxHashMap.get(activeAdminAges, "alice")
- *   console.log(aliceData) // Option.some({ username: "alice", age: 30, seniority: "senior" })
- *
- *   const charlieData = yield* TxHashMap.get(activeAdminAges, "charlie")
- *   console.log(charlieData) // Option.none() (not active)
+ *   aliceData // => Option.some({ username: "alice", age: 30, seniority: "senior" })
+ *   yield* TxHashMap.get(activeAdminAges, "charlie") // => Option.none()
  *
  *   // Data-last usage with pipe
  *   const validAges = yield* userData.pipe(
@@ -1210,9 +1177,10 @@ export const reduce = /*#__PURE__*/dual(3, (self, zero, f) => TxRef.get(self.ref
  *     })
  *   )
  *
- *   const size = yield* TxHashMap.size(validAges)
- *   console.log(size) // 3 (alice, charlie, diana have valid ages)
+ *   return yield* TxHashMap.size(validAges)
  * })
+ *
+ * await Effect.runPromise(program) // => 3
  * ```
  *
  * @category combinators
@@ -1228,7 +1196,7 @@ export const filterMap = /*#__PURE__*/dual(2, (self, f) => Effect.gen(function*
  *
  * **Example** (Checking entries with a predicate)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1241,28 +1209,27 @@ export const filterMap = /*#__PURE__*/dual(2, (self, f) => Effect.gen(function*
  *   )
  *
  *   // Check if any users are online
- *   const hasOnlineUsers = yield* TxHashMap.hasBy(
+ *   yield* TxHashMap.hasBy(
  *     userStatuses,
  *     (user) => user.status === "online"
- *   )
- *   console.log(hasOnlineUsers) // true
+ *   ) // => true
  *
  *   // Check if any users have specific username pattern
- *   const hasAdminUser = yield* TxHashMap.hasBy(
+ *   yield* TxHashMap.hasBy(
  *     userStatuses,
  *     (user, username) => username.startsWith("admin")
- *   )
- *   console.log(hasAdminUser) // false
+ *   ) // => false
  *
  *   // Data-last usage with pipe
- *   const hasRecentActivity = yield* userStatuses.pipe(
+ *   return yield* userStatuses.pipe(
  *     TxHashMap.hasBy((user) => currentTime - user.lastSeen < 1_800_000) // 30 minutes
  *   )
- *   console.log(hasRecentActivity) // true
  * })
+ *
+ * await Effect.runPromise(program) // => true
  * ```
  *
- * @category combinators
+ * @category predicates
  * @since 4.0.0
  */
 export const hasBy = /*#__PURE__*/dual(2, (self, predicate) => TxRef.get(self.ref).pipe(Effect.map(map => HashMap.hasBy(map, predicate))));
@@ -1272,8 +1239,8 @@ export const hasBy = /*#__PURE__*/dual(2, (self, predicate) => TxRef.get(self.re
  *
  * **Example** (Finding the first matching entry)
  *
- * ```ts
- * import { Effect, TxHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, Option, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   // Create a task priority map
@@ -1289,21 +1256,15 @@ export const hasBy = /*#__PURE__*/dual(2, (self, predicate) => TxRef.get(self.re
  *     (task) => task.priority >= 2 && !task.completed
  *   )
  *
- *   if (highPriorityTask._tag === "Some") {
- *     const [taskId, task] = highPriorityTask.value
- *     console.log(`Found task: ${taskId}, priority: ${task.priority}`)
- *     // "Found task: task3, priority: 2"
- *   }
+ *   highPriorityTask // => Option.some(["task3", { priority: 2, assignee: "alice", completed: false }])
  *
  *   // Find first task assigned to specific user
- *   const aliceTask = yield* tasks.pipe(
+ *   return yield* tasks.pipe(
  *     TxHashMap.findFirst((task) => task.assignee === "alice")
  *   )
- *
- *   if (aliceTask._tag === "Some") {
- *     console.log(`Alice's task: ${aliceTask.value[0]}`)
- *   }
  * })
+ *
+ * await Effect.runPromise(program) // => Option.some(["task1", { priority: 1, assignee: "alice", completed: false }])
  * ```
  *
  * @category combinators
@@ -1315,7 +1276,7 @@ export const findFirst = /*#__PURE__*/dual(2, (self, predicate) => TxRef.get(sel
  *
  * **Example** (Checking whether some entries match)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1327,28 +1288,27 @@ export const findFirst = /*#__PURE__*/dual(2, (self, predicate) => TxRef.get(sel
  *   )
  *
  *   // Check if any products are expensive
- *   const hasExpensiveProducts = yield* TxHashMap.some(
+ *   yield* TxHashMap.some(
  *     inventory,
  *     (product) => product.price > 500
- *   )
- *   console.log(hasExpensiveProducts) // true
+ *   ) // => true
  *
  *   // Check if any products are out of stock
- *   const hasOutOfStock = yield* TxHashMap.some(
+ *   yield* TxHashMap.some(
  *     inventory,
  *     (product) => product.stock === 0
- *   )
- *   console.log(hasOutOfStock) // true
+ *   ) // => true
  *
  *   // Data-last usage with pipe
- *   const hasAffordableItems = yield* inventory.pipe(
+ *   return yield* inventory.pipe(
  *     TxHashMap.some((product) => product.price < 50)
  *   )
- *   console.log(hasAffordableItems) // true (mouse is $29)
  * })
+ *
+ * await Effect.runPromise(program) // => true
  * ```
  *
- * @category combinators
+ * @category predicates
  * @since 4.0.0
  */
 export const some = /*#__PURE__*/dual(2, (self, predicate) => TxRef.get(self.ref).pipe(Effect.map(map => HashMap.some(map, predicate))));
@@ -1357,7 +1317,7 @@ export const some = /*#__PURE__*/dual(2, (self, predicate) => TxRef.get(self.ref
  *
  * **Example** (Checking whether every entry matches)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1369,28 +1329,27 @@ export const some = /*#__PURE__*/dual(2, (self, predicate) => TxRef.get(self.ref
  *   )
  *
  *   // Check if all users can read
- *   const allCanRead = yield* TxHashMap.every(
+ *   yield* TxHashMap.every(
  *     permissions,
  *     (perms) => perms.canRead
- *   )
- *   console.log(allCanRead) // true
+ *   ) // => true
  *
  *   // Check if all users can write
- *   const allCanWrite = yield* TxHashMap.every(
+ *   yield* TxHashMap.every(
  *     permissions,
  *     (perms) => perms.canWrite
- *   )
- *   console.log(allCanWrite) // false
+ *   ) // => false
  *
  *   // Data-last usage with pipe
- *   const allHaveBasicAccess = yield* permissions.pipe(
+ *   return yield* permissions.pipe(
  *     TxHashMap.every((perms, username) => perms.canRead && username.length > 2)
  *   )
- *   console.log(allHaveBasicAccess) // true
  * })
+ *
+ * await Effect.runPromise(program) // => true
  * ```
  *
- * @category combinators
+ * @category predicates
  * @since 4.0.0
  */
 export const every = /*#__PURE__*/dual(2, (self, predicate) => TxRef.get(self.ref).pipe(Effect.map(map => HashMap.every(map, predicate))));
@@ -1400,8 +1359,8 @@ export const every = /*#__PURE__*/dual(2, (self, predicate) => TxRef.get(self.re
  *
  * **Example** (Running effects for each entry)
  *
- * ```ts
- * import { Console, Effect, TxHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   // Create a log processing map
@@ -1411,26 +1370,17 @@ export const every = /*#__PURE__*/dual(2, (self, predicate) => TxRef.get(self.re
  *     ["debug.log", { size: 512, level: "debug" }]
  *   )
  *
- *   // Process each log file with side effects
+ *   const messages: Array<string> = []
  *   yield* TxHashMap.forEach(logs, (logInfo, filename) =>
- *     Effect.gen(function*() {
- *       yield* Console.log(
- *         `Processing ${filename}: ${logInfo.size} bytes, level: ${logInfo.level}`
- *       )
- *       if (logInfo.level === "error") {
- *         yield* Console.log(`⚠️  Error log detected: ${filename}`)
- *       }
+ *     Effect.sync(() => {
+ *       messages.push(`${filename}: ${logInfo.size} bytes (${logInfo.level})`)
  *     }))
  *
- *   // Data-last usage with pipe
- *   yield* logs.pipe(
- *     TxHashMap.forEach((logInfo) =>
- *       logInfo.size > 1000
- *         ? Console.log(`Large log file: ${logInfo.size} bytes`)
- *         : Effect.void
- *     )
- *   )
+ *   return messages.sort()
  * })
+ *
+ * const result = await Effect.runPromise(program)
+ * result // => ["access.log: 2048 bytes (info)", "debug.log: 512 bytes (debug)", "error.log: 1024 bytes (error)"]
  * ```
  *
  * @category combinators
@@ -1451,8 +1401,8 @@ export const forEach = /*#__PURE__*/dual(2, (self, f) => Effect.gen(function* ()
  *
  * **Example** (Flat mapping entries)
  *
- * ```ts
- * import { Effect, TxHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Effect, Option, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
  *   // Create a department-employee map
@@ -1480,15 +1430,12 @@ export const forEach = /*#__PURE__*/dual(2, (self, f) => Effect.gen(function* ()
  *   )
  *
  *   // Check the flattened result
- *   const alice = yield* TxHashMap.get(employeeDetails, "alice")
- *   console.log(alice) // Option.some({ department: "engineering", role: "lead" })
- *
- *   const charlie = yield* TxHashMap.get(employeeDetails, "charlie")
- *   console.log(charlie) // Option.some({ department: "marketing", role: "lead" })
- *
- *   const size = yield* TxHashMap.size(employeeDetails)
- *   console.log(size) // 4 (all employees)
+ *   yield* TxHashMap.get(employeeDetails, "alice") // => Option.some({ department: "engineering", role: "lead" })
+ *   yield* TxHashMap.get(employeeDetails, "charlie") // => Option.some({ department: "marketing", role: "lead" })
+ *   return yield* TxHashMap.size(employeeDetails)
  * })
+ *
+ * await Effect.runPromise(program) // => 4
  * ```
  *
  * @category combinators
@@ -1515,7 +1462,7 @@ export const flatMap = /*#__PURE__*/dual(2, (self, f) => Effect.gen(function* ()
  *
  * **Example** (Compacting optional values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, Option, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1534,21 +1481,17 @@ export const flatMap = /*#__PURE__*/dual(2, (self, f) => Effect.gen(function* ()
  *   // Remove all None values and unwrap Some values
  *   const validUsers = yield* TxHashMap.compact(userData)
  *
- *   const size = yield* TxHashMap.size(validUsers)
- *   console.log(size) // 3 (alice, charlie, eve)
- *
- *   const alice = yield* TxHashMap.get(validUsers, "alice")
- *   console.log(alice) // Option.some({ age: 30, email: "alice@example.com" })
+ *   yield* TxHashMap.size(validUsers) // => 3
  *
- *   const bob = yield* TxHashMap.get(validUsers, "bob")
- *   console.log(bob) // Option.none() (removed from map)
+ *   yield* TxHashMap.get(validUsers, "alice") // => Option.some({ age: 30, email: "alice@example.com" })
+ *   yield* TxHashMap.get(validUsers, "bob") // => Option.none()
  *
  *   // Useful for cleaning up optional data processing results
  *   const userAges = yield* TxHashMap.map(validUsers, (user) => user.age)
- *   const ageEntries = yield* TxHashMap.entries(userAges)
- *   const sortedAgeEntries = ageEntries.toSorted(([left], [right]) => left.localeCompare(right))
- *   console.log(sortedAgeEntries) // [["alice", 30], ["charlie", 25], ["eve", 28]]
+ *   return (yield* TxHashMap.entries(userAges)).toSorted(([left], [right]) => left.localeCompare(right))
  * })
+ *
+ * await Effect.runPromise(program) // => [["alice", 30], ["charlie", 25], ["eve", 28]]
  * ```
  *
  * @category combinators
@@ -1565,7 +1508,7 @@ export const compact = self => Effect.gen(function* () {
  *
  * **Example** (Converting to entries)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1576,24 +1519,18 @@ export const compact = self => Effect.gen(function* () {
  *   )
  *
  *   // Get all entries as an array
- *   const allEntries = yield* TxHashMap.toEntries(settings)
- *   const sortedEntries = allEntries.toSorted(([left], [right]) => left.localeCompare(right))
- *   console.log(sortedEntries)
- *   // [["language", "en-US"], ["theme", "dark"], ["timezone", "UTC"]]
- *
- *   // Process entries
- *   for (const [setting, value] of sortedEntries) {
- *     console.log(`${setting}: ${value}`)
- *   }
+ *   const sortedEntries = (yield* TxHashMap.toEntries(settings))
+ *     .toSorted(([left], [right]) => left.localeCompare(right))
+ *   sortedEntries // => [["language", "en-US"], ["theme", "dark"], ["timezone", "UTC"]]
  *
- *   // Convert to object for JSON serialization
- *   const settingsObj = Object.fromEntries(sortedEntries)
- *   console.log(JSON.stringify(settingsObj))
- *   // {"language":"en-US","theme":"dark","timezone":"UTC"}
+ *   // Convert to an object
+ *   return Object.fromEntries(sortedEntries)
  * })
+ *
+ * await Effect.runPromise(program) // => { language: "en-US", theme: "dark", timezone: "UTC" }
  * ```
  *
- * @category combinators
+ * @category getters
  * @since 4.0.0
  */
 export const toEntries = self => entries(self);
@@ -1603,7 +1540,7 @@ export const toEntries = self => entries(self);
  *
  * **Example** (Converting to values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Effect, TxHashMap } from "effect"
  *
  * const program = Effect.gen(function*() {
@@ -1615,22 +1552,23 @@ export const toEntries = self => entries(self);
  *
  *   // Get all product information
  *   const products = yield* TxHashMap.toValues(inventory)
- *   console.log(products.length) // 3
+ *   products.length // => 3
  *
  *   // Calculate total inventory value
  *   const totalValue = products.reduce(
  *     (sum, product) => sum + (product.price * product.stock),
  *     0
  *   )
- *   console.log(`Total inventory value: $${totalValue}`) // Total inventory value: $8025
+ *   totalValue // => 8025
  *
  *   // Find products with low stock
- *   const lowStockProducts = products.filter((product) => product.stock < 10)
- *   console.log(`${lowStockProducts.length} product with low stock`) // 1 product with low stock
+ *   return products.filter((product) => product.stock < 10).length
  * })
+ *
+ * await Effect.runPromise(program) // => 1
  * ```
  *
- * @category combinators
+ * @category getters
  * @since 4.0.0
  */
 export const toValues = self => values(self);