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

package/dist/MutableHashMap.d.ts

@@ -31,7 +31,7 @@ declare 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
@@ -42,17 +42,7 @@ declare 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
@@ -84,7 +74,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 declare const isMutableHashMap: <K, V>(value: unknown) => value is MutableHashMap<K, V>;
@@ -101,7 +91,7 @@ export declare const isMutableHashMap: <K, V>(value: unknown) => value is Mutabl
  *
  * **Example** (Creating an empty map)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { MutableHashMap } from "effect"
  *
  * const map = MutableHashMap.empty<string, number>()
@@ -110,7 +100,7 @@ export declare const isMutableHashMap: <K, V>(value: unknown) => value is Mutabl
  * 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
@@ -129,8 +119,8 @@ export declare 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],
@@ -138,8 +128,8 @@ export declare 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
@@ -158,8 +148,8 @@ export declare const make: <Entries extends Array<readonly [any, any]>>(...entri
  *
  * **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],
@@ -169,12 +159,12 @@ export declare const make: <Entries extends Array<readonly [any, any]>>(...entri
  *
  * 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
@@ -198,23 +188,22 @@ export declare const fromIterable: <K, V>(entries: Iterable<readonly [K, V]>) =>
  *
  * **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 declare const get: {
@@ -232,23 +221,22 @@ export declare 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>;
@@ -266,23 +254,22 @@ export declare 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>;
@@ -296,7 +283,7 @@ export declare const get: {
  *
  * **Example** (Reading keys)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { MutableHashMap } from "effect"
  *
  * const map = MutableHashMap.make(
@@ -305,17 +292,13 @@ export declare const get: {
  *   ["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 declare const keys: <K, V>(self: MutableHashMap<K, V>) => Iterable<K>;
@@ -328,7 +311,7 @@ export declare const keys: <K, V>(self: MutableHashMap<K, V>) => Iterable<K>;
  *
  * **Example** (Reading values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { MutableHashMap } from "effect"
  *
  * const map = MutableHashMap.make(
@@ -337,21 +320,18 @@ export declare const keys: <K, V>(self: MutableHashMap<K, V>) => Iterable<K>;
  *   ["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 declare const values: <K, V>(self: MutableHashMap<K, V>) => Iterable<V>;
@@ -365,22 +345,21 @@ export declare const values: <K, V>(self: MutableHashMap<K, V>) => Iterable<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 declare const has: {
@@ -394,22 +373,21 @@ export declare 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;
@@ -423,22 +401,21 @@ export declare 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;
@@ -454,8 +431,8 @@ export declare 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>()
  *
@@ -463,17 +440,16 @@ export declare 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
@@ -495,8 +471,8 @@ export declare 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>()
      *
@@ -504,17 +480,16 @@ export declare 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
@@ -536,8 +511,8 @@ export declare 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>()
      *
@@ -545,17 +520,16 @@ export declare 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
@@ -578,26 +552,26 @@ export declare const set: {
  *
  * **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
@@ -618,26 +592,26 @@ export declare 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
@@ -658,26 +632,26 @@ export declare 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
@@ -699,7 +673,7 @@ export declare const modify: {
  *
  * **Example** (Updating or removing a key)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { MutableHashMap, Option } from "effect"
  *
  * const map = MutableHashMap.make(["count", 5])
@@ -710,7 +684,7 @@ export declare 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(
@@ -718,11 +692,11 @@ export declare 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(
@@ -730,7 +704,7 @@ export declare 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
@@ -752,7 +726,7 @@ export declare const modifyAt: {
      *
      * **Example** (Updating or removing a key)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { MutableHashMap, Option } from "effect"
      *
      * const map = MutableHashMap.make(["count", 5])
@@ -763,7 +737,7 @@ export declare 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(
@@ -771,11 +745,11 @@ export declare 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(
@@ -783,7 +757,7 @@ export declare 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
@@ -805,7 +779,7 @@ export declare const modifyAt: {
      *
      * **Example** (Updating or removing a key)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { MutableHashMap, Option } from "effect"
      *
      * const map = MutableHashMap.make(["count", 5])
@@ -816,7 +790,7 @@ export declare 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(
@@ -824,11 +798,11 @@ export declare 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(
@@ -836,7 +810,7 @@ export declare 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
@@ -858,7 +832,7 @@ export declare const modifyAt: {
  *
  * **Example** (Removing a key)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { MutableHashMap } from "effect"
  *
  * const map = MutableHashMap.make(
@@ -867,21 +841,20 @@ export declare 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
@@ -901,7 +874,7 @@ export declare const remove: {
      *
      * **Example** (Removing a key)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { MutableHashMap } from "effect"
      *
      * const map = MutableHashMap.make(
@@ -910,21 +883,20 @@ export declare 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
@@ -944,7 +916,7 @@ export declare const remove: {
      *
      * **Example** (Removing a key)
      *
-     * ```ts
+     * ```ts import.meta.vitest
      * import { MutableHashMap } from "effect"
      *
      * const map = MutableHashMap.make(
@@ -953,21 +925,20 @@ export declare 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
@@ -988,7 +959,7 @@ export declare const remove: {
  *
  * **Example** (Clearing all entries)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { MutableHashMap } from "effect"
  *
  * const map = MutableHashMap.make(
@@ -997,17 +968,17 @@ export declare 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
@@ -1026,26 +997,26 @@ export declare const clear: <K, V>(self: MutableHashMap<K, V>) => MutableHashMap
  *
  * **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 declare const size: <K, V>(self: MutableHashMap<K, V>) => number;