effect 4.0.0-beta.102 → 4.0.0-beta.104

package/dist/HashSet.d.ts

@@ -21,23 +21,23 @@ declare const TypeId = "~effect/collections/HashSet";
  *
  * **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
@@ -52,7 +52,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
@@ -65,6 +65,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
@@ -79,7 +80,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)
@@ -88,6 +89,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
@@ -100,17 +102,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
@@ -122,17 +124,14 @@ export declare const empty: <V = never>() => HashSet<V>;
  *
  * **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
@@ -144,17 +143,14 @@ export declare const make: <Values extends ReadonlyArray<any>>(...values: Values
  *
  * **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
@@ -166,15 +162,15 @@ export declare const fromIterable: <V>(values: Iterable<V>) => HashSet<V>;
  *
  * **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
@@ -186,15 +182,15 @@ export declare 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
@@ -206,15 +202,15 @@ export declare 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
@@ -227,19 +223,18 @@ export declare 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
@@ -251,19 +246,18 @@ export declare 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
@@ -275,19 +269,18 @@ export declare 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
@@ -300,15 +293,15 @@ export declare 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) {}
@@ -323,10 +316,10 @@ export declare 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 declare const has: {
@@ -335,15 +328,15 @@ export declare 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) {}
@@ -358,10 +351,10 @@ export declare 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;
@@ -370,15 +363,15 @@ export declare 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) {}
@@ -393,10 +386,10 @@ export declare 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;
@@ -406,19 +399,18 @@ export declare 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
@@ -430,19 +422,18 @@ export declare 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
@@ -454,19 +445,18 @@ export declare 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
@@ -479,17 +469,14 @@ export declare 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
@@ -501,17 +488,15 @@ export declare const size: <V>(self: HashSet<V>) => number;
  *
  * **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 declare const isEmpty: <V>(self: HashSet<V>) => boolean;
@@ -520,15 +505,10 @@ export declare const isEmpty: <V>(self: HashSet<V>) => boolean;
  *
  * **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
@@ -540,15 +520,10 @@ export declare 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
@@ -560,15 +535,10 @@ export declare 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
@@ -581,15 +551,10 @@ export declare 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
@@ -601,15 +566,10 @@ export declare 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
@@ -621,15 +581,10 @@ export declare 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
@@ -642,15 +597,10 @@ export declare 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
@@ -662,15 +612,10 @@ export declare 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
@@ -682,15 +627,10 @@ export declare 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
@@ -703,20 +643,20 @@ export declare 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 declare const isSubset: {
@@ -725,20 +665,20 @@ export declare 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;
@@ -747,20 +687,20 @@ export declare 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;
@@ -770,19 +710,18 @@ export declare 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
@@ -794,19 +733,18 @@ export declare 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
@@ -818,19 +756,18 @@ export declare 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
@@ -843,14 +780,10 @@ export declare 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
@@ -862,14 +795,10 @@ export declare 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
@@ -881,14 +810,10 @@ export declare 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
@@ -900,14 +825,10 @@ export declare 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
@@ -919,14 +840,10 @@ export declare 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
@@ -939,19 +856,18 @@ export declare 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 declare const some: {
@@ -960,19 +876,18 @@ export declare 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;
@@ -981,19 +896,18 @@ export declare 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;
@@ -1003,19 +917,18 @@ export declare 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 declare const every: {
@@ -1024,19 +937,18 @@ export declare 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;
@@ -1045,19 +957,18 @@ export declare 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;
@@ -1067,17 +978,11 @@ export declare 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
@@ -1089,17 +994,11 @@ export declare 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
@@ -1111,17 +1010,11 @@ export declare 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