effect 4.0.0-beta.67 → 4.0.0-beta.69

package/src/HashMap.ts

@@ -93,7 +93,7 @@ const TypeId = internal.HashMapTypeId
  * **Example** (Using basic HashMap operations)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * // Create a HashMap
  * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
@@ -124,7 +124,7 @@ export interface HashMap<out Key, out Value> extends Iterable<[Key, Value]>, Equ
  * **Example** (Extracting HashMap types)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * // Create a concrete HashMap for type extraction
  * const inventory = HashMap.make(
@@ -149,7 +149,6 @@ export interface HashMap<out Key, out Value> extends Iterable<[Key, Value]>, Equ
  * const updatedInventory = updateInventory("tablet", newProduct)
  * ```
  *
- * @category models
  * @since 2.0.0
  */
 export declare namespace HashMap {
@@ -161,8 +160,7 @@ export declare namespace HashMap {
    * **Example** (Updating values from Options)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
-   * import * as Option from "effect/Option"
+   * import { HashMap, Option } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2])
    *
@@ -185,7 +183,7 @@ export declare namespace HashMap {
    * **Example** (Extracting key types)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * // Create a HashMap to extract key type from
    * const userMap = HashMap.make(
@@ -211,7 +209,7 @@ export declare namespace HashMap {
    * **Example** (Extracting value types)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * // Create a HashMap with user data
    * const userMap = HashMap.make(
@@ -241,7 +239,7 @@ export declare namespace HashMap {
    * **Example** (Extracting entry types)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * // Create a product catalog HashMap
    * const catalog = HashMap.make(
@@ -273,7 +271,7 @@ export declare namespace HashMap {
  * **Example** (Checking HashMap values)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2])
  * const notMap = { a: 1 }
@@ -293,7 +291,7 @@ export const isHashMap: {
    * **Example** (Checking HashMap values)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2])
    * const notMap = { a: 1 }
@@ -313,7 +311,7 @@ export const isHashMap: {
    * **Example** (Checking HashMap values)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2])
    * const notMap = { a: 1 }
@@ -335,7 +333,7 @@ export const isHashMap: {
  * **Example** (Creating an empty HashMap)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map = HashMap.empty<string, number>()
  * console.log(HashMap.isEmpty(map)) // true
@@ -353,7 +351,7 @@ export const empty: <K = never, V = never>() => HashMap<K, V> = internal.empty
  * **Example** (Creating a HashMap from entries)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
  * console.log(HashMap.size(map)) // 3
@@ -376,7 +374,7 @@ export const make: <Entries extends ReadonlyArray<readonly [any, any]>>(
  * **Example** (Creating a HashMap from an iterable)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const entries = [["a", 1], ["b", 2], ["c", 3]] as const
  * const map = HashMap.fromIterable(entries)
@@ -395,7 +393,7 @@ export const fromIterable: <K, V>(entries: Iterable<readonly [K, V]>) => HashMap
  * **Example** (Checking for empty HashMaps)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const emptyMap = HashMap.empty<string, number>()
  * const nonEmptyMap = HashMap.make(["a", 1])
@@ -416,7 +414,7 @@ export const isEmpty: <K, V>(self: HashMap<K, V>) => boolean = internal.isEmpty
  * **Example** (Looking up values)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2])
  *
@@ -439,7 +437,7 @@ export const get: {
    * **Example** (Looking up values)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2])
    *
@@ -462,7 +460,7 @@ export const get: {
    * **Example** (Looking up values)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2])
    *
@@ -486,8 +484,7 @@ export const get: {
  * **Example** (Looking up values with a hash)
  *
  * ```ts
- * import { Hash } from "effect"
- * import * as HashMap from "effect/HashMap"
+ * import { Hash, HashMap } from "effect"
  *
  * // Useful when implementing custom equality for complex keys
  * const userMap = HashMap.make(
@@ -518,8 +515,7 @@ export const getHash: {
    * **Example** (Looking up values with a hash)
    *
    * ```ts
-   * import { Hash } from "effect"
-   * import * as HashMap from "effect/HashMap"
+   * import { Hash, HashMap } from "effect"
    *
    * // Useful when implementing custom equality for complex keys
    * const userMap = HashMap.make(
@@ -550,8 +546,7 @@ export const getHash: {
    * **Example** (Looking up values with a hash)
    *
    * ```ts
-   * import { Hash } from "effect"
-   * import * as HashMap from "effect/HashMap"
+   * import { Hash, HashMap } from "effect"
    *
    * // Useful when implementing custom equality for complex keys
    * const userMap = HashMap.make(
@@ -588,8 +583,7 @@ export const getHash: {
  * **Example** (Unsafely looking up values)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
- * import * as Option from "effect/Option"
+ * import { HashMap, Option } from "effect"
  *
  * const config = HashMap.make(
  *   ["api_url", "https://api.example.com"],
@@ -612,7 +606,7 @@ export const getHash: {
  * ```
  *
  * @category unsafe
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const getUnsafe: {
   /**
@@ -625,8 +619,7 @@ export const getUnsafe: {
    * **Example** (Unsafely looking up values)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
-   * import * as Option from "effect/Option"
+   * import { HashMap, Option } from "effect"
    *
    * const config = HashMap.make(
    *   ["api_url", "https://api.example.com"],
@@ -649,7 +642,7 @@ export const getUnsafe: {
    * ```
    *
    * @category unsafe
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <K1 extends K, K>(key: K1): <V>(self: HashMap<K, V>) => V
   /**
@@ -662,8 +655,7 @@ export const getUnsafe: {
    * **Example** (Unsafely looking up values)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
-   * import * as Option from "effect/Option"
+   * import { HashMap, Option } from "effect"
    *
    * const config = HashMap.make(
    *   ["api_url", "https://api.example.com"],
@@ -686,7 +678,7 @@ export const getUnsafe: {
    * ```
    *
    * @category unsafe
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <K1 extends K, K, V>(self: HashMap<K, V>, key: K1): V
 } = internal.getUnsafe
@@ -697,7 +689,7 @@ export const getUnsafe: {
  * **Example** (Checking for keys)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2])
  *
@@ -719,7 +711,7 @@ export const has: {
    * **Example** (Checking for keys)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2])
    *
@@ -741,7 +733,7 @@ export const has: {
    * **Example** (Checking for keys)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2])
    *
@@ -766,8 +758,7 @@ export const has: {
  * **Example** (Checking keys with a hash)
  *
  * ```ts
- * import { Hash } from "effect"
- * import * as HashMap from "effect/HashMap"
+ * import { Hash, HashMap } from "effect"
  *
  * // Create a map with case-sensitive keys
  * const userMap = HashMap.make(
@@ -798,8 +789,7 @@ export const hasHash: {
    * **Example** (Checking keys with a hash)
    *
    * ```ts
-   * import { Hash } from "effect"
-   * import * as HashMap from "effect/HashMap"
+   * import { Hash, HashMap } from "effect"
    *
    * // Create a map with case-sensitive keys
    * const userMap = HashMap.make(
@@ -830,8 +820,7 @@ export const hasHash: {
    * **Example** (Checking keys with a hash)
    *
    * ```ts
-   * import { Hash } from "effect"
-   * import * as HashMap from "effect/HashMap"
+   * import { Hash, HashMap } from "effect"
    *
    * // Create a map with case-sensitive keys
    * const userMap = HashMap.make(
@@ -863,7 +852,7 @@ export const hasHash: {
  * **Example** (Checking entries by predicate)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const hm = HashMap.make([1, "a"])
  * HashMap.hasBy(hm, (value, key) => value === "a" && key === 1) // -> true
@@ -880,7 +869,7 @@ export const hasBy: {
    * **Example** (Checking entries by predicate)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const hm = HashMap.make([1, "a"])
    * HashMap.hasBy(hm, (value, key) => value === "a" && key === 1) // -> true
@@ -897,7 +886,7 @@ export const hasBy: {
    * **Example** (Checking entries by predicate)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const hm = HashMap.make([1, "a"])
    * HashMap.hasBy(hm, (value, key) => value === "a" && key === 1) // -> true
@@ -920,7 +909,7 @@ export const hasBy: {
  * **Example** (Setting a value)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map1 = HashMap.make(["a", 1])
  * const map2 = HashMap.set(map1, "b", 2)
@@ -932,7 +921,7 @@ export const hasBy: {
  * console.log(HashMap.size(map1)) // 1
  * ```
  *
- * @category transformations
+ * @category transforming
  * @since 2.0.0
  */
 export const set: {
@@ -943,7 +932,7 @@ export const set: {
    * **Example** (Setting a value)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1])
    * const map2 = HashMap.set(map1, "b", 2)
@@ -955,7 +944,7 @@ export const set: {
    * console.log(HashMap.size(map1)) // 1
    * ```
    *
-   * @category transformations
+   * @category transforming
    * @since 2.0.0
    */
   <K, V>(key: K, value: V): (self: HashMap<K, V>) => HashMap<K, V>
@@ -966,7 +955,7 @@ export const set: {
    * **Example** (Setting a value)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1])
    * const map2 = HashMap.set(map1, "b", 2)
@@ -978,7 +967,7 @@ export const set: {
    * console.log(HashMap.size(map1)) // 1
    * ```
    *
-   * @category transformations
+   * @category transforming
    * @since 2.0.0
    */
   <K, V>(self: HashMap<K, V>, key: K, value: V): HashMap<K, V>
@@ -990,7 +979,7 @@ export const set: {
  * **Example** (Iterating keys)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
  * const keys = Array.from(HashMap.keys(map))
@@ -1008,7 +997,7 @@ export const keys: <K, V>(self: HashMap<K, V>) => IterableIterator<K> = internal
  * **Example** (Iterating values)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
  * const values = Array.from(HashMap.values(map))
@@ -1026,7 +1015,7 @@ export const values: <K, V>(self: HashMap<K, V>) => IterableIterator<V> = intern
  * **Example** (Converting values to an array)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const employees = HashMap.make(
  *   ["alice", { department: "engineering", salary: 90000 }],
@@ -1058,7 +1047,7 @@ export const toValues = <K, V>(self: HashMap<K, V>): Array<V> => Array.from(valu
  * **Example** (Iterating entries)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * // Create a configuration map
  * const config = HashMap.make(
@@ -1091,7 +1080,7 @@ export const entries: <K, V>(self: HashMap<K, V>) => IterableIterator<[K, V]> =
  * **Example** (Converting entries to an array)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const gameScores = HashMap.make(
  *   ["alice", 1250],
@@ -1125,7 +1114,7 @@ export const toEntries = <K, V>(self: HashMap<K, V>): Array<[K, V]> => Array.fro
  * **Example** (Getting the size)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const emptyMap = HashMap.empty<string, number>()
  * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
@@ -1148,7 +1137,7 @@ export const size: <K, V>(self: HashMap<K, V>) => number = internal.size
  * **Example** (Beginning batch mutation)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1])
  *
@@ -1176,7 +1165,7 @@ export const beginMutation: <K, V>(self: HashMap<K, V>) => HashMap<K, V> = inter
  * **Example** (Ending batch mutation)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * // Start with an existing map
  * const original = HashMap.make(["x", 10], ["y", 20])
@@ -1212,7 +1201,7 @@ export const endMutation: <K, V>(self: HashMap<K, V>) => HashMap<K, V> = interna
  * **Example** (Applying batched mutations)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map1 = HashMap.make(["a", 1])
  * const map2 = HashMap.mutate(map1, (mutable) => {
@@ -1236,7 +1225,7 @@ export const mutate: {
    * **Example** (Applying batched mutations)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1])
    * const map2 = HashMap.mutate(map1, (mutable) => {
@@ -1260,7 +1249,7 @@ export const mutate: {
    * **Example** (Applying batched mutations)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1])
    * const map2 = HashMap.mutate(map1, (mutable) => {
@@ -1286,8 +1275,7 @@ export const mutate: {
  * **Example** (Updating values with Options)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
- * import * as Option from "effect/Option"
+ * import { HashMap, Option } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2])
  *
@@ -1299,7 +1287,7 @@ export const mutate: {
  * console.log(HashMap.get(updated, "a")) // Option.some(2)
  * ```
  *
- * @category transformations
+ * @category transforming
  * @since 2.0.0
  */
 export const modifyAt: {
@@ -1313,8 +1301,7 @@ export const modifyAt: {
    * **Example** (Updating values with Options)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
-   * import * as Option from "effect/Option"
+   * import { HashMap, Option } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2])
    *
@@ -1326,7 +1313,7 @@ export const modifyAt: {
    * console.log(HashMap.get(updated, "a")) // Option.some(2)
    * ```
    *
-   * @category transformations
+   * @category transforming
    * @since 2.0.0
    */
   <K, V>(key: K, f: HashMap.UpdateFn<V>): (self: HashMap<K, V>) => HashMap<K, V>
@@ -1340,8 +1327,7 @@ export const modifyAt: {
    * **Example** (Updating values with Options)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
-   * import * as Option from "effect/Option"
+   * import { HashMap, Option } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2])
    *
@@ -1353,7 +1339,7 @@ export const modifyAt: {
    * console.log(HashMap.get(updated, "a")) // Option.some(2)
    * ```
    *
-   * @category transformations
+   * @category transforming
    * @since 2.0.0
    */
   <K, V>(self: HashMap<K, V>, key: K, f: HashMap.UpdateFn<V>): HashMap<K, V>
@@ -1370,9 +1356,7 @@ export const modifyAt: {
  * **Example** (Updating values with a hash)
  *
  * ```ts
- * import { Hash } from "effect"
- * import * as HashMap from "effect/HashMap"
- * import * as Option from "effect/Option"
+ * import { Hash, HashMap, Option } from "effect"
  *
  * // Useful when working with precomputed hashes for performance
  * const counters = HashMap.make(["downloads", 100], ["views", 250])
@@ -1406,7 +1390,7 @@ export const modifyAt: {
  * console.log(HashMap.get(withClicks, "clicks")) // Option.some(1)
  * ```
  *
- * @category transformations
+ * @category transforming
  * @since 2.0.0
  */
 export const modifyHash: {
@@ -1421,9 +1405,7 @@ export const modifyHash: {
    * **Example** (Updating values with a hash)
    *
    * ```ts
-   * import { Hash } from "effect"
-   * import * as HashMap from "effect/HashMap"
-   * import * as Option from "effect/Option"
+   * import { Hash, HashMap, Option } from "effect"
    *
    * // Useful when working with precomputed hashes for performance
    * const counters = HashMap.make(["downloads", 100], ["views", 250])
@@ -1457,7 +1439,7 @@ export const modifyHash: {
    * console.log(HashMap.get(withClicks, "clicks")) // Option.some(1)
    * ```
    *
-   * @category transformations
+   * @category transforming
    * @since 2.0.0
    */
   <K, V>(key: K, hash: number, f: HashMap.UpdateFn<V>): (self: HashMap<K, V>) => HashMap<K, V>
@@ -1472,9 +1454,7 @@ export const modifyHash: {
    * **Example** (Updating values with a hash)
    *
    * ```ts
-   * import { Hash } from "effect"
-   * import * as HashMap from "effect/HashMap"
-   * import * as Option from "effect/Option"
+   * import { Hash, HashMap, Option } from "effect"
    *
    * // Useful when working with precomputed hashes for performance
    * const counters = HashMap.make(["downloads", 100], ["views", 250])
@@ -1508,7 +1488,7 @@ export const modifyHash: {
    * console.log(HashMap.get(withClicks, "clicks")) // Option.some(1)
    * ```
    *
-   * @category transformations
+   * @category transforming
    * @since 2.0.0
    */
   <K, V>(self: HashMap<K, V>, key: K, hash: number, f: HashMap.UpdateFn<V>): HashMap<K, V>
@@ -1520,7 +1500,7 @@ export const modifyHash: {
  * **Example** (Modifying existing values)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map1 = HashMap.make(["a", 1], ["b", 2])
  * const map2 = HashMap.modify(map1, "a", (value) => value * 3)
@@ -1529,7 +1509,7 @@ export const modifyHash: {
  * console.log(HashMap.get(map2, "b")) // Option.some(2)
  * ```
  *
- * @category transformations
+ * @category transforming
  * @since 2.0.0
  */
 export const modify: {
@@ -1539,7 +1519,7 @@ export const modify: {
    * **Example** (Modifying existing values)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1], ["b", 2])
    * const map2 = HashMap.modify(map1, "a", (value) => value * 3)
@@ -1548,7 +1528,7 @@ export const modify: {
    * console.log(HashMap.get(map2, "b")) // Option.some(2)
    * ```
    *
-   * @category transformations
+   * @category transforming
    * @since 2.0.0
    */
   <K, V>(key: K, f: (v: V) => V): (self: HashMap<K, V>) => HashMap<K, V>
@@ -1558,7 +1538,7 @@ export const modify: {
    * **Example** (Modifying existing values)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1], ["b", 2])
    * const map2 = HashMap.modify(map1, "a", (value) => value * 3)
@@ -1567,7 +1547,7 @@ export const modify: {
    * console.log(HashMap.get(map2, "b")) // Option.some(2)
    * ```
    *
-   * @category transformations
+   * @category transforming
    * @since 2.0.0
    */
   <K, V>(self: HashMap<K, V>, key: K, f: (v: V) => V): HashMap<K, V>
@@ -1582,7 +1562,7 @@ export const modify: {
  * **Example** (Combining HashMaps)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map1 = HashMap.make(["a", 1], ["b", 2])
  * const map2 = HashMap.make(["b", 20], ["c", 3])
@@ -1605,7 +1585,7 @@ export const union: {
    * **Example** (Combining HashMaps)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1], ["b", 2])
    * const map2 = HashMap.make(["b", 20], ["c", 3])
@@ -1628,7 +1608,7 @@ export const union: {
    * **Example** (Combining HashMaps)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1], ["b", 2])
    * const map2 = HashMap.make(["b", 20], ["c", 3])
@@ -1651,7 +1631,7 @@ export const union: {
  * **Example** (Removing a key)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map1 = HashMap.make(["a", 1], ["b", 2], ["c", 3])
  * const map2 = HashMap.remove(map1, "b")
@@ -1661,7 +1641,7 @@ export const union: {
  * console.log(HashMap.has(map2, "a")) // true
  * ```
  *
- * @category transformations
+ * @category transforming
  * @since 2.0.0
  */
 export const remove: {
@@ -1672,7 +1652,7 @@ export const remove: {
    * **Example** (Removing a key)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1], ["b", 2], ["c", 3])
    * const map2 = HashMap.remove(map1, "b")
@@ -1682,7 +1662,7 @@ export const remove: {
    * console.log(HashMap.has(map2, "a")) // true
    * ```
    *
-   * @category transformations
+   * @category transforming
    * @since 2.0.0
    */
   <K>(key: K): <V>(self: HashMap<K, V>) => HashMap<K, V>
@@ -1693,7 +1673,7 @@ export const remove: {
    * **Example** (Removing a key)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1], ["b", 2], ["c", 3])
    * const map2 = HashMap.remove(map1, "b")
@@ -1703,7 +1683,7 @@ export const remove: {
    * console.log(HashMap.has(map2, "a")) // true
    * ```
    *
-   * @category transformations
+   * @category transforming
    * @since 2.0.0
    */
   <K, V>(self: HashMap<K, V>, key: K): HashMap<K, V>
@@ -1715,7 +1695,7 @@ export const remove: {
  * **Example** (Removing multiple keys)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map1 = HashMap.make(["a", 1], ["b", 2], ["c", 3], ["d", 4])
  * const map2 = HashMap.removeMany(map1, ["b", "d"])
@@ -1725,7 +1705,7 @@ export const remove: {
  * console.log(HashMap.has(map2, "c")) // true
  * ```
  *
- * @category transformations
+ * @category transforming
  * @since 2.0.0
  */
 export const removeMany: {
@@ -1735,7 +1715,7 @@ export const removeMany: {
    * **Example** (Removing multiple keys)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1], ["b", 2], ["c", 3], ["d", 4])
    * const map2 = HashMap.removeMany(map1, ["b", "d"])
@@ -1745,7 +1725,7 @@ export const removeMany: {
    * console.log(HashMap.has(map2, "c")) // true
    * ```
    *
-   * @category transformations
+   * @category transforming
    * @since 2.0.0
    */
   <K>(keys: Iterable<K>): <V>(self: HashMap<K, V>) => HashMap<K, V>
@@ -1755,7 +1735,7 @@ export const removeMany: {
    * **Example** (Removing multiple keys)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1], ["b", 2], ["c", 3], ["d", 4])
    * const map2 = HashMap.removeMany(map1, ["b", "d"])
@@ -1765,7 +1745,7 @@ export const removeMany: {
    * console.log(HashMap.has(map2, "c")) // true
    * ```
    *
-   * @category transformations
+   * @category transforming
    * @since 2.0.0
    */
   <K, V>(self: HashMap<K, V>, keys: Iterable<K>): HashMap<K, V>
@@ -1777,7 +1757,7 @@ export const removeMany: {
  * **Example** (Setting multiple entries)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map1 = HashMap.make(["a", 1], ["b", 2])
  * const newEntries = [["c", 3], ["d", 4], ["a", 10]] as const // "a" will be overwritten
@@ -1788,8 +1768,8 @@ export const removeMany: {
  * console.log(HashMap.get(map2, "c")) // Option.some(3)
  * ```
  *
- * @category transformations
- * @since 2.0.0
+ * @category transforming
+ * @since 4.0.0
  */
 export const setMany: {
   /**
@@ -1798,7 +1778,7 @@ export const setMany: {
    * **Example** (Setting multiple entries)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1], ["b", 2])
    * const newEntries = [["c", 3], ["d", 4], ["a", 10]] as const // "a" will be overwritten
@@ -1809,8 +1789,8 @@ export const setMany: {
    * console.log(HashMap.get(map2, "c")) // Option.some(3)
    * ```
    *
-   * @category transformations
-   * @since 2.0.0
+   * @category transforming
+   * @since 4.0.0
    */
   <K, V>(entries: Iterable<readonly [K, V]>): (self: HashMap<K, V>) => HashMap<K, V>
   /**
@@ -1819,7 +1799,7 @@ export const setMany: {
    * **Example** (Setting multiple entries)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1], ["b", 2])
    * const newEntries = [["c", 3], ["d", 4], ["a", 10]] as const // "a" will be overwritten
@@ -1830,8 +1810,8 @@ export const setMany: {
    * console.log(HashMap.get(map2, "c")) // Option.some(3)
    * ```
    *
-   * @category transformations
-   * @since 2.0.0
+   * @category transforming
+   * @since 4.0.0
    */
   <K, V>(self: HashMap<K, V>, entries: Iterable<readonly [K, V]>): HashMap<K, V>
 } = internal.setMany
@@ -1842,7 +1822,7 @@ export const setMany: {
  * **Example** (Mapping values)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map1 = HashMap.make(["a", 1], ["b", 2], ["c", 3])
  * const map2 = HashMap.map(map1, (value, key) => `${key}:${value * 2}`)
@@ -1861,7 +1841,7 @@ export const map: {
    * **Example** (Mapping values)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1], ["b", 2], ["c", 3])
    * const map2 = HashMap.map(map1, (value, key) => `${key}:${value * 2}`)
@@ -1880,7 +1860,7 @@ export const map: {
    * **Example** (Mapping values)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1], ["b", 2], ["c", 3])
    * const map2 = HashMap.map(map1, (value, key) => `${key}:${value * 2}`)
@@ -1903,7 +1883,7 @@ export const map: {
  * **Example** (FlatMapping values)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map1 = HashMap.make(["a", 1], ["b", 2])
  * const map2 = HashMap.flatMap(
@@ -1928,7 +1908,7 @@ export const flatMap: {
    * **Example** (FlatMapping values)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1], ["b", 2])
    * const map2 = HashMap.flatMap(
@@ -1953,7 +1933,7 @@ export const flatMap: {
    * **Example** (FlatMapping values)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map1 = HashMap.make(["a", 1], ["b", 2])
    * const map2 = HashMap.flatMap(
@@ -1978,7 +1958,7 @@ export const flatMap: {
  * **Example** (Iterating with side effects)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2])
  * const collected: Array<[string, number]> = []
@@ -2000,7 +1980,7 @@ export const forEach: {
    * **Example** (Iterating with side effects)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2])
    * const collected: Array<[string, number]> = []
@@ -2022,7 +2002,7 @@ export const forEach: {
    * **Example** (Iterating with side effects)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2])
    * const collected: Array<[string, number]> = []
@@ -2046,7 +2026,7 @@ export const forEach: {
  * **Example** (Reducing values)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
  * const sum = HashMap.reduce(map, 0, (acc, value) => acc + value)
@@ -2064,7 +2044,7 @@ export const reduce: {
    * **Example** (Reducing values)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
    * const sum = HashMap.reduce(map, 0, (acc, value) => acc + value)
@@ -2082,7 +2062,7 @@ export const reduce: {
    * **Example** (Reducing values)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
    * const sum = HashMap.reduce(map, 0, (acc, value) => acc + value)
@@ -2102,7 +2082,7 @@ export const reduce: {
  * **Example** (Filtering entries)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * 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)
@@ -2123,7 +2103,7 @@ export const filter: {
    * **Example** (Filtering entries)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * 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)
@@ -2144,7 +2124,7 @@ export const filter: {
    * **Example** (Filtering entries)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * 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)
@@ -2167,8 +2147,7 @@ export const filter: {
  * **Example** (Compacting Option values)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
- * import * as Option from "effect/Option"
+ * import { HashMap, Option } from "effect"
  *
  * const map1 = HashMap.make(
  *   ["a", Option.some(1)],
@@ -2194,8 +2173,7 @@ export const compact: <K, A>(self: HashMap<K, Option<A>>) => HashMap<K, A> = int
  * **Example** (Filtering and mapping Results)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
- * import * as Result from "effect/Result"
+ * import { HashMap, Result } from "effect"
  *
  * const map1 = HashMap.make(["a", 1], ["b", 2], ["c", 3], ["d", 4])
  * const map2 = HashMap.filterMap(
@@ -2219,8 +2197,7 @@ export const filterMap: {
    * **Example** (Filtering and mapping Results)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
-   * import * as Result from "effect/Result"
+   * import { HashMap, Result } from "effect"
    *
    * const map1 = HashMap.make(["a", 1], ["b", 2], ["c", 3], ["d", 4])
    * const map2 = HashMap.filterMap(
@@ -2244,8 +2221,7 @@ export const filterMap: {
    * **Example** (Filtering and mapping Results)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
-   * import * as Result from "effect/Result"
+   * import { HashMap, Result } from "effect"
    *
    * const map1 = HashMap.make(["a", 1], ["b", 2], ["c", 3], ["d", 4])
    * const map2 = HashMap.filterMap(
@@ -2271,8 +2247,7 @@ export const filterMap: {
  * **Example** (Finding the first matching entry)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
- * import * as Option from "effect/Option"
+ * 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)
@@ -2291,8 +2266,7 @@ export const findFirst: {
    * **Example** (Finding the first matching entry)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
-   * import * as Option from "effect/Option"
+   * 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)
@@ -2311,8 +2285,7 @@ export const findFirst: {
    * **Example** (Finding the first matching entry)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
-   * import * as Option from "effect/Option"
+   * 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)
@@ -2332,7 +2305,7 @@ export const findFirst: {
  * **Example** (Checking for any matching entry)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
  *
@@ -2350,7 +2323,7 @@ export const some: {
    * **Example** (Checking for any matching entry)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
    *
@@ -2368,7 +2341,7 @@ export const some: {
    * **Example** (Checking for any matching entry)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
    *
@@ -2388,7 +2361,7 @@ export const some: {
  * **Example** (Checking all entries)
  *
  * ```ts
- * import * as HashMap from "effect/HashMap"
+ * import { HashMap } from "effect"
  *
  * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
  *
@@ -2396,9 +2369,6 @@ export const some: {
  * console.log(HashMap.every(map, (value) => value > 1)) // false
  * ```
  *
- * @param self - The hashmap to check.
- * @param predicate - The condition to test entries (value, key).
- *
  * @category elements
  * @since 3.14.0
  */
@@ -2409,7 +2379,7 @@ export const every: {
    * **Example** (Checking all entries)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
    *
@@ -2417,9 +2387,6 @@ export const every: {
    * console.log(HashMap.every(map, (value) => value > 1)) // false
    * ```
    *
-   * @param self - The hashmap to check.
-   * @param predicate - The condition to test entries (value, key).
-   *
    * @category elements
    * @since 3.14.0
    */
@@ -2430,7 +2397,7 @@ export const every: {
    * **Example** (Checking all entries)
    *
    * ```ts
-   * import * as HashMap from "effect/HashMap"
+   * import { HashMap } from "effect"
    *
    * const map = HashMap.make(["a", 1], ["b", 2], ["c", 3])
    *
@@ -2438,9 +2405,6 @@ export const every: {
    * console.log(HashMap.every(map, (value) => value > 1)) // false
    * ```
    *
-   * @param self - The hashmap to check.
-   * @param predicate - The condition to test entries (value, key).
-   *
    * @category elements
    * @since 3.14.0
    */