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

package/src/HashMap.ts

@@ -27,22 +27,21 @@ const TypeId = internal.HashMapTypeId
  *
  * **Example** (Using basic HashMap operations)
  *
- * ```ts
- * import { HashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { HashMap, Option } from "effect"
  *
  * // Create a HashMap
  * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
  *
  * // Access values
- * const valueA = HashMap.get(map, "a") // Option.some(1)
- * const valueD = HashMap.get(map, "d") // Option.none()
+ * HashMap.get(map, "a") // => Option.some(1)
+ * HashMap.get(map, "d") // => Option.none()
  *
  * // Check if key exists
- * console.log(HashMap.has(map, "b")) // true
+ * HashMap.has(map, "b") // => true
  *
  * // Add/update values (returns new HashMap)
- * const updated = HashMap.set(map, "d", 4)
- * console.log(HashMap.size(updated)) // 4
+ * HashMap.set(map, "d", 4) // => HashMap.make(["a", 1], ["b", 2], ["c", 3], ["d", 4])
  * ```
  *
  * @category models
@@ -58,7 +57,7 @@ export interface HashMap<out Key, out Value> extends Iterable<[Key, Value]>, Equ
  *
  * **Example** (Extracting HashMap types)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * // Create a concrete HashMap for type extraction
@@ -82,6 +81,8 @@ export interface HashMap<out Key, out Value> extends Iterable<[Key, Value]>, Equ
  * // Example of extracted types in action
  * const newProduct: Product = { quantity: 10, price: 199 }
  * const updatedInventory = updateInventory("tablet", newProduct)
+ * processEntry(["tablet", newProduct]) // => "tablet: 10 @ $199"
+ * updatedInventory // => HashMap.make(["laptop", { quantity: 5, price: 999 }], ["mouse", { quantity: 20, price: 29 }], ["tablet", newProduct])
  * ```
  *
  * @since 2.0.0
@@ -94,7 +95,7 @@ export declare namespace HashMap {
    *
    * **Example** (Updating values from Options)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashMap, Option } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2])
@@ -104,7 +105,7 @@ export declare namespace HashMap {
    *   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 models
@@ -117,8 +118,8 @@ export declare namespace HashMap {
    *
    * **Example** (Extracting key types)
    *
-   * ```ts
-   * import { HashMap } from "effect"
+   * ```ts import.meta.vitest
+   * import { HashMap, Option } from "effect"
    *
    * // Create a HashMap to extract key type from
    * const userMap = HashMap.make(
@@ -131,7 +132,7 @@ export declare namespace HashMap {
    *
    * // Use the extracted type in functions
    * const getUserById = (id: UserKey) => HashMap.get(userMap, id)
-   * console.log(getUserById("alice")) // Option.some({ name: "Alice", age: 30 })
+   * getUserById("alice") // => Option.some({ name: "Alice", age: 30 })
    * ```
    *
    * @category utility types
@@ -144,8 +145,8 @@ export declare namespace HashMap {
    *
    * **Example** (Extracting value types)
    *
-   * ```ts
-   * import { HashMap } from "effect"
+   * ```ts import.meta.vitest
+   * import { HashMap, Option } from "effect"
    *
    * // Create a HashMap with user data
    * const userMap = HashMap.make(
@@ -161,8 +162,9 @@ export declare namespace HashMap {
    *   return user.active ? `${user.name} (active)` : `${user.name} (inactive)`
    * }
    *
-   * const alice = HashMap.get(userMap, "alice")
-   * // alice has type Option<User> thanks to type extraction
+   * // The lookup has type Option<User> thanks to type extraction
+   * HashMap.get(userMap, "alice") // => Option.some({ name: "Alice", age: 30, active: true })
+   * processUser({ name: "Alice", age: 30, active: true }) // => "Alice (active)"
    * ```
    *
    * @category utility types
@@ -175,7 +177,7 @@ export declare namespace HashMap {
    *
    * **Example** (Extracting entry types)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashMap } from "effect"
    *
    * // Create a product catalog HashMap
@@ -194,7 +196,7 @@ export declare namespace HashMap {
    *
    * // Convert to entries, process, and sort for deterministic output
    * const descriptions = HashMap.toEntries(catalog).map(processEntry).sort()
-   * console.log(descriptions) // ["book: $29 (education)", "laptop: $999 (electronics)"]
+   * descriptions // => ["book: $29 (education)", "laptop: $999 (electronics)"]
    * ```
    *
    * @category utility types
@@ -208,18 +210,18 @@ export declare namespace HashMap {
  *
  * **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: {
@@ -228,18 +230,18 @@ export const isHashMap: {
    *
    * **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
    */
   <K, V>(u: Iterable<readonly [K, V]>): u is HashMap<K, V>
@@ -248,18 +250,18 @@ export const isHashMap: {
    *
    * **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
    */
   (u: unknown): u is HashMap<unknown, unknown>
@@ -270,12 +272,10 @@ export const 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
@@ -288,12 +288,10 @@ export const empty: <K = never, V = never>() => HashMap<K, V> = 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
@@ -311,13 +309,11 @@ export const make: <Entries extends ReadonlyArray<readonly [any, any]>>(
  *
  * **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
@@ -330,17 +326,17 @@ export const fromIterable: <K, V>(entries: Iterable<readonly [K, V]>) => HashMap
  *
  * **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: <K, V>(self: HashMap<K, V>) => boolean = internal.isEmpty
@@ -351,20 +347,19 @@ export const isEmpty: <K, V>(self: HashMap<K, V>) => boolean = 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: {
@@ -374,20 +369,19 @@ export const get: {
    *
    * **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
    */
   <K1 extends K, K>(key: K1): <V>(self: HashMap<K, V>) => Option<V>
@@ -397,20 +391,19 @@ export const get: {
    *
    * **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
    */
   <K1 extends K, K, V>(self: HashMap<K, V>, key: K1): Option<V>
@@ -421,8 +414,8 @@ export const 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(
@@ -435,15 +428,13 @@ export const 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: {
@@ -452,8 +443,8 @@ export const getHash: {
    *
    * **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(
@@ -466,15 +457,13 @@ export const getHash: {
    * 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
    */
   <K1 extends K, K>(key: K1, hash: number): <V>(self: HashMap<K, V>) => Option<V>
@@ -483,8 +472,8 @@ export const getHash: {
    *
    * **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(
@@ -497,15 +486,13 @@ export const getHash: {
    * 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
    */
   <K1 extends K, K, V>(self: HashMap<K, V>, key: K1, hash: number): Option<V>
@@ -527,7 +514,7 @@ export const getHash: {
  *
  * **Example** (Unsafely looking up values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap, Option } from "effect"
  *
  * const config = HashMap.make(
@@ -537,14 +524,10 @@ export const 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"
@@ -570,7 +553,7 @@ export const getUnsafe: {
    *
    * **Example** (Unsafely looking up values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashMap, Option } from "effect"
    *
    * const config = HashMap.make(
@@ -580,14 +563,10 @@ export const getUnsafe: {
    * )
    *
    * // 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"
@@ -613,7 +592,7 @@ export const getUnsafe: {
    *
    * **Example** (Unsafely looking up values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashMap, Option } from "effect"
    *
    * const config = HashMap.make(
@@ -623,14 +602,10 @@ export const getUnsafe: {
    * )
    *
    * // 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"
@@ -647,20 +622,19 @@ export const 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: {
@@ -669,20 +643,19 @@ export const has: {
    *
    * **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
    */
   <K1 extends K, K>(key: K1): <K, V>(self: HashMap<K, V>) => boolean
@@ -691,20 +664,19 @@ export const has: {
    *
    * **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
    */
   <K1 extends K, K, V>(self: HashMap<K, V>, key: K1): boolean
@@ -716,7 +688,7 @@ export const has: {
  *
  * **Example** (Checking keys with a hash)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Hash, HashMap } from "effect"
  *
  * // Create a map with case-sensitive keys
@@ -727,17 +699,17 @@ export const 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: {
@@ -747,7 +719,7 @@ export const hasHash: {
    *
    * **Example** (Checking keys with a hash)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Hash, HashMap } from "effect"
    *
    * // Create a map with case-sensitive keys
@@ -758,17 +730,17 @@ export const hasHash: {
    *
    * // 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
    */
   <K1 extends K, K>(key: K1, hash: number): <V>(self: HashMap<K, V>) => boolean
@@ -778,7 +750,7 @@ export const hasHash: {
    *
    * **Example** (Checking keys with a hash)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Hash, HashMap } from "effect"
    *
    * // Create a map with case-sensitive keys
@@ -789,17 +761,17 @@ export const hasHash: {
    *
    * // 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
    */
   <K1 extends K, K, V>(self: HashMap<K, V>, key: K1, hash: number): boolean
@@ -810,15 +782,15 @@ export const 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: {
@@ -827,15 +799,15 @@ export const hasBy: {
    *
    * **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
    */
   <K, V>(predicate: (value: NoInfer<V>, key: NoInfer<K>) => boolean): (self: HashMap<K, V>) => boolean
@@ -844,15 +816,15 @@ export const hasBy: {
    *
    * **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
    */
   <K, V>(
@@ -867,17 +839,14 @@ export const 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
@@ -890,17 +859,14 @@ export const set: {
    *
    * **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
@@ -913,17 +879,14 @@ export const set: {
    *
    * **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
@@ -937,12 +900,11 @@ export const 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
@@ -955,12 +917,11 @@ export const keys: <K, V>(self: HashMap<K, V>) => IterableIterator<K> = internal
  *
  * **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
@@ -973,7 +934,7 @@ export const values: <K, V>(self: HashMap<K, V>) => IterableIterator<V> = intern
  *
  * **Example** (Converting values to an array)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const employees = HashMap.make(
@@ -984,15 +945,13 @@ export const values: <K, V>(self: HashMap<K, V>) => IterableIterator<V> = intern
  *
  * // 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
@@ -1005,7 +964,7 @@ export const toValues = <K, V>(self: HashMap<K, V>): Array<V> => Array.from(valu
  *
  * **Example** (Iterating entries)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * // Create a configuration map
@@ -1020,12 +979,10 @@ export const toValues = <K, V>(self: HashMap<K, V>): Array<V> => Array.from(valu
  *   .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
@@ -1038,7 +995,7 @@ export const entries: <K, V>(self: HashMap<K, V>) => IterableIterator<[K, V]> =
  *
  * **Example** (Converting entries to an array)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const gameScores = HashMap.make(
@@ -1055,11 +1012,10 @@ export const entries: <K, V>(self: HashMap<K, V>) => IterableIterator<[K, V]> =
  *   .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
@@ -1072,14 +1028,14 @@ export const toEntries = <K, V>(self: HashMap<K, V>): Array<[K, V]> => Array.fro
  *
  * **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
@@ -1097,7 +1053,7 @@ export const size: <K, V>(self: HashMap<K, V>) => number = internal.size
  *
  * **Example** (Beginning batch mutation)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1])
@@ -1111,8 +1067,7 @@ export const size: <K, V>(self: HashMap<K, V>) => number = 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
@@ -1125,7 +1080,7 @@ export const beginMutation: <K, V>(self: HashMap<K, V>) => HashMap<K, V> = inter
  *
  * **Example** (Ending batch mutation)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * // Start with an existing map
@@ -1140,11 +1095,7 @@ export const beginMutation: <K, V>(self: HashMap<K, V>) => HashMap<K, V> = inter
  * 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
@@ -1163,7 +1114,7 @@ export const endMutation: <K, V>(self: HashMap<K, V>) => HashMap<K, V> = interna
  *
  * **Example** (Applying batched mutations)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const map1 = HashMap.make(["a", 1])
@@ -1171,7 +1122,7 @@ export const endMutation: <K, V>(self: HashMap<K, V>) => HashMap<K, V> = interna
  *   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
@@ -1189,7 +1140,7 @@ export const mutate: {
    *
    * **Example** (Applying batched mutations)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1])
@@ -1197,7 +1148,7 @@ export const mutate: {
    *   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
@@ -1215,7 +1166,7 @@ export const mutate: {
    *
    * **Example** (Applying batched mutations)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1])
@@ -1223,7 +1174,7 @@ export const mutate: {
    *   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
@@ -1243,7 +1194,7 @@ export const mutate: {
  *
  * **Example** (Updating values with Options)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap, Option } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2])
@@ -1253,7 +1204,7 @@ export const 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
@@ -1271,7 +1222,7 @@ export const modifyAt: {
    *
    * **Example** (Updating values with Options)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashMap, Option } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2])
@@ -1281,7 +1232,7 @@ export const modifyAt: {
    *   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
@@ -1299,7 +1250,7 @@ export const modifyAt: {
    *
    * **Example** (Updating values with Options)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashMap, Option } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2])
@@ -1309,7 +1260,7 @@ export const modifyAt: {
    *   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
@@ -1330,7 +1281,7 @@ export const 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
@@ -1351,7 +1302,7 @@ export const 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"
@@ -1362,7 +1313,7 @@ export const modifyAt: {
  *   clicksHash,
  *   incrementCounter
  * )
- * console.log(HashMap.get(withClicks, "clicks")) // Option.some(1)
+ * HashMap.get(withClicks, "clicks") // => Option.some(1)
  * ```
  *
  * @category transforming
@@ -1381,7 +1332,7 @@ export const modifyHash: {
    *
    * **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
@@ -1402,7 +1353,7 @@ export const modifyHash: {
    *   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"
@@ -1413,7 +1364,7 @@ export const modifyHash: {
    *   clicksHash,
    *   incrementCounter
    * )
-   * console.log(HashMap.get(withClicks, "clicks")) // Option.some(1)
+   * HashMap.get(withClicks, "clicks") // => Option.some(1)
    * ```
    *
    * @category transforming
@@ -1432,7 +1383,7 @@ export const modifyHash: {
    *
    * **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
@@ -1453,7 +1404,7 @@ export const modifyHash: {
    *   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"
@@ -1464,7 +1415,7 @@ export const modifyHash: {
    *   clicksHash,
    *   incrementCounter
    * )
-   * console.log(HashMap.get(withClicks, "clicks")) // Option.some(1)
+   * HashMap.get(withClicks, "clicks") // => Option.some(1)
    * ```
    *
    * @category transforming
@@ -1478,14 +1429,14 @@ export const 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
@@ -1497,14 +1448,14 @@ export const modify: {
    *
    * **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
@@ -1516,14 +1467,14 @@ export const modify: {
    *
    * **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
@@ -1542,15 +1493,15 @@ export const 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
@@ -1567,15 +1518,15 @@ export const union: {
    *
    * **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
@@ -1592,15 +1543,15 @@ export const union: {
    *
    * **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
@@ -1615,15 +1566,13 @@ export const 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
@@ -1636,15 +1585,13 @@ export const remove: {
    *
    * **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
@@ -1657,15 +1604,13 @@ export const remove: {
    *
    * **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
@@ -1679,15 +1624,13 @@ export const 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
@@ -1699,15 +1642,13 @@ export const removeMany: {
    *
    * **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
@@ -1719,15 +1660,13 @@ export const removeMany: {
    *
    * **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
@@ -1741,16 +1680,15 @@ export const 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
@@ -1762,16 +1700,15 @@ export const setMany: {
    *
    * **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
@@ -1783,16 +1720,15 @@ export const setMany: {
    *
    * **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
@@ -1806,14 +1742,14 @@ export const 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
@@ -1825,14 +1761,14 @@ export const map: {
    *
    * **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
@@ -1844,14 +1780,14 @@ export const map: {
    *
    * **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
@@ -1869,8 +1805,8 @@ export const 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(
@@ -1878,9 +1814,8 @@ export const 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
@@ -1896,8 +1831,8 @@ export const flatMap: {
    *
    * **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(
@@ -1905,9 +1840,8 @@ export const flatMap: {
    *   (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
@@ -1923,8 +1857,8 @@ export const flatMap: {
    *
    * **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(
@@ -1932,9 +1866,8 @@ export const flatMap: {
    *   (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
@@ -1948,7 +1881,7 @@ export const flatMap: {
  *
  * **Example** (Iterating with side effects)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2])
@@ -1958,7 +1891,7 @@ export const flatMap: {
  *   collected.push([key, value])
  * })
  *
- * console.log(collected.sort()) // [["a", 1], ["b", 2]]
+ * collected.sort() // => [["a", 1], ["b", 2]]
  * ```
  *
  * @category traversing
@@ -1970,7 +1903,7 @@ export const forEach: {
    *
    * **Example** (Iterating with side effects)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashMap } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2])
@@ -1980,7 +1913,7 @@ export const forEach: {
    *   collected.push([key, value])
    * })
    *
-   * console.log(collected.sort()) // [["a", 1], ["b", 2]]
+   * collected.sort() // => [["a", 1], ["b", 2]]
    * ```
    *
    * @category traversing
@@ -1992,7 +1925,7 @@ export const forEach: {
    *
    * **Example** (Iterating with side effects)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashMap } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2])
@@ -2002,7 +1935,7 @@ export const forEach: {
    *   collected.push([key, value])
    * })
    *
-   * console.log(collected.sort()) // [["a", 1], ["b", 2]]
+   * collected.sort() // => [["a", 1], ["b", 2]]
    * ```
    *
    * @category traversing
@@ -2016,13 +1949,11 @@ export const 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
@@ -2034,13 +1965,11 @@ export const reduce: {
    *
    * **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
@@ -2052,13 +1981,11 @@ export const reduce: {
    *
    * **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
@@ -2072,16 +1999,13 @@ export const 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
@@ -2093,16 +2017,13 @@ export const filter: {
    *
    * **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
@@ -2114,16 +2035,13 @@ export const filter: {
    *
    * **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
@@ -2137,7 +2055,7 @@ export const filter: {
  *
  * **Example** (Compacting Option values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashMap, Option } from "effect"
  *
  * const map1 = HashMap.make(
@@ -2147,9 +2065,8 @@ export const 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
@@ -2163,8 +2080,8 @@ export const compact: <K, A>(self: HashMap<K, Option<A>>) => HashMap<K, A> = int
  *
  * **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(
@@ -2172,9 +2089,8 @@ export const compact: <K, A>(self: HashMap<K, Option<A>>) => HashMap<K, A> = int
  *   (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
@@ -2187,8 +2103,8 @@ export const filterMap: {
    *
    * **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(
@@ -2196,9 +2112,8 @@ export const filterMap: {
    *   (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
@@ -2211,8 +2126,8 @@ export const filterMap: {
    *
    * **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(
@@ -2220,9 +2135,8 @@ export const filterMap: {
    *   (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
@@ -2237,16 +2151,14 @@ export const 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: {
@@ -2256,16 +2168,14 @@ export const findFirst: {
    *
    * **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
    */
   <K, A>(predicate: (a: NoInfer<A>, k: K) => boolean): (self: HashMap<K, A>) => Option<[K, A]>
@@ -2275,16 +2185,14 @@ export const findFirst: {
    *
    * **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
    */
   <K, A>(self: HashMap<K, A>, predicate: (a: A, k: K) => boolean): Option<[K, A]>
@@ -2295,16 +2203,16 @@ export const 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: {
@@ -2313,16 +2221,16 @@ export const some: {
    *
    * **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
    */
   <K, A>(predicate: (a: NoInfer<A>, k: K) => boolean): (self: HashMap<K, A>) => boolean
@@ -2331,16 +2239,16 @@ export const some: {
    *
    * **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
    */
   <K, A>(self: HashMap<K, A>, predicate: (a: A, k: K) => boolean): boolean
@@ -2351,16 +2259,16 @@ export const 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: {
@@ -2369,16 +2277,16 @@ export const every: {
    *
    * **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
    */
   <K, A>(predicate: (a: NoInfer<A>, k: K) => boolean): (self: HashMap<K, A>) => boolean
@@ -2387,16 +2295,16 @@ export const every: {
    *
    * **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
    */
   <K, A>(self: HashMap<K, A>, predicate: (a: A, k: K) => boolean): boolean