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

package/dist/HashMap.js

@@ -16,18 +16,18 @@ const TypeId = internal.HashMapTypeId;
  *
  * **Example** (Checking HashMap values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2])
  * const notMap = { a: 1 }
  *
- * console.log(HashMap.isHashMap(map)) // true
- * console.log(HashMap.isHashMap(notMap)) // false
- * console.log(HashMap.isHashMap(null)) // false
+ * HashMap.isHashMap(map) // => true
+ * HashMap.isHashMap(notMap) // => false
+ * HashMap.isHashMap(null) // => false
  * ```
  *
- * @category refinements
+ * @category guards
  * @since 2.0.0
  */
 export const isHashMap = internal.isHashMap;
@@ -36,12 +36,10 @@ export const isHashMap = internal.isHashMap;
  *
  * **Example** (Creating an empty HashMap)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
- * const map = HashMap.empty<string, number>()
- * console.log(HashMap.isEmpty(map)) // true
- * console.log(HashMap.size(map)) // 0
+ * HashMap.empty<string, number>() // => HashMap.empty()
  * ```
  *
  * @category constructors
@@ -53,12 +51,10 @@ export const empty = internal.empty;
  *
  * **Example** (Creating a HashMap from entries)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
- * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
- * console.log(HashMap.size(map)) // 3
- * console.log(HashMap.get(map, "b")) // Option.some(2)
+ * HashMap.make(["a", 1], ["b", 2], ["c", 3]) // => HashMap.make(["a", 1], ["b", 2], ["c", 3])
  * ```
  *
  * @category constructors
@@ -70,13 +66,11 @@ export const make = internal.make;
  *
  * **Example** (Creating a HashMap from an iterable)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const entries = [["a", 1], ["b", 2], ["c", 3]] as const
- * const map = HashMap.fromIterable(entries)
- * console.log(HashMap.size(map)) // 3
- * console.log(HashMap.get(map, "a")) // Option.some(1)
+ * HashMap.fromIterable(entries) // => HashMap.make(["a", 1], ["b", 2], ["c", 3])
  * ```
  *
  * @category constructors
@@ -88,17 +82,17 @@ export const fromIterable = internal.fromIterable;
  *
  * **Example** (Checking for empty HashMaps)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const emptyMap = HashMap.empty<string, number>()
  * const nonEmptyMap = HashMap.make(["a", 1])
  *
- * console.log(HashMap.isEmpty(emptyMap)) // true
- * console.log(HashMap.isEmpty(nonEmptyMap)) // false
+ * HashMap.isEmpty(emptyMap) // => true
+ * HashMap.isEmpty(nonEmptyMap) // => false
  * ```
  *
- * @category elements
+ * @category predicates
  * @since 2.0.0
  */
 export const isEmpty = internal.isEmpty;
@@ -108,20 +102,19 @@ export const isEmpty = internal.isEmpty;
  *
  * **Example** (Looking up values)
  *
- * ```ts
- * import { HashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { HashMap, Option } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2])
  *
- * console.log(HashMap.get(map, "a")) // Option.some(1)
- * console.log(HashMap.get(map, "c")) // Option.none()
+ * HashMap.get(map, "a") // => Option.some(1)
+ * HashMap.get(map, "c") // => Option.none()
  *
  * // Using pipe syntax
- * const value = HashMap.get("b")(map)
- * console.log(value) // Option.some(2)
+ * HashMap.get("b")(map) // => Option.some(2)
  * ```
  *
- * @category elements
+ * @category getters
  * @since 2.0.0
  */
 export const get = internal.get;
@@ -130,8 +123,8 @@ export const get = internal.get;
  *
  * **Example** (Looking up values with a hash)
  *
- * ```ts
- * import { Hash, HashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { Hash, HashMap, Option } from "effect"
  *
  * // Useful when implementing custom equality for complex keys
  * const userMap = HashMap.make(
@@ -144,15 +137,13 @@ export const get = internal.get;
  * const precomputedHash = Hash.string(userId)
  *
  * // Lookup with custom hash (e.g., cached hash value)
- * const user = HashMap.getHash(userMap, userId, precomputedHash)
- * console.log(user) // Option.some({ name: "Alice", role: "admin" })
+ * HashMap.getHash(userMap, userId, precomputedHash) // => Option.some({ name: "Alice", role: "admin" })
  *
  * // This avoids recomputing the hash when you already have it
- * const notFound = HashMap.getHash(userMap, "user999", Hash.string("user999"))
- * console.log(notFound) // Option.none()
+ * HashMap.getHash(userMap, "user999", Hash.string("user999")) // => Option.none()
  * ```
  *
- * @category elements
+ * @category getters
  * @since 2.0.0
  */
 export const getHash = internal.getHash;
@@ -172,7 +163,7 @@ export const getHash = internal.getHash;
  *
  * **Example** (Unsafely looking up values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap, Option } from "effect"
  *
  * const config = HashMap.make(
@@ -182,14 +173,10 @@ export const getHash = internal.getHash;
  * )
  *
  * // Safe: use when you're certain the key exists
- * const apiUrl = HashMap.getUnsafe(config, "api_url") // "https://api.example.com"
- * console.log(`Connecting to: ${apiUrl}`)
+ * HashMap.getUnsafe(config, "api_url") // => "https://api.example.com"
  *
  * // Preferred: use get() for uncertain keys
- * const dbUrl = HashMap.get(config, "db_url") // Option.none()
- * if (Option.isSome(dbUrl)) {
- *   console.log(`Database: ${dbUrl.value}`)
- * }
+ * HashMap.get(config, "db_url") // => Option.none()
  *
  * // This would throw: HashMap.getUnsafe(config, "db_url")
  * // Error: "HashMap.getUnsafe: key not found"
@@ -204,20 +191,19 @@ export const getUnsafe = internal.getUnsafe;
  *
  * **Example** (Checking for keys)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2])
  *
- * console.log(HashMap.has(map, "a")) // true
- * console.log(HashMap.has(map, "c")) // false
+ * HashMap.has(map, "a") // => true
+ * HashMap.has(map, "c") // => false
  *
  * // Using pipe syntax
- * const hasB = HashMap.has("b")(map)
- * console.log(hasB) // true
+ * HashMap.has("b")(map) // => true
  * ```
  *
- * @category elements
+ * @category predicates
  * @since 2.0.0
  */
 export const has = internal.has;
@@ -227,7 +213,7 @@ export const has = internal.has;
  *
  * **Example** (Checking keys with a hash)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Hash, HashMap } from "effect"
  *
  * // Create a map with case-sensitive keys
@@ -238,17 +224,17 @@ export const has = internal.has;
  *
  * // Check with exact hash
  * const exactHash = Hash.string("Admin")
- * console.log(HashMap.hasHash(userMap, "Admin", exactHash)) // true
+ * HashMap.hasHash(userMap, "Admin", exactHash) // => true
  *
  * // A matching hash does not override key equality
- * console.log(HashMap.hasHash(userMap, "admin", exactHash)) // false
+ * HashMap.hasHash(userMap, "admin", exactHash) // => false
  *
  * // A different hash also cannot find the existing key
  * const lowercaseHash = Hash.string("admin")
- * console.log(HashMap.hasHash(userMap, "Admin", lowercaseHash)) // false
+ * HashMap.hasHash(userMap, "Admin", lowercaseHash) // => false
  * ```
  *
- * @category elements
+ * @category predicates
  * @since 2.0.0
  */
 export const hasHash = internal.hasHash;
@@ -257,15 +243,15 @@ export const hasHash = internal.hasHash;
  *
  * **Example** (Checking entries by predicate)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const hm = HashMap.make([1, "a"])
- * HashMap.hasBy(hm, (value, key) => value === "a" && key === 1) // -> true
- * HashMap.hasBy(hm, (value) => value === "b") // -> false
+ * HashMap.hasBy(hm, (value, key) => value === "a" && key === 1) // => true
+ * HashMap.hasBy(hm, (value) => value === "b") // => false
  * ```
  *
- * @category elements
+ * @category predicates
  * @since 3.16.0
  */
 export const hasBy = internal.hasBy;
@@ -275,17 +261,14 @@ export const hasBy = internal.hasBy;
  *
  * **Example** (Setting a value)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const map1 = HashMap.make(["a", 1])
- * const map2 = HashMap.set(map1, "b", 2)
- *
- * console.log(HashMap.size(map2)) // 2
- * console.log(HashMap.get(map2, "b")) // Option.some(2)
+ * HashMap.set(map1, "b", 2) // => HashMap.make(["a", 1], ["b", 2])
  *
  * // Original map is unchanged
- * console.log(HashMap.size(map1)) // 1
+ * map1 // => HashMap.make(["a", 1])
  * ```
  *
  * @category transforming
@@ -297,12 +280,11 @@ export const set = internal.set;
  *
  * **Example** (Iterating keys)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
- * const keys = Array.from(HashMap.keys(map))
- * console.log(keys.sort()) // ["a", "b", "c"]
+ * Array.from(HashMap.keys(map)).sort() // => ["a", "b", "c"]
  * ```
  *
  * @category getters
@@ -314,12 +296,11 @@ export const keys = internal.keys;
  *
  * **Example** (Iterating values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
- * const values = Array.from(HashMap.values(map))
- * console.log(values.sort()) // [1, 2, 3]
+ * Array.from(HashMap.values(map)).sort() // => [1, 2, 3]
  * ```
  *
  * @category getters
@@ -331,7 +312,7 @@ export const values = internal.values;
  *
  * **Example** (Converting values to an array)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const employees = HashMap.make(
@@ -342,15 +323,13 @@ export const values = internal.values;
  *
  * // Extract all employee records
  * const allEmployees = HashMap.toValues(employees)
- * console.log(allEmployees.length) // 3
+ * allEmployees.length // => 3
  *
  * // Calculate total salary
- * const totalSalary = allEmployees.reduce((sum, emp) => sum + emp.salary, 0)
- * console.log(totalSalary) // 260000
+ * allEmployees.reduce((sum, emp) => sum + emp.salary, 0) // => 260000
  *
  * // Filter by department
- * const engineers = allEmployees.filter((emp) => emp.department === "engineering")
- * console.log(engineers.length) // 2
+ * allEmployees.filter((emp) => emp.department === "engineering").length // => 2
  * ```
  *
  * @category getters
@@ -362,7 +341,7 @@ export const toValues = self => Array.from(values(self));
  *
  * **Example** (Iterating entries)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * // Create a configuration map
@@ -377,12 +356,10 @@ export const toValues = self => Array.from(values(self));
  *   .sort(([left], [right]) => left.localeCompare(right))
  *   .map(([key, value]) => `Setting ${key} = ${value}`)
  *
- * console.log(settings)
- * // ["Setting cache.enabled = true", "Setting database.host = localhost", "Setting database.port = 5432"]
+ * settings // => ["Setting cache.enabled = true", "Setting database.host = localhost", "Setting database.port = 5432"]
  *
  * // Convert to array when you need all entries at once
- * const allEntries = Array.from(HashMap.entries(config))
- * console.log(allEntries.length) // 3
+ * Array.from(HashMap.entries(config)).length // => 3
  * ```
  *
  * @category getters
@@ -394,7 +371,7 @@ export const entries = internal.entries;
  *
  * **Example** (Converting entries to an array)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const gameScores = HashMap.make(
@@ -411,11 +388,10 @@ export const entries = internal.entries;
  *   .sort(([, a], [, b]) => b - a)
  *   .map(([player, score], rank) => `${rank + 1}. ${player}: ${score}`)
  *
- * console.log(leaderboard)
- * // ["1. alice: 1250", "2. charlie: 1100", "3. bob: 980"]
+ * leaderboard // => ["1. alice: 1250", "2. charlie: 1100", "3. bob: 980"]
  *
  * // Convert back to HashMap if needed
- * const sortedMap = HashMap.fromIterable(scoreEntries)
+ * HashMap.fromIterable(scoreEntries) // => HashMap.make(["alice", 1250], ["charlie", 1100], ["bob", 980])
  * ```
  *
  * @category getters
@@ -427,14 +403,14 @@ export const toEntries = self => Array.from(entries(self));
  *
  * **Example** (Getting the size)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const emptyMap = HashMap.empty<string, number>()
  * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
  *
- * console.log(HashMap.size(emptyMap)) // 0
- * console.log(HashMap.size(map)) // 3
+ * HashMap.size(emptyMap) // => 0
+ * HashMap.size(map) // => 3
  * ```
  *
  * @category getters
@@ -451,7 +427,7 @@ export const size = internal.size;
  *
  * **Example** (Beginning batch mutation)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1])
@@ -465,8 +441,7 @@ export const size = internal.size;
  * HashMap.remove(mutable, "a")
  *
  * // End mutation to get final immutable result
- * const result = HashMap.endMutation(mutable)
- * console.log(HashMap.size(result)) // 2
+ * HashMap.endMutation(mutable) // => HashMap.make(["b", 2], ["c", 3])
  * ```
  *
  * @category mutations
@@ -478,7 +453,7 @@ export const beginMutation = internal.beginMutation;
  *
  * **Example** (Ending batch mutation)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * // Start with an existing map
@@ -493,11 +468,7 @@ export const beginMutation = internal.beginMutation;
  * HashMap.set(mutable, "w", 40)
  *
  * // End mutation to get final immutable result
- * const final = HashMap.endMutation(mutable)
- *
- * console.log(HashMap.size(final)) // 3
- * console.log(HashMap.has(final, "x")) // false
- * console.log(HashMap.get(final, "z")) // Option.some(30)
+ * HashMap.endMutation(mutable) // => HashMap.make(["y", 20], ["z", 30], ["w", 40])
  * ```
  *
  * @category mutations
@@ -515,7 +486,7 @@ export const endMutation = internal.endMutation;
  *
  * **Example** (Applying batched mutations)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const map1 = HashMap.make(["a", 1])
@@ -523,7 +494,7 @@ export const endMutation = internal.endMutation;
  *   HashMap.set(mutable, "b", 2)
  *   HashMap.set(mutable, "c", 3)
  * })
- * // Returns a new HashMap with mutations applied
+ * map2 // => HashMap.make(["a", 1], ["b", 2], ["c", 3])
  * ```
  *
  * @category mutations
@@ -541,7 +512,7 @@ export const mutate = internal.mutate;
  *
  * **Example** (Updating values with Options)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap, Option } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2])
@@ -551,7 +522,7 @@ export const mutate = internal.mutate;
  *   Option.isSome(option) ? Option.some(option.value + 1) : Option.some(1)
  *
  * const updated = HashMap.modifyAt(map, "a", updateFn)
- * console.log(HashMap.get(updated, "a")) // Option.some(2)
+ * HashMap.get(updated, "a") // => Option.some(2)
  * ```
  *
  * @category transforming
@@ -570,7 +541,7 @@ export const modifyAt = internal.modifyAt;
  *
  * **Example** (Updating values with a hash)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Hash, HashMap, Option } from "effect"
  *
  * // Useful when working with precomputed hashes for performance
@@ -591,7 +562,7 @@ export const modifyAt = internal.modifyAt;
  *   cachedHash,
  *   incrementCounter
  * )
- * console.log(HashMap.get(updated, "downloads")) // Option.some(101)
+ * HashMap.get(updated, "downloads") // => Option.some(101)
  *
  * // Add new metric with precomputed hash
  * const newMetric = "clicks"
@@ -602,7 +573,7 @@ export const modifyAt = internal.modifyAt;
  *   clicksHash,
  *   incrementCounter
  * )
- * console.log(HashMap.get(withClicks, "clicks")) // Option.some(1)
+ * HashMap.get(withClicks, "clicks") // => Option.some(1)
  * ```
  *
  * @category transforming
@@ -614,14 +585,14 @@ export const modifyHash = internal.modifyHash;
  *
  * **Example** (Modifying existing values)
  *
- * ```ts
- * import { HashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { HashMap, Option } from "effect"
  *
  * const map1 = HashMap.make(["a", 1], ["b", 2])
  * const map2 = HashMap.modify(map1, "a", (value) => value * 3)
  *
- * console.log(HashMap.get(map2, "a")) // Option.some(3)
- * console.log(HashMap.get(map2, "b")) // Option.some(2)
+ * HashMap.get(map2, "a") // => Option.some(3)
+ * HashMap.get(map2, "b") // => Option.some(2)
  * ```
  *
  * @category transforming
@@ -638,15 +609,15 @@ export const modify = internal.modify;
  *
  * **Example** (Combining HashMaps)
  *
- * ```ts
- * import { HashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { HashMap, Option } from "effect"
  *
  * const map1 = HashMap.make(["a", 1], ["b", 2])
  * const map2 = HashMap.make(["b", 20], ["c", 3])
  * const union = HashMap.union(map1, map2)
  *
- * console.log(HashMap.size(union)) // 3
- * console.log(HashMap.get(union, "b")) // Option.some(20) - map2 wins
+ * union // => HashMap.make(["a", 1], ["b", 20], ["c", 3])
+ * HashMap.get(union, "b") // => Option.some(20)
  * ```
  *
  * @category combining
@@ -659,15 +630,13 @@ export const union = internal.union;
  *
  * **Example** (Removing a key)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const map1 = HashMap.make(["a", 1], ["b", 2], ["c", 3])
  * const map2 = HashMap.remove(map1, "b")
  *
- * console.log(HashMap.size(map2)) // 2
- * console.log(HashMap.has(map2, "b")) // false
- * console.log(HashMap.has(map2, "a")) // true
+ * map2 // => HashMap.make(["a", 1], ["c", 3])
  * ```
  *
  * @category transforming
@@ -679,15 +648,13 @@ export const remove = internal.remove;
  *
  * **Example** (Removing multiple keys)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const map1 = HashMap.make(["a", 1], ["b", 2], ["c", 3], ["d", 4])
  * const map2 = HashMap.removeMany(map1, ["b", "d"])
  *
- * console.log(HashMap.size(map2)) // 2
- * console.log(HashMap.has(map2, "a")) // true
- * console.log(HashMap.has(map2, "c")) // true
+ * map2 // => HashMap.make(["a", 1], ["c", 3])
  * ```
  *
  * @category transforming
@@ -699,16 +666,15 @@ export const removeMany = internal.removeMany;
  *
  * **Example** (Setting multiple entries)
  *
- * ```ts
- * import { HashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { HashMap, Option } from "effect"
  *
  * const map1 = HashMap.make(["a", 1], ["b", 2])
  * const newEntries = [["c", 3], ["d", 4], ["a", 10]] as const // "a" will be overwritten
  * const map2 = HashMap.setMany(map1, newEntries)
  *
- * console.log(HashMap.size(map2)) // 4
- * console.log(HashMap.get(map2, "a")) // Option.some(10)
- * console.log(HashMap.get(map2, "c")) // Option.some(3)
+ * map2 // => HashMap.make(["a", 10], ["b", 2], ["c", 3], ["d", 4])
+ * HashMap.get(map2, "a") // => Option.some(10)
  * ```
  *
  * @category transforming
@@ -720,14 +686,14 @@ export const setMany = internal.setMany;
  *
  * **Example** (Mapping values)
  *
- * ```ts
- * import { HashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { HashMap, Option } from "effect"
  *
  * const map1 = HashMap.make(["a", 1], ["b", 2], ["c", 3])
  * const map2 = HashMap.map(map1, (value, key) => `${key}:${value * 2}`)
  *
- * console.log(HashMap.get(map2, "a")) // Option.some("a:2")
- * console.log(HashMap.get(map2, "b")) // Option.some("b:4")
+ * HashMap.get(map2, "a") // => Option.some("a:2")
+ * HashMap.get(map2, "b") // => Option.some("b:4")
  * ```
  *
  * @category mapping
@@ -743,8 +709,8 @@ export const map = internal.map;
  *
  * **Example** (Flat mapping values)
  *
- * ```ts
- * import { HashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { HashMap, Option } from "effect"
  *
  * const map1 = HashMap.make(["a", 1], ["b", 2])
  * const map2 = HashMap.flatMap(
@@ -752,9 +718,8 @@ export const map = internal.map;
  *   (value, key) => HashMap.make([key + "1", value], [key + "2", value * 2])
  * )
  *
- * console.log(HashMap.size(map2)) // 4
- * console.log(HashMap.get(map2, "a1")) // Option.some(1)
- * console.log(HashMap.get(map2, "b2")) // Option.some(4)
+ * map2 // => HashMap.make(["a1", 1], ["a2", 2], ["b1", 2], ["b2", 4])
+ * HashMap.get(map2, "b2") // => Option.some(4)
  * ```
  *
  * @category sequencing
@@ -766,7 +731,7 @@ export const flatMap = internal.flatMap;
  *
  * **Example** (Iterating with side effects)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2])
@@ -776,7 +741,7 @@ export const flatMap = internal.flatMap;
  *   collected.push([key, value])
  * })
  *
- * console.log(collected.sort()) // [["a", 1], ["b", 2]]
+ * collected.sort() // => [["a", 1], ["b", 2]]
  * ```
  *
  * @category traversing
@@ -788,13 +753,11 @@ export const forEach = internal.forEach;
  *
  * **Example** (Reducing values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
- * const sum = HashMap.reduce(map, 0, (acc, value) => acc + value)
- *
- * console.log(sum) // 6
+ * HashMap.reduce(map, 0, (acc, value) => acc + value) // => 6
  * ```
  *
  * @category folding
@@ -806,16 +769,13 @@ export const reduce = internal.reduce;
  *
  * **Example** (Filtering entries)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const map1 = HashMap.make(["a", 1], ["b", 2], ["c", 3], ["d", 4])
  * const map2 = HashMap.filter(map1, (value) => value % 2 === 0)
  *
- * console.log(HashMap.size(map2)) // 2
- * console.log(HashMap.has(map2, "b")) // true
- * console.log(HashMap.has(map2, "d")) // true
- * console.log(HashMap.has(map2, "a")) // false
+ * map2 // => HashMap.make(["b", 2], ["d", 4])
  * ```
  *
  * @category filtering
@@ -827,7 +787,7 @@ export const filter = internal.filter;
  *
  * **Example** (Compacting Option values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap, Option } from "effect"
  *
  * const map1 = HashMap.make(
@@ -837,9 +797,8 @@ export const filter = internal.filter;
  * )
  * const map2 = HashMap.compact(map1)
  *
- * console.log(HashMap.size(map2)) // 2
- * console.log(HashMap.get(map2, "a")) // Option.some(1)
- * console.log(HashMap.has(map2, "b")) // false
+ * map2 // => HashMap.make(["a", 1], ["c", 3])
+ * HashMap.get(map2, "a") // => Option.some(1)
  * ```
  *
  * @category filtering
@@ -852,8 +811,8 @@ export const compact = internal.compact;
  *
  * **Example** (Filtering and mapping Results)
  *
- * ```ts
- * import { HashMap, Result } from "effect"
+ * ```ts import.meta.vitest
+ * import { HashMap, Option, Result } from "effect"
  *
  * const map1 = HashMap.make(["a", 1], ["b", 2], ["c", 3], ["d", 4])
  * const map2 = HashMap.filterMap(
@@ -861,9 +820,8 @@ export const compact = internal.compact;
  *   (value) => value % 2 === 0 ? Result.succeed(value * 2) : Result.failVoid
  * )
  *
- * console.log(HashMap.size(map2)) // 2
- * console.log(HashMap.get(map2, "b")) // Option.some(4)
- * console.log(HashMap.get(map2, "d")) // Option.some(8)
+ * map2 // => HashMap.make(["b", 4], ["d", 8])
+ * HashMap.get(map2, "b") // => Option.some(4)
  * ```
  *
  * @category filtering
@@ -876,16 +834,14 @@ export const filterMap = internal.filterMap;
  *
  * **Example** (Finding the first matching entry)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap, Option } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
- * const result = HashMap.findFirst(map, (value, key) => key === "b" && value > 1)
- * console.log(result) // Option.some(["b", 2])
- * console.log(Option.getOrElse(result, () => ["", 0])) // ["b", 2]
+ * HashMap.findFirst(map, (value, key) => key === "b" && value > 1) // => Option.some(["b", 2])
  * ```
  *
- * @category elements
+ * @category searching
  * @since 2.0.0
  */
 export const findFirst = internal.findFirst;
@@ -894,16 +850,16 @@ export const findFirst = internal.findFirst;
  *
  * **Example** (Checking for any matching entry)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
  *
- * console.log(HashMap.some(map, (value) => value > 2)) // true
- * console.log(HashMap.some(map, (value) => value > 5)) // false
+ * HashMap.some(map, (value) => value > 2) // => true
+ * HashMap.some(map, (value) => value > 5) // => false
  * ```
  *
- * @category elements
+ * @category predicates
  * @since 3.13.0
  */
 export const some = internal.some;
@@ -912,16 +868,16 @@ export const some = internal.some;
  *
  * **Example** (Checking all entries)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
  *
- * console.log(HashMap.every(map, (value) => value > 0)) // true
- * console.log(HashMap.every(map, (value) => value > 1)) // false
+ * HashMap.every(map, (value) => value > 0) // => true
+ * HashMap.every(map, (value) => value > 1) // => false
  * ```
  *
- * @category elements
+ * @category predicates
  * @since 3.14.0
  */
 export const every = internal.every;