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

package/src/MutableHashMap.ts

@@ -39,7 +39,7 @@ const TypeId = "~effect/collections/MutableHashMap"
  *
  * **Example** (Using a mutable hash map)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { MutableHashMap } from "effect"
  *
  * // Create a mutable hash map with string keys and number values
@@ -50,17 +50,7 @@ const TypeId = "~effect/collections/MutableHashMap"
  * MutableHashMap.set(map, "count", 42)
  * MutableHashMap.set(map, "total", 100)
  *
- * // Use as iterable
- * for (const [key, value] of map) {
- *   console.log(`${key}: ${value}`)
- * }
- * // Output:
- * // count: 42
- * // total: 100
- *
- * // Convert to array
- * const entries = Array.from(map)
- * console.log(entries) // [["count", 42], ["total", 100]]
+ * Array.from(map) // => [["count", 42], ["total", 100]]
  * ```
  *
  * @see {@link empty} for creating an empty mutable hash map
@@ -93,7 +83,7 @@ export interface MutableHashMap<out K, out V> extends Iterable<[K, V]>, Pipeable
  *
  * @see {@link MutableHashMap} for the mutable hash map interface
  *
- * @category refinements
+ * @category guards
  * @since 4.0.0
  */
 export const isMutableHashMap = <K, V>(value: unknown): value is MutableHashMap<K, V> => hasProperty(value, TypeId)
@@ -133,7 +123,7 @@ const MutableHashMapProto: Omit<MutableHashMap<unknown, unknown>, "backing" | "b
  *
  * **Example** (Creating an empty map)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { MutableHashMap } from "effect"
  *
  * const map = MutableHashMap.empty<string, number>()
@@ -142,7 +132,7 @@ const MutableHashMapProto: Omit<MutableHashMap<unknown, unknown>, "backing" | "b
  * MutableHashMap.set(map, "key1", 42)
  * MutableHashMap.set(map, "key2", 100)
  *
- * console.log(MutableHashMap.size(map)) // 2
+ * MutableHashMap.size(map) // => 2
  * ```
  *
  * @see {@link make} for creating a map from explicit entries
@@ -167,8 +157,8 @@ export const empty = <K, V>(): MutableHashMap<K, V> => {
  *
  * **Example** (Creating a map from entries)
  *
- * ```ts
- * import { MutableHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { MutableHashMap, Option } from "effect"
  *
  * const map = MutableHashMap.make(
  *   ["key1", 42],
@@ -176,8 +166,8 @@ export const empty = <K, V>(): MutableHashMap<K, V> => {
  *   ["key3", 200]
  * )
  *
- * console.log(MutableHashMap.get(map, "key1")) // Some(42)
- * console.log(MutableHashMap.size(map)) // 3
+ * MutableHashMap.get(map, "key1") // => Option.some(42)
+ * MutableHashMap.size(map) // => 3
  * ```
  *
  * @see {@link empty} for creating an empty map
@@ -202,8 +192,8 @@ export const make: <Entries extends Array<readonly [any, any]>>(
  *
  * **Example** (Creating a map from an iterable)
  *
- * ```ts
- * import { MutableHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { MutableHashMap, Option } from "effect"
  *
  * const entries = [
  *   ["apple", 1],
@@ -213,12 +203,12 @@ export const make: <Entries extends Array<readonly [any, any]>>(
  *
  * const map = MutableHashMap.fromIterable(entries)
  *
- * console.log(MutableHashMap.get(map, "banana")) // Some(2)
- * console.log(MutableHashMap.size(map)) // 3
+ * MutableHashMap.get(map, "banana") // => Option.some(2)
+ * MutableHashMap.size(map) // => 3
  *
  * // Works with any iterable
  * const fromMap = MutableHashMap.fromIterable(new Map([["x", 10], ["y", 20]]))
- * console.log(MutableHashMap.get(fromMap, "x")) // Some(10)
+ * MutableHashMap.get(fromMap, "x") // => Option.some(10)
  * ```
  *
  * @see {@link make} for creating a map from explicit entries
@@ -249,23 +239,22 @@ export const fromIterable = <K, V>(entries: Iterable<readonly [K, V]>): MutableH
  *
  * **Example** (Getting a value)
  *
- * ```ts
- * import { MutableHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { MutableHashMap, Option } from "effect"
  *
  * const map = MutableHashMap.make(["key1", 42], ["key2", 100])
  *
- * console.log(MutableHashMap.get(map, "key1")) // Some(42)
- * console.log(MutableHashMap.get(map, "key3")) // None
+ * MutableHashMap.get(map, "key1") // => Option.some(42)
+ * MutableHashMap.get(map, "key3") // => Option.none()
  *
  * // Pipe-able version
- * const getValue = MutableHashMap.get("key1")
- * console.log(getValue(map)) // Some(42)
+ * MutableHashMap.get("key1")(map) // => Option.some(42)
  * ```
  *
  * @see {@link has} for checking only whether a key is present
  * @see {@link set} for inserting or replacing a value by key
  *
- * @category elements
+ * @category getters
  * @since 2.0.0
  */
 export const get: {
@@ -283,23 +272,22 @@ export const get: {
    *
    * **Example** (Getting a value)
    *
-   * ```ts
-   * import { MutableHashMap } from "effect"
+   * ```ts import.meta.vitest
+   * import { MutableHashMap, Option } from "effect"
    *
    * const map = MutableHashMap.make(["key1", 42], ["key2", 100])
    *
-   * console.log(MutableHashMap.get(map, "key1")) // Some(42)
-   * console.log(MutableHashMap.get(map, "key3")) // None
+   * MutableHashMap.get(map, "key1") // => Option.some(42)
+   * MutableHashMap.get(map, "key3") // => Option.none()
    *
    * // Pipe-able version
-   * const getValue = MutableHashMap.get("key1")
-   * console.log(getValue(map)) // Some(42)
+   * MutableHashMap.get("key1")(map) // => Option.some(42)
    * ```
    *
    * @see {@link has} for checking only whether a key is present
    * @see {@link set} for inserting or replacing a value by key
    *
-   * @category elements
+   * @category getters
    * @since 2.0.0
    */
   <K>(key: K): <V>(self: MutableHashMap<K, V>) => Option.Option<V>
@@ -317,23 +305,22 @@ export const get: {
    *
    * **Example** (Getting a value)
    *
-   * ```ts
-   * import { MutableHashMap } from "effect"
+   * ```ts import.meta.vitest
+   * import { MutableHashMap, Option } from "effect"
    *
    * const map = MutableHashMap.make(["key1", 42], ["key2", 100])
    *
-   * console.log(MutableHashMap.get(map, "key1")) // Some(42)
-   * console.log(MutableHashMap.get(map, "key3")) // None
+   * MutableHashMap.get(map, "key1") // => Option.some(42)
+   * MutableHashMap.get(map, "key3") // => Option.none()
    *
    * // Pipe-able version
-   * const getValue = MutableHashMap.get("key1")
-   * console.log(getValue(map)) // Some(42)
+   * MutableHashMap.get("key1")(map) // => Option.some(42)
    * ```
    *
    * @see {@link has} for checking only whether a key is present
    * @see {@link set} for inserting or replacing a value by key
    *
-   * @category elements
+   * @category getters
    * @since 2.0.0
    */
   <K, V>(self: MutableHashMap<K, V>, key: K): Option.Option<V>
@@ -352,23 +339,22 @@ export const get: {
    *
    * **Example** (Getting a value)
    *
-   * ```ts
-   * import { MutableHashMap } from "effect"
+   * ```ts import.meta.vitest
+   * import { MutableHashMap, Option } from "effect"
    *
    * const map = MutableHashMap.make(["key1", 42], ["key2", 100])
    *
-   * console.log(MutableHashMap.get(map, "key1")) // Some(42)
-   * console.log(MutableHashMap.get(map, "key3")) // None
+   * MutableHashMap.get(map, "key1") // => Option.some(42)
+   * MutableHashMap.get(map, "key3") // => Option.none()
    *
    * // Pipe-able version
-   * const getValue = MutableHashMap.get("key1")
-   * console.log(getValue(map)) // Some(42)
+   * MutableHashMap.get("key1")(map) // => Option.some(42)
    * ```
    *
    * @see {@link has} for checking only whether a key is present
    * @see {@link set} for inserting or replacing a value by key
    *
-   * @category elements
+   * @category getters
    * @since 2.0.0
    */
   <K>(key: K) => <V>(self: MutableHashMap<K, V>) => Option.Option<V>,
@@ -386,23 +372,22 @@ export const get: {
    *
    * **Example** (Getting a value)
    *
-   * ```ts
-   * import { MutableHashMap } from "effect"
+   * ```ts import.meta.vitest
+   * import { MutableHashMap, Option } from "effect"
    *
    * const map = MutableHashMap.make(["key1", 42], ["key2", 100])
    *
-   * console.log(MutableHashMap.get(map, "key1")) // Some(42)
-   * console.log(MutableHashMap.get(map, "key3")) // None
+   * MutableHashMap.get(map, "key1") // => Option.some(42)
+   * MutableHashMap.get(map, "key3") // => Option.none()
    *
    * // Pipe-able version
-   * const getValue = MutableHashMap.get("key1")
-   * console.log(getValue(map)) // Some(42)
+   * MutableHashMap.get("key1")(map) // => Option.some(42)
    * ```
    *
    * @see {@link has} for checking only whether a key is present
    * @see {@link set} for inserting or replacing a value by key
    *
-   * @category elements
+   * @category getters
    * @since 2.0.0
    */
   <K, V>(self: MutableHashMap<K, V>, key: K) => Option.Option<V>
@@ -436,7 +421,7 @@ const isSimpleKey = (u: unknown): boolean => typeof u !== "object" && typeof u !
  *
  * **Example** (Reading keys)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { MutableHashMap } from "effect"
  *
  * const map = MutableHashMap.make(
@@ -445,17 +430,13 @@ const isSimpleKey = (u: unknown): boolean => typeof u !== "object" && typeof u !
  *   ["cherry", 3]
  * )
  *
- * const allKeys = Array.from(MutableHashMap.keys(map))
- * console.log(allKeys) // ["apple", "banana", "cherry"]
- *
- * // Useful for iteration or validation
- * const hasRequiredKeys = allKeys.includes("apple") && allKeys.includes("banana")
+ * Array.from(MutableHashMap.keys(map)) // => ["apple", "banana", "cherry"]
  * ```
  *
  * @see {@link values} for iterating over stored values
  * @see {@link has} for checking one key without iterating
  *
- * @category elements
+ * @category getters
  * @since 3.8.0
  */
 export const keys = <K, V>(self: MutableHashMap<K, V>): Iterable<K> => self.backing.keys()
@@ -469,7 +450,7 @@ export const keys = <K, V>(self: MutableHashMap<K, V>): Iterable<K> => self.back
  *
  * **Example** (Reading values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { MutableHashMap } from "effect"
  *
  * const map = MutableHashMap.make(
@@ -478,21 +459,18 @@ export const keys = <K, V>(self: MutableHashMap<K, V>): Iterable<K> => self.back
  *   ["cherry", 3]
  * )
  *
- * const allValues = Array.from(MutableHashMap.values(map))
- * console.log(allValues) // [1, 2, 3]
+ * const allValues = Array.from(MutableHashMap.values(map)) // => [1, 2, 3]
  *
  * // Useful for calculations
- * const total = allValues.reduce((sum, value) => sum + value, 0)
- * console.log(total) // 6
+ * allValues.reduce((sum, value) => sum + value, 0) // => 6
  *
  * // Filter values
- * const largeValues = allValues.filter((value) => value > 1)
- * console.log(largeValues) // [2, 3]
+ * allValues.filter((value) => value > 1) // => [2, 3]
  * ```
  *
  * @see {@link keys} for iterating over stored keys
  *
- * @category elements
+ * @category getters
  * @since 3.8.0
  */
 export const values = <K, V>(self: MutableHashMap<K, V>): Iterable<V> => self.backing.values()
@@ -522,22 +500,21 @@ const getFromBucket = <K, V>(
  *
  * **Example** (Checking for a key)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { MutableHashMap } from "effect"
  *
  * const map = MutableHashMap.make(["key1", 42], ["key2", 100])
  *
- * console.log(MutableHashMap.has(map, "key1")) // true
- * console.log(MutableHashMap.has(map, "key3")) // false
+ * MutableHashMap.has(map, "key1") // => true
+ * MutableHashMap.has(map, "key3") // => false
  *
  * // Pipe-able version
- * const hasKey = MutableHashMap.has("key1")
- * console.log(hasKey(map)) // true
+ * MutableHashMap.has("key1")(map) // => true
  * ```
  *
  * @see {@link get} for reading the value as an `Option`
  *
- * @category elements
+ * @category predicates
  * @since 2.0.0
  */
 export const has: {
@@ -551,22 +528,21 @@ export const has: {
    *
    * **Example** (Checking for a key)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { MutableHashMap } from "effect"
    *
    * const map = MutableHashMap.make(["key1", 42], ["key2", 100])
    *
-   * console.log(MutableHashMap.has(map, "key1")) // true
-   * console.log(MutableHashMap.has(map, "key3")) // false
+   * MutableHashMap.has(map, "key1") // => true
+   * MutableHashMap.has(map, "key3") // => false
    *
    * // Pipe-able version
-   * const hasKey = MutableHashMap.has("key1")
-   * console.log(hasKey(map)) // true
+   * MutableHashMap.has("key1")(map) // => true
    * ```
    *
    * @see {@link get} for reading the value as an `Option`
    *
-   * @category elements
+   * @category predicates
    * @since 2.0.0
    */
   <K>(key: K): <V>(self: MutableHashMap<K, V>) => boolean
@@ -580,22 +556,21 @@ export const has: {
    *
    * **Example** (Checking for a key)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { MutableHashMap } from "effect"
    *
    * const map = MutableHashMap.make(["key1", 42], ["key2", 100])
    *
-   * console.log(MutableHashMap.has(map, "key1")) // true
-   * console.log(MutableHashMap.has(map, "key3")) // false
+   * MutableHashMap.has(map, "key1") // => true
+   * MutableHashMap.has(map, "key3") // => false
    *
    * // Pipe-able version
-   * const hasKey = MutableHashMap.has("key1")
-   * console.log(hasKey(map)) // true
+   * MutableHashMap.has("key1")(map) // => true
    * ```
    *
    * @see {@link get} for reading the value as an `Option`
    *
-   * @category elements
+   * @category predicates
    * @since 2.0.0
    */
   <K, V>(self: MutableHashMap<K, V>, key: K): boolean
@@ -610,22 +585,21 @@ export const has: {
    *
    * **Example** (Checking for a key)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { MutableHashMap } from "effect"
    *
    * const map = MutableHashMap.make(["key1", 42], ["key2", 100])
    *
-   * console.log(MutableHashMap.has(map, "key1")) // true
-   * console.log(MutableHashMap.has(map, "key3")) // false
+   * MutableHashMap.has(map, "key1") // => true
+   * MutableHashMap.has(map, "key3") // => false
    *
    * // Pipe-able version
-   * const hasKey = MutableHashMap.has("key1")
-   * console.log(hasKey(map)) // true
+   * MutableHashMap.has("key1")(map) // => true
    * ```
    *
    * @see {@link get} for reading the value as an `Option`
    *
-   * @category elements
+   * @category predicates
    * @since 2.0.0
    */
   <K>(key: K) => <V>(self: MutableHashMap<K, V>) => boolean,
@@ -639,22 +613,21 @@ export const has: {
    *
    * **Example** (Checking for a key)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { MutableHashMap } from "effect"
    *
    * const map = MutableHashMap.make(["key1", 42], ["key2", 100])
    *
-   * console.log(MutableHashMap.has(map, "key1")) // true
-   * console.log(MutableHashMap.has(map, "key3")) // false
+   * MutableHashMap.has(map, "key1") // => true
+   * MutableHashMap.has(map, "key3") // => false
    *
    * // Pipe-able version
-   * const hasKey = MutableHashMap.has("key1")
-   * console.log(hasKey(map)) // true
+   * MutableHashMap.has("key1")(map) // => true
    * ```
    *
    * @see {@link get} for reading the value as an `Option`
    *
-   * @category elements
+   * @category predicates
    * @since 2.0.0
    */
   <K, V>(self: MutableHashMap<K, V>, key: K) => boolean
@@ -671,8 +644,8 @@ export const has: {
  *
  * **Example** (Setting key-value pairs)
  *
- * ```ts
- * import { MutableHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { MutableHashMap, Option } from "effect"
  *
  * const map = MutableHashMap.empty<string, number>()
  *
@@ -680,17 +653,16 @@ export const has: {
  * MutableHashMap.set(map, "key1", 42)
  * MutableHashMap.set(map, "key2", 100)
  *
- * console.log(MutableHashMap.get(map, "key1")) // Some(42)
- * console.log(MutableHashMap.size(map)) // 2
+ * MutableHashMap.get(map, "key1") // => Option.some(42)
+ * MutableHashMap.size(map) // => 2
  *
  * // Update existing entry
  * MutableHashMap.set(map, "key1", 999)
- * console.log(MutableHashMap.get(map, "key1")) // Some(999)
+ * MutableHashMap.get(map, "key1") // => Option.some(999)
  *
  * // Pipe-able version
- * const setKey = MutableHashMap.set("key3", 300)
- * setKey(map)
- * console.log(MutableHashMap.size(map)) // 3
+ * MutableHashMap.set("key3", 300)(map)
+ * MutableHashMap.size(map) // => 3
  * ```
  *
  * @see {@link modify} for updating an existing value with a function
@@ -712,8 +684,8 @@ export const set: {
    *
    * **Example** (Setting key-value pairs)
    *
-   * ```ts
-   * import { MutableHashMap } from "effect"
+   * ```ts import.meta.vitest
+   * import { MutableHashMap, Option } from "effect"
    *
    * const map = MutableHashMap.empty<string, number>()
    *
@@ -721,17 +693,16 @@ export const set: {
    * MutableHashMap.set(map, "key1", 42)
    * MutableHashMap.set(map, "key2", 100)
    *
-   * console.log(MutableHashMap.get(map, "key1")) // Some(42)
-   * console.log(MutableHashMap.size(map)) // 2
+   * MutableHashMap.get(map, "key1") // => Option.some(42)
+   * MutableHashMap.size(map) // => 2
    *
    * // Update existing entry
    * MutableHashMap.set(map, "key1", 999)
-   * console.log(MutableHashMap.get(map, "key1")) // Some(999)
+   * MutableHashMap.get(map, "key1") // => Option.some(999)
    *
    * // Pipe-able version
-   * const setKey = MutableHashMap.set("key3", 300)
-   * setKey(map)
-   * console.log(MutableHashMap.size(map)) // 3
+   * MutableHashMap.set("key3", 300)(map)
+   * MutableHashMap.size(map) // => 3
    * ```
    *
    * @see {@link modify} for updating an existing value with a function
@@ -753,8 +724,8 @@ export const set: {
    *
    * **Example** (Setting key-value pairs)
    *
-   * ```ts
-   * import { MutableHashMap } from "effect"
+   * ```ts import.meta.vitest
+   * import { MutableHashMap, Option } from "effect"
    *
    * const map = MutableHashMap.empty<string, number>()
    *
@@ -762,17 +733,16 @@ export const set: {
    * MutableHashMap.set(map, "key1", 42)
    * MutableHashMap.set(map, "key2", 100)
    *
-   * console.log(MutableHashMap.get(map, "key1")) // Some(42)
-   * console.log(MutableHashMap.size(map)) // 2
+   * MutableHashMap.get(map, "key1") // => Option.some(42)
+   * MutableHashMap.size(map) // => 2
    *
    * // Update existing entry
    * MutableHashMap.set(map, "key1", 999)
-   * console.log(MutableHashMap.get(map, "key1")) // Some(999)
+   * MutableHashMap.get(map, "key1") // => Option.some(999)
    *
    * // Pipe-able version
-   * const setKey = MutableHashMap.set("key3", 300)
-   * setKey(map)
-   * console.log(MutableHashMap.size(map)) // 3
+   * MutableHashMap.set("key3", 300)(map)
+   * MutableHashMap.size(map) // => 3
    * ```
    *
    * @see {@link modify} for updating an existing value with a function
@@ -795,8 +765,8 @@ export const set: {
    *
    * **Example** (Setting key-value pairs)
    *
-   * ```ts
-   * import { MutableHashMap } from "effect"
+   * ```ts import.meta.vitest
+   * import { MutableHashMap, Option } from "effect"
    *
    * const map = MutableHashMap.empty<string, number>()
    *
@@ -804,17 +774,16 @@ export const set: {
    * MutableHashMap.set(map, "key1", 42)
    * MutableHashMap.set(map, "key2", 100)
    *
-   * console.log(MutableHashMap.get(map, "key1")) // Some(42)
-   * console.log(MutableHashMap.size(map)) // 2
+   * MutableHashMap.get(map, "key1") // => Option.some(42)
+   * MutableHashMap.size(map) // => 2
    *
    * // Update existing entry
    * MutableHashMap.set(map, "key1", 999)
-   * console.log(MutableHashMap.get(map, "key1")) // Some(999)
+   * MutableHashMap.get(map, "key1") // => Option.some(999)
    *
    * // Pipe-able version
-   * const setKey = MutableHashMap.set("key3", 300)
-   * setKey(map)
-   * console.log(MutableHashMap.size(map)) // 3
+   * MutableHashMap.set("key3", 300)(map)
+   * MutableHashMap.size(map) // => 3
    * ```
    *
    * @see {@link modify} for updating an existing value with a function
@@ -836,8 +805,8 @@ export const set: {
    *
    * **Example** (Setting key-value pairs)
    *
-   * ```ts
-   * import { MutableHashMap } from "effect"
+   * ```ts import.meta.vitest
+   * import { MutableHashMap, Option } from "effect"
    *
    * const map = MutableHashMap.empty<string, number>()
    *
@@ -845,17 +814,16 @@ export const set: {
    * MutableHashMap.set(map, "key1", 42)
    * MutableHashMap.set(map, "key2", 100)
    *
-   * console.log(MutableHashMap.get(map, "key1")) // Some(42)
-   * console.log(MutableHashMap.size(map)) // 2
+   * MutableHashMap.get(map, "key1") // => Option.some(42)
+   * MutableHashMap.size(map) // => 2
    *
    * // Update existing entry
    * MutableHashMap.set(map, "key1", 999)
-   * console.log(MutableHashMap.get(map, "key1")) // Some(999)
+   * MutableHashMap.get(map, "key1") // => Option.some(999)
    *
    * // Pipe-able version
-   * const setKey = MutableHashMap.set("key3", 300)
-   * setKey(map)
-   * console.log(MutableHashMap.size(map)) // 3
+   * MutableHashMap.set("key3", 300)(map)
+   * MutableHashMap.size(map) // => 3
    * ```
    *
    * @see {@link modify} for updating an existing value with a function
@@ -917,26 +885,26 @@ const getRefKey = <K>(
  *
  * **Example** (Modifying existing values)
  *
- * ```ts
- * import { MutableHashMap } from "effect"
+ * ```ts import.meta.vitest
+ * import { MutableHashMap, Option } from "effect"
  *
  * const map = MutableHashMap.make(["count", 5], ["total", 100])
  *
  * // Increment existing value
  * MutableHashMap.modify(map, "count", (n) => n + 1)
- * console.log(MutableHashMap.get(map, "count")) // Some(6)
+ * MutableHashMap.get(map, "count") // => Option.some(6)
  *
  * // Double existing value
  * MutableHashMap.modify(map, "total", (n) => n * 2)
- * console.log(MutableHashMap.get(map, "total")) // Some(200)
+ * MutableHashMap.get(map, "total") // => Option.some(200)
  *
  * // Try to modify non-existent key (no effect)
  * MutableHashMap.modify(map, "missing", (n) => n + 1)
- * console.log(MutableHashMap.has(map, "missing")) // false
+ * MutableHashMap.has(map, "missing") // => false
  *
  * // Pipe-able version
- * const increment = MutableHashMap.modify("count", (n: number) => n + 1)
- * increment(map)
+ * MutableHashMap.modify("count", (n: number) => n + 1)(map)
+ * MutableHashMap.get(map, "count") // => Option.some(7)
  * ```
  *
  * @see {@link set} for inserting or replacing a value directly
@@ -957,26 +925,26 @@ export const modify: {
    *
    * **Example** (Modifying existing values)
    *
-   * ```ts
-   * import { MutableHashMap } from "effect"
+   * ```ts import.meta.vitest
+   * import { MutableHashMap, Option } from "effect"
    *
    * const map = MutableHashMap.make(["count", 5], ["total", 100])
    *
    * // Increment existing value
    * MutableHashMap.modify(map, "count", (n) => n + 1)
-   * console.log(MutableHashMap.get(map, "count")) // Some(6)
+   * MutableHashMap.get(map, "count") // => Option.some(6)
    *
    * // Double existing value
    * MutableHashMap.modify(map, "total", (n) => n * 2)
-   * console.log(MutableHashMap.get(map, "total")) // Some(200)
+   * MutableHashMap.get(map, "total") // => Option.some(200)
    *
    * // Try to modify non-existent key (no effect)
    * MutableHashMap.modify(map, "missing", (n) => n + 1)
-   * console.log(MutableHashMap.has(map, "missing")) // false
+   * MutableHashMap.has(map, "missing") // => false
    *
    * // Pipe-able version
-   * const increment = MutableHashMap.modify("count", (n: number) => n + 1)
-   * increment(map)
+   * MutableHashMap.modify("count", (n: number) => n + 1)(map)
+   * MutableHashMap.get(map, "count") // => Option.some(7)
    * ```
    *
    * @see {@link set} for inserting or replacing a value directly
@@ -997,26 +965,26 @@ export const modify: {
    *
    * **Example** (Modifying existing values)
    *
-   * ```ts
-   * import { MutableHashMap } from "effect"
+   * ```ts import.meta.vitest
+   * import { MutableHashMap, Option } from "effect"
    *
    * const map = MutableHashMap.make(["count", 5], ["total", 100])
    *
    * // Increment existing value
    * MutableHashMap.modify(map, "count", (n) => n + 1)
-   * console.log(MutableHashMap.get(map, "count")) // Some(6)
+   * MutableHashMap.get(map, "count") // => Option.some(6)
    *
    * // Double existing value
    * MutableHashMap.modify(map, "total", (n) => n * 2)
-   * console.log(MutableHashMap.get(map, "total")) // Some(200)
+   * MutableHashMap.get(map, "total") // => Option.some(200)
    *
    * // Try to modify non-existent key (no effect)
    * MutableHashMap.modify(map, "missing", (n) => n + 1)
-   * console.log(MutableHashMap.has(map, "missing")) // false
+   * MutableHashMap.has(map, "missing") // => false
    *
    * // Pipe-able version
-   * const increment = MutableHashMap.modify("count", (n: number) => n + 1)
-   * increment(map)
+   * MutableHashMap.modify("count", (n: number) => n + 1)(map)
+   * MutableHashMap.get(map, "count") // => Option.some(7)
    * ```
    *
    * @see {@link set} for inserting or replacing a value directly
@@ -1038,26 +1006,26 @@ export const modify: {
    *
    * **Example** (Modifying existing values)
    *
-   * ```ts
-   * import { MutableHashMap } from "effect"
+   * ```ts import.meta.vitest
+   * import { MutableHashMap, Option } from "effect"
    *
    * const map = MutableHashMap.make(["count", 5], ["total", 100])
    *
    * // Increment existing value
    * MutableHashMap.modify(map, "count", (n) => n + 1)
-   * console.log(MutableHashMap.get(map, "count")) // Some(6)
+   * MutableHashMap.get(map, "count") // => Option.some(6)
    *
    * // Double existing value
    * MutableHashMap.modify(map, "total", (n) => n * 2)
-   * console.log(MutableHashMap.get(map, "total")) // Some(200)
+   * MutableHashMap.get(map, "total") // => Option.some(200)
    *
    * // Try to modify non-existent key (no effect)
    * MutableHashMap.modify(map, "missing", (n) => n + 1)
-   * console.log(MutableHashMap.has(map, "missing")) // false
+   * MutableHashMap.has(map, "missing") // => false
    *
    * // Pipe-able version
-   * const increment = MutableHashMap.modify("count", (n: number) => n + 1)
-   * increment(map)
+   * MutableHashMap.modify("count", (n: number) => n + 1)(map)
+   * MutableHashMap.get(map, "count") // => Option.some(7)
    * ```
    *
    * @see {@link set} for inserting or replacing a value directly
@@ -1078,26 +1046,26 @@ export const modify: {
    *
    * **Example** (Modifying existing values)
    *
-   * ```ts
-   * import { MutableHashMap } from "effect"
+   * ```ts import.meta.vitest
+   * import { MutableHashMap, Option } from "effect"
    *
    * const map = MutableHashMap.make(["count", 5], ["total", 100])
    *
    * // Increment existing value
    * MutableHashMap.modify(map, "count", (n) => n + 1)
-   * console.log(MutableHashMap.get(map, "count")) // Some(6)
+   * MutableHashMap.get(map, "count") // => Option.some(6)
    *
    * // Double existing value
    * MutableHashMap.modify(map, "total", (n) => n * 2)
-   * console.log(MutableHashMap.get(map, "total")) // Some(200)
+   * MutableHashMap.get(map, "total") // => Option.some(200)
    *
    * // Try to modify non-existent key (no effect)
    * MutableHashMap.modify(map, "missing", (n) => n + 1)
-   * console.log(MutableHashMap.has(map, "missing")) // false
+   * MutableHashMap.has(map, "missing") // => false
    *
    * // Pipe-able version
-   * const increment = MutableHashMap.modify("count", (n: number) => n + 1)
-   * increment(map)
+   * MutableHashMap.modify("count", (n: number) => n + 1)(map)
+   * MutableHashMap.get(map, "count") // => Option.some(7)
    * ```
    *
    * @see {@link set} for inserting or replacing a value directly
@@ -1146,7 +1114,7 @@ export const modify: {
  *
  * **Example** (Updating or removing a key)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { MutableHashMap, Option } from "effect"
  *
  * const map = MutableHashMap.make(["count", 5])
@@ -1157,7 +1125,7 @@ export const modify: {
  *   "count",
  *   (option) => Option.map(option, (n) => n * 2)
  * )
- * console.log(MutableHashMap.get(map, "count")) // Some(10)
+ * MutableHashMap.get(map, "count") // => Option.some(10)
  *
  * // Add new key
  * MutableHashMap.modifyAt(
@@ -1165,11 +1133,11 @@ export const modify: {
  *   "new",
  *   (option) => Option.isNone(option) ? Option.some(42) : option
  * )
- * console.log(MutableHashMap.get(map, "new")) // Some(42)
+ * MutableHashMap.get(map, "new") // => Option.some(42)
  *
  * // Remove key by returning None
  * MutableHashMap.modifyAt(map, "count", () => Option.none())
- * console.log(MutableHashMap.has(map, "count")) // false
+ * MutableHashMap.get(map, "count") // => Option.none()
  *
  * // Conditional update
  * MutableHashMap.modifyAt(
@@ -1177,7 +1145,7 @@ export const modify: {
  *   "new",
  *   (option) => Option.filter(option, (n) => n > 50) // Remove if <= 50
  * )
- * console.log(MutableHashMap.has(map, "new")) // false (42 <= 50)
+ * MutableHashMap.get(map, "new") // => Option.none()
  * ```
  *
  * @see {@link modify} for updating only when the key already exists
@@ -1199,7 +1167,7 @@ export const modifyAt: {
    *
    * **Example** (Updating or removing a key)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { MutableHashMap, Option } from "effect"
    *
    * const map = MutableHashMap.make(["count", 5])
@@ -1210,7 +1178,7 @@ export const modifyAt: {
    *   "count",
    *   (option) => Option.map(option, (n) => n * 2)
    * )
-   * console.log(MutableHashMap.get(map, "count")) // Some(10)
+   * MutableHashMap.get(map, "count") // => Option.some(10)
    *
    * // Add new key
    * MutableHashMap.modifyAt(
@@ -1218,11 +1186,11 @@ export const modifyAt: {
    *   "new",
    *   (option) => Option.isNone(option) ? Option.some(42) : option
    * )
-   * console.log(MutableHashMap.get(map, "new")) // Some(42)
+   * MutableHashMap.get(map, "new") // => Option.some(42)
    *
    * // Remove key by returning None
    * MutableHashMap.modifyAt(map, "count", () => Option.none())
-   * console.log(MutableHashMap.has(map, "count")) // false
+   * MutableHashMap.get(map, "count") // => Option.none()
    *
    * // Conditional update
    * MutableHashMap.modifyAt(
@@ -1230,7 +1198,7 @@ export const modifyAt: {
    *   "new",
    *   (option) => Option.filter(option, (n) => n > 50) // Remove if <= 50
    * )
-   * console.log(MutableHashMap.has(map, "new")) // false (42 <= 50)
+   * MutableHashMap.get(map, "new") // => Option.none()
    * ```
    *
    * @see {@link modify} for updating only when the key already exists
@@ -1252,7 +1220,7 @@ export const modifyAt: {
    *
    * **Example** (Updating or removing a key)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { MutableHashMap, Option } from "effect"
    *
    * const map = MutableHashMap.make(["count", 5])
@@ -1263,7 +1231,7 @@ export const modifyAt: {
    *   "count",
    *   (option) => Option.map(option, (n) => n * 2)
    * )
-   * console.log(MutableHashMap.get(map, "count")) // Some(10)
+   * MutableHashMap.get(map, "count") // => Option.some(10)
    *
    * // Add new key
    * MutableHashMap.modifyAt(
@@ -1271,11 +1239,11 @@ export const modifyAt: {
    *   "new",
    *   (option) => Option.isNone(option) ? Option.some(42) : option
    * )
-   * console.log(MutableHashMap.get(map, "new")) // Some(42)
+   * MutableHashMap.get(map, "new") // => Option.some(42)
    *
    * // Remove key by returning None
    * MutableHashMap.modifyAt(map, "count", () => Option.none())
-   * console.log(MutableHashMap.has(map, "count")) // false
+   * MutableHashMap.get(map, "count") // => Option.none()
    *
    * // Conditional update
    * MutableHashMap.modifyAt(
@@ -1283,7 +1251,7 @@ export const modifyAt: {
    *   "new",
    *   (option) => Option.filter(option, (n) => n > 50) // Remove if <= 50
    * )
-   * console.log(MutableHashMap.has(map, "new")) // false (42 <= 50)
+   * MutableHashMap.get(map, "new") // => Option.none()
    * ```
    *
    * @see {@link modify} for updating only when the key already exists
@@ -1310,7 +1278,7 @@ export const modifyAt: {
    *
    * **Example** (Updating or removing a key)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { MutableHashMap, Option } from "effect"
    *
    * const map = MutableHashMap.make(["count", 5])
@@ -1321,7 +1289,7 @@ export const modifyAt: {
    *   "count",
    *   (option) => Option.map(option, (n) => n * 2)
    * )
-   * console.log(MutableHashMap.get(map, "count")) // Some(10)
+   * MutableHashMap.get(map, "count") // => Option.some(10)
    *
    * // Add new key
    * MutableHashMap.modifyAt(
@@ -1329,11 +1297,11 @@ export const modifyAt: {
    *   "new",
    *   (option) => Option.isNone(option) ? Option.some(42) : option
    * )
-   * console.log(MutableHashMap.get(map, "new")) // Some(42)
+   * MutableHashMap.get(map, "new") // => Option.some(42)
    *
    * // Remove key by returning None
    * MutableHashMap.modifyAt(map, "count", () => Option.none())
-   * console.log(MutableHashMap.has(map, "count")) // false
+   * MutableHashMap.get(map, "count") // => Option.none()
    *
    * // Conditional update
    * MutableHashMap.modifyAt(
@@ -1341,7 +1309,7 @@ export const modifyAt: {
    *   "new",
    *   (option) => Option.filter(option, (n) => n > 50) // Remove if <= 50
    * )
-   * console.log(MutableHashMap.has(map, "new")) // false (42 <= 50)
+   * MutableHashMap.get(map, "new") // => Option.none()
    * ```
    *
    * @see {@link modify} for updating only when the key already exists
@@ -1363,7 +1331,7 @@ export const modifyAt: {
    *
    * **Example** (Updating or removing a key)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { MutableHashMap, Option } from "effect"
    *
    * const map = MutableHashMap.make(["count", 5])
@@ -1374,7 +1342,7 @@ export const modifyAt: {
    *   "count",
    *   (option) => Option.map(option, (n) => n * 2)
    * )
-   * console.log(MutableHashMap.get(map, "count")) // Some(10)
+   * MutableHashMap.get(map, "count") // => Option.some(10)
    *
    * // Add new key
    * MutableHashMap.modifyAt(
@@ -1382,11 +1350,11 @@ export const modifyAt: {
    *   "new",
    *   (option) => Option.isNone(option) ? Option.some(42) : option
    * )
-   * console.log(MutableHashMap.get(map, "new")) // Some(42)
+   * MutableHashMap.get(map, "new") // => Option.some(42)
    *
    * // Remove key by returning None
    * MutableHashMap.modifyAt(map, "count", () => Option.none())
-   * console.log(MutableHashMap.has(map, "count")) // false
+   * MutableHashMap.get(map, "count") // => Option.none()
    *
    * // Conditional update
    * MutableHashMap.modifyAt(
@@ -1394,7 +1362,7 @@ export const modifyAt: {
    *   "new",
    *   (option) => Option.filter(option, (n) => n > 50) // Remove if <= 50
    * )
-   * console.log(MutableHashMap.has(map, "new")) // false (42 <= 50)
+   * MutableHashMap.get(map, "new") // => Option.none()
    * ```
    *
    * @see {@link modify} for updating only when the key already exists
@@ -1432,7 +1400,7 @@ export const modifyAt: {
  *
  * **Example** (Removing a key)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { MutableHashMap } from "effect"
  *
  * const map = MutableHashMap.make(
@@ -1441,21 +1409,20 @@ export const modifyAt: {
  *   ["key3", 200]
  * )
  *
- * console.log(MutableHashMap.size(map)) // 3
+ * MutableHashMap.size(map) // => 3
  *
  * // Remove existing key
  * MutableHashMap.remove(map, "key2")
- * console.log(MutableHashMap.size(map)) // 2
- * console.log(MutableHashMap.has(map, "key2")) // false
+ * MutableHashMap.size(map) // => 2
+ * MutableHashMap.has(map, "key2") // => false
  *
  * // Remove non-existent key (no effect)
  * MutableHashMap.remove(map, "nonexistent")
- * console.log(MutableHashMap.size(map)) // 2
+ * MutableHashMap.size(map) // => 2
  *
  * // Pipe-able version
- * const removeKey = MutableHashMap.remove("key1")
- * removeKey(map)
- * console.log(MutableHashMap.size(map)) // 1
+ * MutableHashMap.remove("key1")(map)
+ * MutableHashMap.size(map) // => 1
  * ```
  *
  * @see {@link clear} for removing all entries
@@ -1475,7 +1442,7 @@ export const remove: {
    *
    * **Example** (Removing a key)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { MutableHashMap } from "effect"
    *
    * const map = MutableHashMap.make(
@@ -1484,21 +1451,20 @@ export const remove: {
    *   ["key3", 200]
    * )
    *
-   * console.log(MutableHashMap.size(map)) // 3
+   * MutableHashMap.size(map) // => 3
    *
    * // Remove existing key
    * MutableHashMap.remove(map, "key2")
-   * console.log(MutableHashMap.size(map)) // 2
-   * console.log(MutableHashMap.has(map, "key2")) // false
+   * MutableHashMap.size(map) // => 2
+   * MutableHashMap.has(map, "key2") // => false
    *
    * // Remove non-existent key (no effect)
    * MutableHashMap.remove(map, "nonexistent")
-   * console.log(MutableHashMap.size(map)) // 2
+   * MutableHashMap.size(map) // => 2
    *
    * // Pipe-able version
-   * const removeKey = MutableHashMap.remove("key1")
-   * removeKey(map)
-   * console.log(MutableHashMap.size(map)) // 1
+   * MutableHashMap.remove("key1")(map)
+   * MutableHashMap.size(map) // => 1
    * ```
    *
    * @see {@link clear} for removing all entries
@@ -1518,7 +1484,7 @@ export const remove: {
    *
    * **Example** (Removing a key)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { MutableHashMap } from "effect"
    *
    * const map = MutableHashMap.make(
@@ -1527,21 +1493,20 @@ export const remove: {
    *   ["key3", 200]
    * )
    *
-   * console.log(MutableHashMap.size(map)) // 3
+   * MutableHashMap.size(map) // => 3
    *
    * // Remove existing key
    * MutableHashMap.remove(map, "key2")
-   * console.log(MutableHashMap.size(map)) // 2
-   * console.log(MutableHashMap.has(map, "key2")) // false
+   * MutableHashMap.size(map) // => 2
+   * MutableHashMap.has(map, "key2") // => false
    *
    * // Remove non-existent key (no effect)
    * MutableHashMap.remove(map, "nonexistent")
-   * console.log(MutableHashMap.size(map)) // 2
+   * MutableHashMap.size(map) // => 2
    *
    * // Pipe-able version
-   * const removeKey = MutableHashMap.remove("key1")
-   * removeKey(map)
-   * console.log(MutableHashMap.size(map)) // 1
+   * MutableHashMap.remove("key1")(map)
+   * MutableHashMap.size(map) // => 1
    * ```
    *
    * @see {@link clear} for removing all entries
@@ -1562,7 +1527,7 @@ export const remove: {
    *
    * **Example** (Removing a key)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { MutableHashMap } from "effect"
    *
    * const map = MutableHashMap.make(
@@ -1571,21 +1536,20 @@ export const remove: {
    *   ["key3", 200]
    * )
    *
-   * console.log(MutableHashMap.size(map)) // 3
+   * MutableHashMap.size(map) // => 3
    *
    * // Remove existing key
    * MutableHashMap.remove(map, "key2")
-   * console.log(MutableHashMap.size(map)) // 2
-   * console.log(MutableHashMap.has(map, "key2")) // false
+   * MutableHashMap.size(map) // => 2
+   * MutableHashMap.has(map, "key2") // => false
    *
    * // Remove non-existent key (no effect)
    * MutableHashMap.remove(map, "nonexistent")
-   * console.log(MutableHashMap.size(map)) // 2
+   * MutableHashMap.size(map) // => 2
    *
    * // Pipe-able version
-   * const removeKey = MutableHashMap.remove("key1")
-   * removeKey(map)
-   * console.log(MutableHashMap.size(map)) // 1
+   * MutableHashMap.remove("key1")(map)
+   * MutableHashMap.size(map) // => 1
    * ```
    *
    * @see {@link clear} for removing all entries
@@ -1605,7 +1569,7 @@ export const remove: {
    *
    * **Example** (Removing a key)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { MutableHashMap } from "effect"
    *
    * const map = MutableHashMap.make(
@@ -1614,21 +1578,20 @@ export const remove: {
    *   ["key3", 200]
    * )
    *
-   * console.log(MutableHashMap.size(map)) // 3
+   * MutableHashMap.size(map) // => 3
    *
    * // Remove existing key
    * MutableHashMap.remove(map, "key2")
-   * console.log(MutableHashMap.size(map)) // 2
-   * console.log(MutableHashMap.has(map, "key2")) // false
+   * MutableHashMap.size(map) // => 2
+   * MutableHashMap.has(map, "key2") // => false
    *
    * // Remove non-existent key (no effect)
    * MutableHashMap.remove(map, "nonexistent")
-   * console.log(MutableHashMap.size(map)) // 2
+   * MutableHashMap.size(map) // => 2
    *
    * // Pipe-able version
-   * const removeKey = MutableHashMap.remove("key1")
-   * removeKey(map)
-   * console.log(MutableHashMap.size(map)) // 1
+   * MutableHashMap.remove("key1")(map)
+   * MutableHashMap.size(map) // => 1
    * ```
    *
    * @see {@link clear} for removing all entries
@@ -1674,7 +1637,7 @@ export const remove: {
  *
  * **Example** (Clearing all entries)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { MutableHashMap } from "effect"
  *
  * const map = MutableHashMap.make(
@@ -1683,17 +1646,17 @@ export const remove: {
  *   ["key3", 200]
  * )
  *
- * console.log(MutableHashMap.size(map)) // 3
+ * MutableHashMap.size(map) // => 3
  *
  * // Clear all entries
  * MutableHashMap.clear(map)
  *
- * console.log(MutableHashMap.size(map)) // 0
- * console.log(MutableHashMap.has(map, "key1")) // false
+ * MutableHashMap.size(map) // => 0
+ * MutableHashMap.has(map, "key1") // => false
  *
  * // Can still add new entries after clearing
  * MutableHashMap.set(map, "new", 999)
- * console.log(MutableHashMap.size(map)) // 1
+ * Array.from(map) // => [["new", 999]]
  * ```
  *
  * @see {@link remove} for deleting one key
@@ -1717,26 +1680,26 @@ export const clear = <K, V>(self: MutableHashMap<K, V>) => {
  *
  * **Example** (Checking map size)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { MutableHashMap } from "effect"
  *
  * const map = MutableHashMap.empty<string, number>()
- * console.log(MutableHashMap.size(map)) // 0
+ * MutableHashMap.size(map) // => 0
  *
  * MutableHashMap.set(map, "key1", 42)
  * MutableHashMap.set(map, "key2", 100)
- * console.log(MutableHashMap.size(map)) // 2
+ * MutableHashMap.size(map) // => 2
  *
  * MutableHashMap.remove(map, "key1")
- * console.log(MutableHashMap.size(map)) // 1
+ * MutableHashMap.size(map) // => 1
  *
  * MutableHashMap.clear(map)
- * console.log(MutableHashMap.size(map)) // 0
+ * MutableHashMap.size(map) // => 0
  * ```
  *
  * @see {@link isEmpty} for checking whether the map has no entries
  *
- * @category elements
+ * @category getters
  * @since 2.0.0
  */
 export const size = <K, V>(self: MutableHashMap<K, V>): number => self.backing.size