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

package/src/HashSet.ts

@@ -26,23 +26,23 @@ const TypeId = internal.HashSetTypeId
  *
  * **Example** (Creating and updating a HashSet)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
  * // Create a HashSet
  * const set = HashSet.make("apple", "banana", "cherry")
  *
  * // Check membership
- * console.log(HashSet.has(set, "apple")) // true
- * console.log(HashSet.has(set, "grape")) // false
+ * HashSet.has(set, "apple") // => true
+ * HashSet.has(set, "grape") // => false
  *
  * // Add values (returns new HashSet)
  * const updated = HashSet.add(set, "grape")
- * console.log(HashSet.size(updated)) // 4
+ * updated // => HashSet.make("apple", "banana", "cherry", "grape")
  *
  * // Remove values (returns new HashSet)
  * const smaller = HashSet.remove(set, "banana")
- * console.log(HashSet.size(smaller)) // 2
+ * smaller // => HashSet.make("apple", "cherry")
  * ```
  *
  * @category models
@@ -58,7 +58,7 @@ export interface HashSet<out Value> extends Iterable<Value>, Equal, Pipeable, In
  *
  * **Example** (Extracting value types from a HashSet)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
  * // Create a concrete HashSet for type extraction
@@ -71,6 +71,7 @@ export interface HashSet<out Value> extends Iterable<Value>, Equal, Pipeable, In
  * const processFruit = (fruit: Fruit) => {
  *   return `Processing ${fruit}`
  * }
+ * processFruit("apple") // => "Processing apple"
  * ```
  *
  * @since 2.0.0
@@ -85,7 +86,7 @@ export declare namespace HashSet {
    *
    * **Example** (Extracting a HashSet value type)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
    * const numbers = HashSet.make(1, 2, 3, 4, 5)
@@ -94,6 +95,7 @@ export declare namespace HashSet {
    * type NumberType = HashSet.HashSet.Value<typeof numbers> // number
    *
    * const processNumber = (n: NumberType) => n * 2
+   * processNumber(3) // => 6
    * ```
    *
    * @category utility types
@@ -107,17 +109,17 @@ export declare namespace HashSet {
  *
  * **Example** (Creating an empty HashSet)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
  * const set = HashSet.empty<string>()
  *
- * console.log(HashSet.size(set)) // 0
- * console.log(HashSet.isEmpty(set)) // true
+ * HashSet.size(set) // => 0
+ * HashSet.isEmpty(set) // => true
  *
  * // Add some values
  * const withValues = HashSet.add(HashSet.add(set, "hello"), "world")
- * console.log(HashSet.size(withValues)) // 2
+ * withValues // => HashSet.make("hello", "world")
  * ```
  *
  * @category constructors
@@ -130,17 +132,14 @@ export const empty: <V = never>() => HashSet<V> = internal.empty
  *
  * **Example** (Creating a HashSet from values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
- * const fruits = HashSet.make("apple", "banana", "cherry")
- * console.log(HashSet.size(fruits)) // 3
+ * HashSet.make("apple", "banana", "cherry") // => HashSet.make("apple", "banana", "cherry")
  *
- * const numbers = HashSet.make(1, 2, 3, 2, 1) // Duplicates ignored
- * console.log(HashSet.size(numbers)) // 3
+ * HashSet.make(1, 2, 3, 2, 1) // => HashSet.make(1, 2, 3)
  *
- * const mixed = HashSet.make("hello", 42, true)
- * console.log(HashSet.size(mixed)) // 3
+ * HashSet.make("hello", 42, true) // => HashSet.make("hello", 42, true)
  * ```
  *
  * @category constructors
@@ -155,17 +154,14 @@ export const make: <Values extends ReadonlyArray<any>>(
  *
  * **Example** (Creating a HashSet from an iterable)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
- * const fromArray = HashSet.fromIterable(["a", "b", "c", "b", "a"])
- * console.log(HashSet.size(fromArray)) // 3
+ * HashSet.fromIterable(["a", "b", "c", "b", "a"]) // => HashSet.make("a", "b", "c")
  *
- * const fromSet = HashSet.fromIterable(new Set([1, 2, 3]))
- * console.log(HashSet.size(fromSet)) // 3
+ * HashSet.fromIterable(new Set([1, 2, 3])) // => HashSet.make(1, 2, 3)
  *
- * const fromString = HashSet.fromIterable("hello")
- * console.log(Array.from(fromString)) // ["h", "e", "l", "o"]
+ * HashSet.fromIterable("hello") // => HashSet.make("h", "e", "l", "o")
  * ```
  *
  * @category constructors
@@ -178,15 +174,15 @@ export const fromIterable: <V>(values: Iterable<V>) => HashSet<V> = internal.fro
  *
  * **Example** (Checking for a HashSet)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
  * const set = HashSet.make(1, 2, 3)
  * const array = [1, 2, 3]
  *
- * console.log(HashSet.isHashSet(set)) // true
- * console.log(HashSet.isHashSet(array)) // false
- * console.log(HashSet.isHashSet(null)) // false
+ * HashSet.isHashSet(set) // => true
+ * HashSet.isHashSet(array) // => false
+ * HashSet.isHashSet(null) // => false
  * ```
  *
  * @category guards
@@ -198,15 +194,15 @@ export const isHashSet: {
    *
    * **Example** (Checking for a HashSet)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
    * const set = HashSet.make(1, 2, 3)
    * const array = [1, 2, 3]
    *
-   * console.log(HashSet.isHashSet(set)) // true
-   * console.log(HashSet.isHashSet(array)) // false
-   * console.log(HashSet.isHashSet(null)) // false
+   * HashSet.isHashSet(set) // => true
+   * HashSet.isHashSet(array) // => false
+   * HashSet.isHashSet(null) // => false
    * ```
    *
    * @category guards
@@ -218,15 +214,15 @@ export const isHashSet: {
    *
    * **Example** (Checking for a HashSet)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
    * const set = HashSet.make(1, 2, 3)
    * const array = [1, 2, 3]
    *
-   * console.log(HashSet.isHashSet(set)) // true
-   * console.log(HashSet.isHashSet(array)) // false
-   * console.log(HashSet.isHashSet(null)) // false
+   * HashSet.isHashSet(set) // => true
+   * HashSet.isHashSet(array) // => false
+   * HashSet.isHashSet(null) // => false
    * ```
    *
    * @category guards
@@ -240,19 +236,18 @@ export const isHashSet: {
  *
  * **Example** (Adding values to a HashSet)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
  * const set = HashSet.make("a", "b")
  * const withC = HashSet.add(set, "c")
  *
- * console.log(HashSet.size(set)) // 2 (original unchanged)
- * console.log(HashSet.size(withC)) // 3
- * console.log(HashSet.has(withC, "c")) // true
+ * set // => HashSet.make("a", "b")
+ * withC // => HashSet.make("a", "b", "c")
+ * HashSet.has(withC, "c") // => true
  *
  * // Adding existing value has no effect
- * const same = HashSet.add(set, "a")
- * console.log(HashSet.size(same)) // 2
+ * HashSet.add(set, "a") // => HashSet.make("a", "b")
  * ```
  *
  * @category mutations
@@ -264,19 +259,18 @@ export const add: {
    *
    * **Example** (Adding values to a HashSet)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
    * const set = HashSet.make("a", "b")
    * const withC = HashSet.add(set, "c")
    *
-   * console.log(HashSet.size(set)) // 2 (original unchanged)
-   * console.log(HashSet.size(withC)) // 3
-   * console.log(HashSet.has(withC, "c")) // true
+   * set // => HashSet.make("a", "b")
+   * withC // => HashSet.make("a", "b", "c")
+   * HashSet.has(withC, "c") // => true
    *
    * // Adding existing value has no effect
-   * const same = HashSet.add(set, "a")
-   * console.log(HashSet.size(same)) // 2
+   * HashSet.add(set, "a") // => HashSet.make("a", "b")
    * ```
    *
    * @category mutations
@@ -288,19 +282,18 @@ export const add: {
    *
    * **Example** (Adding values to a HashSet)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
    * const set = HashSet.make("a", "b")
    * const withC = HashSet.add(set, "c")
    *
-   * console.log(HashSet.size(set)) // 2 (original unchanged)
-   * console.log(HashSet.size(withC)) // 3
-   * console.log(HashSet.has(withC, "c")) // true
+   * set // => HashSet.make("a", "b")
+   * withC // => HashSet.make("a", "b", "c")
+   * HashSet.has(withC, "c") // => true
    *
    * // Adding existing value has no effect
-   * const same = HashSet.add(set, "a")
-   * console.log(HashSet.size(same)) // 2
+   * HashSet.add(set, "a") // => HashSet.make("a", "b")
    * ```
    *
    * @category mutations
@@ -317,15 +310,15 @@ export const add: {
  *
  * **Example** (Checking HashSet membership)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Equal, Hash, HashSet } from "effect"
  *
  * // Works with any type that implements Equal
  *
  * const set = HashSet.make("apple", "banana", "cherry")
  *
- * console.log(HashSet.has(set, "apple")) // true
- * console.log(HashSet.has(set, "grape")) // false
+ * HashSet.has(set, "apple") // => true
+ * HashSet.has(set, "grape") // => false
  *
  * class Person implements Equal.Equal {
  *   constructor(readonly name: string) {}
@@ -340,10 +333,10 @@ export const add: {
  * }
  *
  * const people = HashSet.make(new Person("Alice"), new Person("Bob"))
- * console.log(HashSet.has(people, new Person("Alice"))) // true
+ * HashSet.has(people, new Person("Alice")) // => true
  * ```
  *
- * @category elements
+ * @category predicates
  * @since 2.0.0
  */
 export const has: {
@@ -352,15 +345,15 @@ export const has: {
    *
    * **Example** (Checking HashSet membership)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Equal, Hash, HashSet } from "effect"
    *
    * // Works with any type that implements Equal
    *
    * const set = HashSet.make("apple", "banana", "cherry")
    *
-   * console.log(HashSet.has(set, "apple")) // true
-   * console.log(HashSet.has(set, "grape")) // false
+   * HashSet.has(set, "apple") // => true
+   * HashSet.has(set, "grape") // => false
    *
    * class Person implements Equal.Equal {
    *   constructor(readonly name: string) {}
@@ -375,10 +368,10 @@ export const has: {
    * }
    *
    * const people = HashSet.make(new Person("Alice"), new Person("Bob"))
-   * console.log(HashSet.has(people, new Person("Alice"))) // true
+   * HashSet.has(people, new Person("Alice")) // => true
    * ```
    *
-   * @category elements
+   * @category predicates
    * @since 2.0.0
    */
   <V>(value: V): (self: HashSet<V>) => boolean
@@ -387,15 +380,15 @@ export const has: {
    *
    * **Example** (Checking HashSet membership)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Equal, Hash, HashSet } from "effect"
    *
    * // Works with any type that implements Equal
    *
    * const set = HashSet.make("apple", "banana", "cherry")
    *
-   * console.log(HashSet.has(set, "apple")) // true
-   * console.log(HashSet.has(set, "grape")) // false
+   * HashSet.has(set, "apple") // => true
+   * HashSet.has(set, "grape") // => false
    *
    * class Person implements Equal.Equal {
    *   constructor(readonly name: string) {}
@@ -410,10 +403,10 @@ export const has: {
    * }
    *
    * const people = HashSet.make(new Person("Alice"), new Person("Bob"))
-   * console.log(HashSet.has(people, new Person("Alice"))) // true
+   * HashSet.has(people, new Person("Alice")) // => true
    * ```
    *
-   * @category elements
+   * @category predicates
    * @since 2.0.0
    */
   <V>(self: HashSet<V>, value: V): boolean
@@ -427,19 +420,18 @@ export const has: {
  *
  * **Example** (Removing values from a HashSet)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
  * const set = HashSet.make("a", "b", "c")
  * const withoutB = HashSet.remove(set, "b")
  *
- * console.log(HashSet.size(set)) // 3 (original unchanged)
- * console.log(HashSet.size(withoutB)) // 2
- * console.log(HashSet.has(withoutB, "b")) // false
+ * set // => HashSet.make("a", "b", "c")
+ * withoutB // => HashSet.make("a", "c")
+ * HashSet.has(withoutB, "b") // => false
  *
  * // Removing non-existent value has no effect
- * const same = HashSet.remove(set, "d")
- * console.log(HashSet.size(same)) // 3
+ * HashSet.remove(set, "d") // => HashSet.make("a", "b", "c")
  * ```
  *
  * @category mutations
@@ -451,19 +443,18 @@ export const remove: {
    *
    * **Example** (Removing values from a HashSet)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
    * const set = HashSet.make("a", "b", "c")
    * const withoutB = HashSet.remove(set, "b")
    *
-   * console.log(HashSet.size(set)) // 3 (original unchanged)
-   * console.log(HashSet.size(withoutB)) // 2
-   * console.log(HashSet.has(withoutB, "b")) // false
+   * set // => HashSet.make("a", "b", "c")
+   * withoutB // => HashSet.make("a", "c")
+   * HashSet.has(withoutB, "b") // => false
    *
    * // Removing non-existent value has no effect
-   * const same = HashSet.remove(set, "d")
-   * console.log(HashSet.size(same)) // 3
+   * HashSet.remove(set, "d") // => HashSet.make("a", "b", "c")
    * ```
    *
    * @category mutations
@@ -475,19 +466,18 @@ export const remove: {
    *
    * **Example** (Removing values from a HashSet)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
    * const set = HashSet.make("a", "b", "c")
    * const withoutB = HashSet.remove(set, "b")
    *
-   * console.log(HashSet.size(set)) // 3 (original unchanged)
-   * console.log(HashSet.size(withoutB)) // 2
-   * console.log(HashSet.has(withoutB, "b")) // false
+   * set // => HashSet.make("a", "b", "c")
+   * withoutB // => HashSet.make("a", "c")
+   * HashSet.has(withoutB, "b") // => false
    *
    * // Removing non-existent value has no effect
-   * const same = HashSet.remove(set, "d")
-   * console.log(HashSet.size(same)) // 3
+   * HashSet.remove(set, "d") // => HashSet.make("a", "b", "c")
    * ```
    *
    * @category mutations
@@ -504,17 +494,14 @@ export const remove: {
  *
  * **Example** (Getting the HashSet size)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
- * const empty = HashSet.empty<string>()
- * console.log(HashSet.size(empty)) // 0
+ * HashSet.size(HashSet.empty<string>()) // => 0
  *
- * const small = HashSet.make("a", "b")
- * console.log(HashSet.size(small)) // 2
+ * HashSet.size(HashSet.make("a", "b")) // => 2
  *
- * const withDuplicates = HashSet.fromIterable(["x", "y", "z", "x", "y"])
- * console.log(HashSet.size(withDuplicates)) // 3
+ * HashSet.size(HashSet.fromIterable(["x", "y", "z", "x", "y"])) // => 3
  * ```
  *
  * @category getters
@@ -527,17 +514,15 @@ export const size: <V>(self: HashSet<V>) => number = internal.size
  *
  * **Example** (Checking whether a HashSet is empty)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
- * const empty = HashSet.empty<string>()
- * console.log(HashSet.isEmpty(empty)) // true
+ * HashSet.isEmpty(HashSet.empty<string>()) // => true
  *
- * const nonEmpty = HashSet.make("a")
- * console.log(HashSet.isEmpty(nonEmpty)) // false
+ * HashSet.isEmpty(HashSet.make("a")) // => false
  * ```
  *
- * @category getters
+ * @category predicates
  * @since 4.0.0
  */
 export const isEmpty: <V>(self: HashSet<V>) => boolean = internal.isEmpty
@@ -547,15 +532,10 @@ export const isEmpty: <V>(self: HashSet<V>) => boolean = internal.isEmpty
  *
  * **Example** (Combining HashSets)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
- * const set1 = HashSet.make("a", "b")
- * const set2 = HashSet.make("b", "c")
- * const combined = HashSet.union(set1, set2)
- *
- * console.log(Array.from(combined).sort()) // ["a", "b", "c"]
- * console.log(HashSet.size(combined)) // 3
+ * HashSet.union(HashSet.make("a", "b"), HashSet.make("b", "c")) // => HashSet.make("a", "b", "c")
  * ```
  *
  * @category combinators
@@ -567,15 +547,10 @@ export const union: {
    *
    * **Example** (Combining HashSets)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
-   * const set1 = HashSet.make("a", "b")
-   * const set2 = HashSet.make("b", "c")
-   * const combined = HashSet.union(set1, set2)
-   *
-   * console.log(Array.from(combined).sort()) // ["a", "b", "c"]
-   * console.log(HashSet.size(combined)) // 3
+   * HashSet.union(HashSet.make("a", "b"), HashSet.make("b", "c")) // => HashSet.make("a", "b", "c")
    * ```
    *
    * @category combinators
@@ -587,15 +562,10 @@ export const union: {
    *
    * **Example** (Combining HashSets)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
-   * const set1 = HashSet.make("a", "b")
-   * const set2 = HashSet.make("b", "c")
-   * const combined = HashSet.union(set1, set2)
-   *
-   * console.log(Array.from(combined).sort()) // ["a", "b", "c"]
-   * console.log(HashSet.size(combined)) // 3
+   * HashSet.union(HashSet.make("a", "b"), HashSet.make("b", "c")) // => HashSet.make("a", "b", "c")
    * ```
    *
    * @category combinators
@@ -612,15 +582,10 @@ export const union: {
  *
  * **Example** (Finding common HashSet values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
- * const set1 = HashSet.make("a", "b", "c")
- * const set2 = HashSet.make("b", "c", "d")
- * const common = HashSet.intersection(set1, set2)
- *
- * console.log(Array.from(common).sort()) // ["b", "c"]
- * console.log(HashSet.size(common)) // 2
+ * HashSet.intersection(HashSet.make("a", "b", "c"), HashSet.make("b", "c", "d")) // => HashSet.make("b", "c")
  * ```
  *
  * @category combinators
@@ -632,15 +597,10 @@ export const intersection: {
    *
    * **Example** (Finding common HashSet values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
-   * const set1 = HashSet.make("a", "b", "c")
-   * const set2 = HashSet.make("b", "c", "d")
-   * const common = HashSet.intersection(set1, set2)
-   *
-   * console.log(Array.from(common).sort()) // ["b", "c"]
-   * console.log(HashSet.size(common)) // 2
+   * HashSet.intersection(HashSet.make("a", "b", "c"), HashSet.make("b", "c", "d")) // => HashSet.make("b", "c")
    * ```
    *
    * @category combinators
@@ -652,15 +612,10 @@ export const intersection: {
    *
    * **Example** (Finding common HashSet values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
-   * const set1 = HashSet.make("a", "b", "c")
-   * const set2 = HashSet.make("b", "c", "d")
-   * const common = HashSet.intersection(set1, set2)
-   *
-   * console.log(Array.from(common).sort()) // ["b", "c"]
-   * console.log(HashSet.size(common)) // 2
+   * HashSet.intersection(HashSet.make("a", "b", "c"), HashSet.make("b", "c", "d")) // => HashSet.make("b", "c")
    * ```
    *
    * @category combinators
@@ -677,15 +632,10 @@ export const intersection: {
  *
  * **Example** (Finding HashSet differences)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
- * const set1 = HashSet.make("a", "b", "c")
- * const set2 = HashSet.make("b", "d")
- * const diff = HashSet.difference(set1, set2)
- *
- * console.log(Array.from(diff).sort()) // ["a", "c"]
- * console.log(HashSet.size(diff)) // 2
+ * HashSet.difference(HashSet.make("a", "b", "c"), HashSet.make("b", "d")) // => HashSet.make("a", "c")
  * ```
  *
  * @category combinators
@@ -697,15 +647,10 @@ export const difference: {
    *
    * **Example** (Finding HashSet differences)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
-   * const set1 = HashSet.make("a", "b", "c")
-   * const set2 = HashSet.make("b", "d")
-   * const diff = HashSet.difference(set1, set2)
-   *
-   * console.log(Array.from(diff).sort()) // ["a", "c"]
-   * console.log(HashSet.size(diff)) // 2
+   * HashSet.difference(HashSet.make("a", "b", "c"), HashSet.make("b", "d")) // => HashSet.make("a", "c")
    * ```
    *
    * @category combinators
@@ -717,15 +662,10 @@ export const difference: {
    *
    * **Example** (Finding HashSet differences)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
-   * const set1 = HashSet.make("a", "b", "c")
-   * const set2 = HashSet.make("b", "d")
-   * const diff = HashSet.difference(set1, set2)
-   *
-   * console.log(Array.from(diff).sort()) // ["a", "c"]
-   * console.log(HashSet.size(diff)) // 2
+   * HashSet.difference(HashSet.make("a", "b", "c"), HashSet.make("b", "d")) // => HashSet.make("a", "c")
    * ```
    *
    * @category combinators
@@ -742,20 +682,20 @@ export const difference: {
  *
  * **Example** (Checking subset relationships)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
  * const small = HashSet.make("a", "b")
  * const large = HashSet.make("a", "b", "c", "d")
  * const other = HashSet.make("x", "y")
  *
- * console.log(HashSet.isSubset(small, large)) // true
- * console.log(HashSet.isSubset(large, small)) // false
- * console.log(HashSet.isSubset(small, other)) // false
- * console.log(HashSet.isSubset(small, small)) // true
+ * HashSet.isSubset(small, large) // => true
+ * HashSet.isSubset(large, small) // => false
+ * HashSet.isSubset(small, other) // => false
+ * HashSet.isSubset(small, small) // => true
  * ```
  *
- * @category elements
+ * @category predicates
  * @since 2.0.0
  */
 export const isSubset: {
@@ -764,20 +704,20 @@ export const isSubset: {
    *
    * **Example** (Checking subset relationships)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
    * const small = HashSet.make("a", "b")
    * const large = HashSet.make("a", "b", "c", "d")
    * const other = HashSet.make("x", "y")
    *
-   * console.log(HashSet.isSubset(small, large)) // true
-   * console.log(HashSet.isSubset(large, small)) // false
-   * console.log(HashSet.isSubset(small, other)) // false
-   * console.log(HashSet.isSubset(small, small)) // true
+   * HashSet.isSubset(small, large) // => true
+   * HashSet.isSubset(large, small) // => false
+   * HashSet.isSubset(small, other) // => false
+   * HashSet.isSubset(small, small) // => true
    * ```
    *
-   * @category elements
+   * @category predicates
    * @since 2.0.0
    */
   <V1>(that: HashSet<V1>): <V0>(self: HashSet<V0>) => boolean
@@ -786,20 +726,20 @@ export const isSubset: {
    *
    * **Example** (Checking subset relationships)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
    * const small = HashSet.make("a", "b")
    * const large = HashSet.make("a", "b", "c", "d")
    * const other = HashSet.make("x", "y")
    *
-   * console.log(HashSet.isSubset(small, large)) // true
-   * console.log(HashSet.isSubset(large, small)) // false
-   * console.log(HashSet.isSubset(small, other)) // false
-   * console.log(HashSet.isSubset(small, small)) // true
+   * HashSet.isSubset(small, large) // => true
+   * HashSet.isSubset(large, small) // => false
+   * HashSet.isSubset(small, other) // => false
+   * HashSet.isSubset(small, small) // => true
    * ```
    *
-   * @category elements
+   * @category predicates
    * @since 2.0.0
    */
   <V0, V1>(self: HashSet<V0>, that: HashSet<V1>): boolean
@@ -813,19 +753,18 @@ export const isSubset: {
  *
  * **Example** (Mapping HashSet values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
  * const numbers = HashSet.make(1, 2, 3)
  * const doubled = HashSet.map(numbers, (n) => n * 2)
  *
- * console.log(Array.from(doubled).sort()) // [2, 4, 6]
- * console.log(HashSet.size(doubled)) // 3
+ * doubled // => HashSet.make(2, 4, 6)
  *
  * // Mapping can reduce size if function produces duplicates
  * const strings = HashSet.make("apple", "banana", "cherry")
  * const lengths = HashSet.map(strings, (s) => s.length)
- * console.log(Array.from(lengths).sort()) // [5, 6] (apple=5, banana=6, cherry=6)
+ * lengths // => HashSet.make(5, 6)
  * ```
  *
  * @category mapping
@@ -837,19 +776,18 @@ export const map: {
    *
    * **Example** (Mapping HashSet values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
    * const numbers = HashSet.make(1, 2, 3)
    * const doubled = HashSet.map(numbers, (n) => n * 2)
    *
-   * console.log(Array.from(doubled).sort()) // [2, 4, 6]
-   * console.log(HashSet.size(doubled)) // 3
+   * doubled // => HashSet.make(2, 4, 6)
    *
    * // Mapping can reduce size if function produces duplicates
    * const strings = HashSet.make("apple", "banana", "cherry")
    * const lengths = HashSet.map(strings, (s) => s.length)
-   * console.log(Array.from(lengths).sort()) // [5, 6] (apple=5, banana=6, cherry=6)
+   * lengths // => HashSet.make(5, 6)
    * ```
    *
    * @category mapping
@@ -861,19 +799,18 @@ export const map: {
    *
    * **Example** (Mapping HashSet values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
    * const numbers = HashSet.make(1, 2, 3)
    * const doubled = HashSet.map(numbers, (n) => n * 2)
    *
-   * console.log(Array.from(doubled).sort()) // [2, 4, 6]
-   * console.log(HashSet.size(doubled)) // 3
+   * doubled // => HashSet.make(2, 4, 6)
    *
    * // Mapping can reduce size if function produces duplicates
    * const strings = HashSet.make("apple", "banana", "cherry")
    * const lengths = HashSet.map(strings, (s) => s.length)
-   * console.log(Array.from(lengths).sort()) // [5, 6] (apple=5, banana=6, cherry=6)
+   * lengths // => HashSet.make(5, 6)
    * ```
    *
    * @category mapping
@@ -890,14 +827,10 @@ export const map: {
  *
  * **Example** (Filtering HashSet values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
- * const numbers = HashSet.make(1, 2, 3, 4, 5, 6)
- * const evens = HashSet.filter(numbers, (n) => n % 2 === 0)
- *
- * console.log(Array.from(evens).sort()) // [2, 4, 6]
- * console.log(HashSet.size(evens)) // 3
+ * HashSet.filter(HashSet.make(1, 2, 3, 4, 5, 6), (n) => n % 2 === 0) // => HashSet.make(2, 4, 6)
  * ```
  *
  * @category filtering
@@ -909,14 +842,10 @@ export const filter: {
    *
    * **Example** (Filtering HashSet values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
-   * const numbers = HashSet.make(1, 2, 3, 4, 5, 6)
-   * const evens = HashSet.filter(numbers, (n) => n % 2 === 0)
-   *
-   * console.log(Array.from(evens).sort()) // [2, 4, 6]
-   * console.log(HashSet.size(evens)) // 3
+   * HashSet.filter(HashSet.make(1, 2, 3, 4, 5, 6), (n) => n % 2 === 0) // => HashSet.make(2, 4, 6)
    * ```
    *
    * @category filtering
@@ -928,14 +857,10 @@ export const filter: {
    *
    * **Example** (Filtering HashSet values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
-   * const numbers = HashSet.make(1, 2, 3, 4, 5, 6)
-   * const evens = HashSet.filter(numbers, (n) => n % 2 === 0)
-   *
-   * console.log(Array.from(evens).sort()) // [2, 4, 6]
-   * console.log(HashSet.size(evens)) // 3
+   * HashSet.filter(HashSet.make(1, 2, 3, 4, 5, 6), (n) => n % 2 === 0) // => HashSet.make(2, 4, 6)
    * ```
    *
    * @category filtering
@@ -947,14 +872,10 @@ export const filter: {
    *
    * **Example** (Filtering HashSet values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
-   * const numbers = HashSet.make(1, 2, 3, 4, 5, 6)
-   * const evens = HashSet.filter(numbers, (n) => n % 2 === 0)
-   *
-   * console.log(Array.from(evens).sort()) // [2, 4, 6]
-   * console.log(HashSet.size(evens)) // 3
+   * HashSet.filter(HashSet.make(1, 2, 3, 4, 5, 6), (n) => n % 2 === 0) // => HashSet.make(2, 4, 6)
    * ```
    *
    * @category filtering
@@ -966,14 +887,10 @@ export const filter: {
    *
    * **Example** (Filtering HashSet values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
-   * const numbers = HashSet.make(1, 2, 3, 4, 5, 6)
-   * const evens = HashSet.filter(numbers, (n) => n % 2 === 0)
-   *
-   * console.log(Array.from(evens).sort()) // [2, 4, 6]
-   * console.log(HashSet.size(evens)) // 3
+   * HashSet.filter(HashSet.make(1, 2, 3, 4, 5, 6), (n) => n % 2 === 0) // => HashSet.make(2, 4, 6)
    * ```
    *
    * @category filtering
@@ -996,19 +913,18 @@ export const filter: {
  *
  * **Example** (Testing whether some values match)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
  * const numbers = HashSet.make(1, 2, 3, 4, 5)
  *
- * console.log(HashSet.some(numbers, (n) => n > 3)) // true
- * console.log(HashSet.some(numbers, (n) => n > 10)) // false
+ * HashSet.some(numbers, (n) => n > 3) // => true
+ * HashSet.some(numbers, (n) => n > 10) // => false
  *
- * const empty = HashSet.empty<number>()
- * console.log(HashSet.some(empty, (n) => n > 0)) // false
+ * HashSet.some(HashSet.empty<number>(), (n) => n > 0) // => false
  * ```
  *
- * @category elements
+ * @category predicates
  * @since 2.0.0
  */
 export const some: {
@@ -1017,19 +933,18 @@ export const some: {
    *
    * **Example** (Testing whether some values match)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
    * const numbers = HashSet.make(1, 2, 3, 4, 5)
    *
-   * console.log(HashSet.some(numbers, (n) => n > 3)) // true
-   * console.log(HashSet.some(numbers, (n) => n > 10)) // false
+   * HashSet.some(numbers, (n) => n > 3) // => true
+   * HashSet.some(numbers, (n) => n > 10) // => false
    *
-   * const empty = HashSet.empty<number>()
-   * console.log(HashSet.some(empty, (n) => n > 0)) // false
+   * HashSet.some(HashSet.empty<number>(), (n) => n > 0) // => false
    * ```
    *
-   * @category elements
+   * @category predicates
    * @since 2.0.0
    */
   <V>(predicate: Predicate<V>): (self: HashSet<V>) => boolean
@@ -1038,19 +953,18 @@ export const some: {
    *
    * **Example** (Testing whether some values match)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
    * const numbers = HashSet.make(1, 2, 3, 4, 5)
    *
-   * console.log(HashSet.some(numbers, (n) => n > 3)) // true
-   * console.log(HashSet.some(numbers, (n) => n > 10)) // false
+   * HashSet.some(numbers, (n) => n > 3) // => true
+   * HashSet.some(numbers, (n) => n > 10) // => false
    *
-   * const empty = HashSet.empty<number>()
-   * console.log(HashSet.some(empty, (n) => n > 0)) // false
+   * HashSet.some(HashSet.empty<number>(), (n) => n > 0) // => false
    * ```
    *
-   * @category elements
+   * @category predicates
    * @since 2.0.0
    */
   <V>(self: HashSet<V>, predicate: Predicate<V>): boolean
@@ -1064,19 +978,18 @@ export const some: {
  *
  * **Example** (Testing whether every value matches)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
  * const numbers = HashSet.make(2, 4, 6, 8)
  *
- * console.log(HashSet.every(numbers, (n) => n % 2 === 0)) // true
- * console.log(HashSet.every(numbers, (n) => n > 5)) // false
+ * HashSet.every(numbers, (n) => n % 2 === 0) // => true
+ * HashSet.every(numbers, (n) => n > 5) // => false
  *
- * const empty = HashSet.empty<number>()
- * console.log(HashSet.every(empty, (n) => n > 0)) // true (vacuously true)
+ * HashSet.every(HashSet.empty<number>(), (n) => n > 0) // => true
  * ```
  *
- * @category elements
+ * @category predicates
  * @since 2.0.0
  */
 export const every: {
@@ -1085,19 +998,18 @@ export const every: {
    *
    * **Example** (Testing whether every value matches)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
    * const numbers = HashSet.make(2, 4, 6, 8)
    *
-   * console.log(HashSet.every(numbers, (n) => n % 2 === 0)) // true
-   * console.log(HashSet.every(numbers, (n) => n > 5)) // false
+   * HashSet.every(numbers, (n) => n % 2 === 0) // => true
+   * HashSet.every(numbers, (n) => n > 5) // => false
    *
-   * const empty = HashSet.empty<number>()
-   * console.log(HashSet.every(empty, (n) => n > 0)) // true (vacuously true)
+   * HashSet.every(HashSet.empty<number>(), (n) => n > 0) // => true
    * ```
    *
-   * @category elements
+   * @category predicates
    * @since 2.0.0
    */
   <V>(predicate: Predicate<V>): (self: HashSet<V>) => boolean
@@ -1106,19 +1018,18 @@ export const every: {
    *
    * **Example** (Testing whether every value matches)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
    * const numbers = HashSet.make(2, 4, 6, 8)
    *
-   * console.log(HashSet.every(numbers, (n) => n % 2 === 0)) // true
-   * console.log(HashSet.every(numbers, (n) => n > 5)) // false
+   * HashSet.every(numbers, (n) => n % 2 === 0) // => true
+   * HashSet.every(numbers, (n) => n > 5) // => false
    *
-   * const empty = HashSet.empty<number>()
-   * console.log(HashSet.every(empty, (n) => n > 0)) // true (vacuously true)
+   * HashSet.every(HashSet.empty<number>(), (n) => n > 0) // => true
    * ```
    *
-   * @category elements
+   * @category predicates
    * @since 2.0.0
    */
   <V>(self: HashSet<V>, predicate: Predicate<V>): boolean
@@ -1132,17 +1043,11 @@ export const every: {
  *
  * **Example** (Reducing HashSet values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { HashSet } from "effect"
  *
  * const numbers = HashSet.make(1, 2, 3, 4, 5)
- * const sum = HashSet.reduce(numbers, 0, (acc, n) => acc + n)
- *
- * console.log(sum) // 15
- *
- * const strings = HashSet.make("a", "b", "c")
- * const concatenated = HashSet.reduce(strings, "", (acc, s) => acc + s)
- * console.log(concatenated) // Order may vary: "abc", "bac", etc.
+ * HashSet.reduce(numbers, 0, (acc, n) => acc + n) // => 15
  * ```
  *
  * @category folding
@@ -1154,17 +1059,11 @@ export const reduce: {
    *
    * **Example** (Reducing HashSet values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
    * const numbers = HashSet.make(1, 2, 3, 4, 5)
-   * const sum = HashSet.reduce(numbers, 0, (acc, n) => acc + n)
-   *
-   * console.log(sum) // 15
-   *
-   * const strings = HashSet.make("a", "b", "c")
-   * const concatenated = HashSet.reduce(strings, "", (acc, s) => acc + s)
-   * console.log(concatenated) // Order may vary: "abc", "bac", etc.
+   * HashSet.reduce(numbers, 0, (acc, n) => acc + n) // => 15
    * ```
    *
    * @category folding
@@ -1176,17 +1075,11 @@ export const reduce: {
    *
    * **Example** (Reducing HashSet values)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { HashSet } from "effect"
    *
    * const numbers = HashSet.make(1, 2, 3, 4, 5)
-   * const sum = HashSet.reduce(numbers, 0, (acc, n) => acc + n)
-   *
-   * console.log(sum) // 15
-   *
-   * const strings = HashSet.make("a", "b", "c")
-   * const concatenated = HashSet.reduce(strings, "", (acc, s) => acc + s)
-   * console.log(concatenated) // Order may vary: "abc", "bac", etc.
+   * HashSet.reduce(numbers, 0, (acc, n) => acc + n) // => 15
    * ```
    *
    * @category folding