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

package/dist/Trie.js

@@ -5,14 +5,13 @@ const TypeId = TR.TrieTypeId;
  *
  * **Example** (Creating an empty trie)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Trie } from "effect"
- * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<string>()
  *
- * assert.equal(Trie.size(trie), 0)
- * assert.deepStrictEqual(Array.from(trie), [])
+ * Trie.size(trie) // => 0
+ * Array.from(trie) // => []
  * ```
  *
  * @category constructors
@@ -24,9 +23,8 @@ export const empty = TR.empty;
  *
  * **Example** (Creating a trie from entries)
  *
- * ```ts
- * import { Equal, Trie } from "effect"
- * import * as assert from "node:assert"
+ * ```ts import.meta.vitest
+ * import { Trie } from "effect"
  *
  * const iterable: Array<readonly [string, number]> = [["call", 0], ["me", 1], [
  *   "mind",
@@ -35,17 +33,8 @@ export const empty = TR.empty;
  * const trie = Trie.fromIterable(iterable)
  *
  * // The entries in the `Trie` are extracted in alphabetical order, regardless of the insertion order
- * assert.deepStrictEqual(Array.from(trie), [["call", 0], ["me", 1], ["mid", 3], [
- *   "mind",
- *   2
- * ]])
- * assert.equal(
- *   Equal.equals(
- *     Trie.make(["call", 0], ["me", 1], ["mind", 2], ["mid", 3]),
- *     trie
- *   ),
- *   true
- * )
+ * Array.from(trie) // => [["call", 0], ["me", 1], ["mid", 3], ["mind", 2]]
+ * trie // => Trie.make(["call", 0], ["me", 1], ["mind", 2], ["mid", 3])
  * ```
  *
  * @category constructors
@@ -57,17 +46,13 @@ export const fromIterable = TR.fromIterable;
  *
  * **Example** (Constructing a trie from entries)
  *
- * ```ts
- * import { Equal, Trie } from "effect"
- * import * as assert from "node:assert"
+ * ```ts import.meta.vitest
+ * import { Trie } from "effect"
  *
  * const trie = Trie.make(["ca", 0], ["me", 1])
  *
- * assert.deepStrictEqual(Array.from(trie), [["ca", 0], ["me", 1]])
- * assert.equal(
- *   Equal.equals(Trie.fromIterable([["ca", 0], ["me", 1]]), trie),
- *   true
- * )
+ * Array.from(trie) // => [["ca", 0], ["me", 1]]
+ * trie // => Trie.fromIterable([["ca", 0], ["me", 1]])
  * ```
  *
  * @category constructors
@@ -79,9 +64,8 @@ export const make = TR.make;
  *
  * **Example** (Inserting entries)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Trie } from "effect"
- * import * as assert from "node:assert"
  *
  * const trie1 = Trie.empty<number>().pipe(
  *   Trie.insert("call", 0)
@@ -90,13 +74,10 @@ export const make = TR.make;
  * const trie3 = trie2.pipe(Trie.insert("mind", 2))
  * const trie4 = trie3.pipe(Trie.insert("mid", 3))
  *
- * assert.deepStrictEqual(Array.from(trie1), [["call", 0]])
- * assert.deepStrictEqual(Array.from(trie2), [["call", 0], ["me", 1]])
- * assert.deepStrictEqual(Array.from(trie3), [["call", 0], ["me", 1], ["mind", 2]])
- * assert.deepStrictEqual(Array.from(trie4), [["call", 0], ["me", 1], ["mid", 3], [
- *   "mind",
- *   2
- * ]])
+ * Array.from(trie1) // => [["call", 0]]
+ * Array.from(trie2) // => [["call", 0], ["me", 1]]
+ * Array.from(trie3) // => [["call", 0], ["me", 1], ["mind", 2]]
+ * Array.from(trie4) // => [["call", 0], ["me", 1], ["mid", 3], ["mind", 2]]
  * ```
  *
  * @category mutations
@@ -112,9 +93,8 @@ export const insert = TR.insert;
  *
  * **Example** (Reading keys in alphabetical order)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Trie } from "effect"
- * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("cab", 0),
@@ -122,8 +102,7 @@ export const insert = TR.insert;
  *   Trie.insert("bca", 2)
  * )
  *
- * const result = Array.from(Trie.keys(trie))
- * assert.deepStrictEqual(result, ["abc", "bca", "cab"])
+ * Array.from(Trie.keys(trie)) // => ["abc", "bca", "cab"]
  * ```
  *
  * @category getters
@@ -139,9 +118,8 @@ export const keys = TR.keys;
  *
  * **Example** (Reading values by key order)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Trie } from "effect"
- * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("call", 0),
@@ -149,8 +127,7 @@ export const keys = TR.keys;
  *   Trie.insert("and", 2)
  * )
  *
- * const result = Array.from(Trie.values(trie))
- * assert.deepStrictEqual(result, [2, 0, 1])
+ * Array.from(Trie.values(trie)) // => [2, 0, 1]
  * ```
  *
  * @category getters
@@ -166,17 +143,15 @@ export const values = TR.values;
  *
  * **Example** (Reading entries in alphabetical order)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Trie } from "effect"
- * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("call", 0),
  *   Trie.insert("me", 1)
  * )
  *
- * const result = Array.from(Trie.entries(trie))
- * assert.deepStrictEqual(result, [["call", 0], ["me", 1]])
+ * Array.from(Trie.entries(trie)) // => [["call", 0], ["me", 1]]
  * ```
  *
  * @category getters
@@ -192,17 +167,14 @@ export const entries = TR.entries;
  *
  * **Example** (Converting entries to an array)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Trie } from "effect"
- * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("call", 0),
  *   Trie.insert("me", 1)
  * )
- * const result = Trie.toEntries(trie)
- *
- * assert.deepStrictEqual(result, [["call", 0], ["me", 1]])
+ * Trie.toEntries(trie) // => [["call", 0], ["me", 1]]
  * ```
  *
  * @category getters
@@ -215,9 +187,8 @@ export const toEntries = self => Array.from(entries(self));
  *
  * **Example** (Finding keys with a prefix)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Trie } from "effect"
- * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("she", 0),
@@ -226,8 +197,7 @@ export const toEntries = self => Array.from(entries(self));
  *   Trie.insert("shore", 3)
  * )
  *
- * const result = Array.from(Trie.keysWithPrefix(trie, "she"))
- * assert.deepStrictEqual(result, ["she", "shells"])
+ * Array.from(Trie.keysWithPrefix(trie, "she")) // => ["she", "shells"]
  * ```
  *
  * @category getters
@@ -240,9 +210,8 @@ export const keysWithPrefix = TR.keysWithPrefix;
  *
  * **Example** (Finding values with a prefix)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Trie } from "effect"
- * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("she", 0),
@@ -251,10 +220,7 @@ export const keysWithPrefix = TR.keysWithPrefix;
  *   Trie.insert("shore", 3)
  * )
  *
- * const result = Array.from(Trie.valuesWithPrefix(trie, "she"))
- *
- * // 0: "she", 1: "shells"
- * assert.deepStrictEqual(result, [0, 1])
+ * Array.from(Trie.valuesWithPrefix(trie, "she")) // => [0, 1]
  * ```
  *
  * @category getters
@@ -267,9 +233,8 @@ export const valuesWithPrefix = TR.valuesWithPrefix;
  *
  * **Example** (Finding entries with a prefix)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Trie } from "effect"
- * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("she", 0),
@@ -278,8 +243,7 @@ export const valuesWithPrefix = TR.valuesWithPrefix;
  *   Trie.insert("shore", 3)
  * )
  *
- * const result = Array.from(Trie.entriesWithPrefix(trie, "she"))
- * assert.deepStrictEqual(result, [["she", 0], ["shells", 1]])
+ * Array.from(Trie.entriesWithPrefix(trie, "she")) // => [["she", 0], ["shells", 1]]
  * ```
  *
  * @category getters
@@ -292,9 +256,8 @@ export const entriesWithPrefix = TR.entriesWithPrefix;
  *
  * **Example** (Converting prefixed entries to an array)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Trie } from "effect"
- * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("shells", 0),
@@ -303,8 +266,7 @@ export const entriesWithPrefix = TR.entriesWithPrefix;
  *   Trie.insert("she", 3)
  * )
  *
- * const result = Trie.toEntriesWithPrefix(trie, "she")
- * assert.deepStrictEqual(result, [["she", 3], ["shells", 0]])
+ * Trie.toEntriesWithPrefix(trie, "she") // => [["she", 3], ["shells", 0]]
  * ```
  *
  * @category getters
@@ -317,9 +279,8 @@ export const toEntriesWithPrefix = TR.toEntriesWithPrefix;
  *
  * **Example** (Finding the longest prefix)
  *
- * ```ts
- * import { Trie } from "effect"
- * import * as assert from "node:assert"
+ * ```ts import.meta.vitest
+ * import { Option, Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("shells", 0),
@@ -327,14 +288,8 @@ export const toEntriesWithPrefix = TR.toEntriesWithPrefix;
  *   Trie.insert("she", 2)
  * )
  *
- * const none = Trie.longestPrefixOf(trie, "sell")
- * const some = Trie.longestPrefixOf(trie, "sells")
- *
- * assert.equal(none._tag, "None")
- * assert.equal(some._tag, "Some")
- * if (some._tag === "Some") {
- *   assert.deepStrictEqual(some.value, ["sells", 1])
- * }
+ * Trie.longestPrefixOf(trie, "sell") // => Option.none()
+ * Trie.longestPrefixOf(trie, "sells") // => Option.some(["sells", 1])
  * ```
  *
  * @category getters
@@ -346,16 +301,15 @@ export const longestPrefixOf = TR.longestPrefixOf;
  *
  * **Example** (Getting the size)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Trie } from "effect"
- * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("a", 0),
  *   Trie.insert("b", 1)
  * )
  *
- * assert.equal(Trie.size(trie), 2)
+ * Trie.size(trie) // => 2
  * ```
  *
  * @category getters
@@ -367,9 +321,8 @@ export const size = TR.size;
  *
  * **Example** (Looking up values safely)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option, Trie } from "effect"
- * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("call", 0),
@@ -378,17 +331,17 @@ export const size = TR.size;
  *   Trie.insert("mid", 3)
  * )
  *
- * assert.deepStrictEqual(Trie.get(trie, "call"), Option.some(0))
- * assert.deepStrictEqual(Trie.get(trie, "me"), Option.some(1))
- * assert.deepStrictEqual(Trie.get(trie, "mind"), Option.some(2))
- * assert.deepStrictEqual(Trie.get(trie, "mid"), Option.some(3))
- * assert.deepStrictEqual(Trie.get(trie, "cale"), Option.none())
- * assert.deepStrictEqual(Trie.get(trie, "ma"), Option.none())
- * assert.deepStrictEqual(Trie.get(trie, "midn"), Option.none())
- * assert.deepStrictEqual(Trie.get(trie, "mea"), Option.none())
+ * Trie.get(trie, "call") // => Option.some(0)
+ * Trie.get(trie, "me") // => Option.some(1)
+ * Trie.get(trie, "mind") // => Option.some(2)
+ * Trie.get(trie, "mid") // => Option.some(3)
+ * Trie.get(trie, "cale") // => Option.none()
+ * Trie.get(trie, "ma") // => Option.none()
+ * Trie.get(trie, "midn") // => Option.none()
+ * Trie.get(trie, "mea") // => Option.none()
  * ```
  *
- * @category elements
+ * @category getters
  * @since 2.0.0
  */
 export const get = TR.get;
@@ -397,9 +350,8 @@ export const get = TR.get;
  *
  * **Example** (Checking key membership)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Trie } from "effect"
- * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("call", 0),
@@ -408,17 +360,17 @@ export const get = TR.get;
  *   Trie.insert("mid", 3)
  * )
  *
- * assert.equal(Trie.has(trie, "call"), true)
- * assert.equal(Trie.has(trie, "me"), true)
- * assert.equal(Trie.has(trie, "mind"), true)
- * assert.equal(Trie.has(trie, "mid"), true)
- * assert.equal(Trie.has(trie, "cale"), false)
- * assert.equal(Trie.has(trie, "ma"), false)
- * assert.equal(Trie.has(trie, "midn"), false)
- * assert.equal(Trie.has(trie, "mea"), false)
+ * Trie.has(trie, "call") // => true
+ * Trie.has(trie, "me") // => true
+ * Trie.has(trie, "mind") // => true
+ * Trie.has(trie, "mid") // => true
+ * Trie.has(trie, "cale") // => false
+ * Trie.has(trie, "ma") // => false
+ * Trie.has(trie, "midn") // => false
+ * Trie.has(trie, "mea") // => false
  * ```
  *
- * @category elements
+ * @category predicates
  * @since 2.0.0
  */
 export const has = TR.has;
@@ -427,18 +379,17 @@ export const has = TR.has;
  *
  * **Example** (Checking whether a trie is empty)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Trie } from "effect"
- * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>()
  * const trie1 = trie.pipe(Trie.insert("ma", 0))
  *
- * assert.equal(Trie.isEmpty(trie), true)
- * assert.equal(Trie.isEmpty(trie1), false)
+ * Trie.isEmpty(trie) // => true
+ * Trie.isEmpty(trie1) // => false
  * ```
  *
- * @category elements
+ * @category predicates
  * @since 2.0.0
  */
 export const isEmpty = TR.isEmpty;
@@ -457,16 +408,18 @@ export const isEmpty = TR.isEmpty;
  *
  * **Example** (Looking up values unsafely)
  *
- * ```ts
- * import { Trie } from "effect"
- * import * as assert from "node:assert"
+ * ```ts import.meta.vitest
+ * import { Result, Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("call", 0),
  *   Trie.insert("me", 1)
  * )
  *
- * assert.throws(() => Trie.getUnsafe(trie, "mae"))
+ * Result.try({
+ *   try: () => Trie.getUnsafe(trie, "mae"),
+ *   catch: (error) => (error as Error).message
+ * }) // => Result.fail("Expected trie to contain key")
  * ```
  *
  * @category unsafe
@@ -478,9 +431,8 @@ export const getUnsafe = TR.getUnsafe;
  *
  * **Example** (Removing entries)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Option, Trie } from "effect"
- * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("call", 0),
@@ -492,9 +444,9 @@ export const getUnsafe = TR.getUnsafe;
  * const trie1 = trie.pipe(Trie.remove("call"))
  * const trie2 = trie1.pipe(Trie.remove("mea"))
  *
- * assert.deepStrictEqual(Trie.get(trie, "call"), Option.some(0))
- * assert.deepStrictEqual(Trie.get(trie1, "call"), Option.none())
- * assert.deepStrictEqual(Trie.get(trie2, "call"), Option.none())
+ * Trie.get(trie, "call") // => Option.some(0)
+ * Trie.get(trie1, "call") // => Option.none()
+ * Trie.get(trie2, "call") // => Option.none()
  * ```
  *
  * @category mutations
@@ -506,9 +458,8 @@ export const remove = TR.remove;
  *
  * **Example** (Reducing entries)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Trie } from "effect"
- * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("shells", 0),
@@ -516,24 +467,9 @@ export const remove = TR.remove;
  *   Trie.insert("she", 2)
  * )
  *
- * assert.equal(
- *   trie.pipe(
- *     Trie.reduce(0, (acc, n) => acc + n)
- *   ),
- *   3
- * )
- * assert.equal(
- *   trie.pipe(
- *     Trie.reduce(10, (acc, n) => acc + n)
- *   ),
- *   13
- * )
- * assert.equal(
- *   trie.pipe(
- *     Trie.reduce("", (acc, _, key) => acc + key)
- *   ),
- *   "sellssheshells"
- * )
+ * trie.pipe(Trie.reduce(0, (acc, n) => acc + n)) // => 3
+ * trie.pipe(Trie.reduce(10, (acc, n) => acc + n)) // => 13
+ * trie.pipe(Trie.reduce("", (acc, _, key) => acc + key)) // => "sellssheshells"
  * ```
  *
  * @category folding
@@ -545,9 +481,8 @@ export const reduce = TR.reduce;
  *
  * **Example** (Mapping entries)
  *
- * ```ts
- * import { Equal, Trie } from "effect"
- * import * as assert from "node:assert"
+ * ```ts import.meta.vitest
+ * import { Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("shells", 0),
@@ -555,20 +490,8 @@ export const reduce = TR.reduce;
  *   Trie.insert("she", 2)
  * )
  *
- * const trieMapV = Trie.empty<number>().pipe(
- *   Trie.insert("shells", 1),
- *   Trie.insert("sells", 2),
- *   Trie.insert("she", 3)
- * )
- *
- * const trieMapK = Trie.empty<number>().pipe(
- *   Trie.insert("shells", 6),
- *   Trie.insert("sells", 5),
- *   Trie.insert("she", 3)
- * )
- *
- * assert.equal(Equal.equals(Trie.map(trie, (v) => v + 1), trieMapV), true)
- * assert.equal(Equal.equals(Trie.map(trie, (_, k) => k.length), trieMapK), true)
+ * Trie.map(trie, (v) => v + 1) // => Trie.make(["shells", 1], ["sells", 2], ["she", 3])
+ * Trie.map(trie, (_, k) => k.length) // => Trie.make(["shells", 6], ["sells", 5], ["she", 3])
  * ```
  *
  * @category folding
@@ -580,9 +503,8 @@ export const map = TR.map;
  *
  * **Example** (Filtering entries)
  *
- * ```ts
- * import { Equal, Trie } from "effect"
- * import * as assert from "node:assert"
+ * ```ts import.meta.vitest
+ * import { Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("shells", 0),
@@ -590,20 +512,8 @@ export const map = TR.map;
  *   Trie.insert("she", 2)
  * )
  *
- * const trieMapV = Trie.empty<number>().pipe(
- *   Trie.insert("she", 2)
- * )
- *
- * const trieMapK = Trie.empty<number>().pipe(
- *   Trie.insert("shells", 0),
- *   Trie.insert("sells", 1)
- * )
- *
- * assert.equal(Equal.equals(Trie.filter(trie, (v) => v > 1), trieMapV), true)
- * assert.equal(
- *   Equal.equals(Trie.filter(trie, (_, k) => k.length > 3), trieMapK),
- *   true
- * )
+ * Trie.filter(trie, (v) => v > 1) // => Trie.make(["she", 2])
+ * Trie.filter(trie, (_, k) => k.length > 3) // => Trie.make(["shells", 0], ["sells", 1])
  * ```
  *
  * @category filtering
@@ -616,9 +526,8 @@ export const filter = TR.filter;
  *
  * **Example** (Filtering and mapping entries)
  *
- * ```ts
- * import { Equal, Result, Trie } from "effect"
- * import * as assert from "node:assert"
+ * ```ts import.meta.vitest
+ * import { Result, Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("shells", 0),
@@ -626,32 +535,11 @@ export const filter = TR.filter;
  *   Trie.insert("she", 2)
  * )
  *
- * const trieMapV = Trie.empty<number>().pipe(
- *   Trie.insert("she", 2)
- * )
- *
- * const trieMapK = Trie.empty<number>().pipe(
- *   Trie.insert("shells", 0),
- *   Trie.insert("sells", 1)
- * )
- *
- * assert.equal(
- *   Equal.equals(
- *     Trie.filterMap(trie, (v) => v > 1 ? Result.succeed(v) : Result.failVoid),
- *     trieMapV
- *   ),
- *   true
- * )
- * assert.equal(
- *   Equal.equals(
- *     Trie.filterMap(
- *       trie,
- *       (v, k) => k.length > 3 ? Result.succeed(v) : Result.failVoid
- *     ),
- *     trieMapK
- *   ),
- *   true
- * )
+ * Trie.filterMap(trie, (v) => v > 1 ? Result.succeed(v) : Result.failVoid) // => Trie.make(["she", 2])
+ * Trie.filterMap(
+ *   trie,
+ *   (v, k) => k.length > 3 ? Result.succeed(v) : Result.failVoid
+ * ) // => Trie.make(["shells", 0], ["sells", 1])
  * ```
  *
  * @category filtering
@@ -663,9 +551,8 @@ export const filterMap = TR.filterMap;
  *
  * **Example** (Compacting optional values)
  *
- * ```ts
- * import { Equal, Option, Trie } from "effect"
- * import * as assert from "node:assert"
+ * ```ts import.meta.vitest
+ * import { Option, Trie } from "effect"
  *
  * const trie = Trie.empty<Option.Option<number>>().pipe(
  *   Trie.insert("shells", Option.some(0)),
@@ -673,12 +560,7 @@ export const filterMap = TR.filterMap;
  *   Trie.insert("she", Option.some(2))
  * )
  *
- * const trieMapV = Trie.empty<number>().pipe(
- *   Trie.insert("shells", 0),
- *   Trie.insert("she", 2)
- * )
- *
- * assert.equal(Equal.equals(Trie.compact(trie), trieMapV), true)
+ * Trie.compact(trie) // => Trie.make(["shells", 0], ["she", 2])
  * ```
  *
  * @category filtering
@@ -690,9 +572,8 @@ export const compact = TR.compact;
  *
  * **Example** (Iterating over entries)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Trie } from "effect"
- * import * as assert from "node:assert"
  *
  * let value = 0
  *
@@ -705,7 +586,7 @@ export const compact = TR.compact;
  *   })
  * )
  *
- * assert.equal(value, 17)
+ * value // => 17
  * ```
  *
  * @category traversing
@@ -717,9 +598,8 @@ export const forEach = TR.forEach;
  *
  * **Example** (Modifying an existing value)
  *
- * ```ts
- * import { Equal, Option, Trie } from "effect"
- * import * as assert from "node:assert"
+ * ```ts import.meta.vitest
+ * import { Option, Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("shells", 0),
@@ -727,12 +607,8 @@ export const forEach = TR.forEach;
  *   Trie.insert("she", 2)
  * )
  *
- * assert.deepStrictEqual(
- *   trie.pipe(Trie.modify("she", (v) => v + 10), Trie.get("she")),
- *   Option.some(12)
- * )
- *
- * assert.equal(Equal.equals(trie.pipe(Trie.modify("me", (v) => v)), trie), true)
+ * trie.pipe(Trie.modify("she", (v) => v + 10), Trie.get("she")) // => Option.some(12)
+ * trie.pipe(Trie.modify("me", (v) => v)) // => trie
  * ```
  *
  * @category mutations
@@ -744,9 +620,8 @@ export const modify = TR.modify;
  *
  * **Example** (Removing multiple entries)
  *
- * ```ts
- * import { Equal, Trie } from "effect"
- * import * as assert from "node:assert"
+ * ```ts import.meta.vitest
+ * import { Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
  *   Trie.insert("shells", 0),
@@ -754,13 +629,7 @@ export const modify = TR.modify;
  *   Trie.insert("she", 2)
  * )
  *
- * assert.equal(
- *   Equal.equals(
- *     trie.pipe(Trie.removeMany(["she", "sells"])),
- *     Trie.empty<number>().pipe(Trie.insert("shells", 0))
- *   ),
- *   true
- * )
+ * trie.pipe(Trie.removeMany(["she", "sells"])) // => Trie.make(["shells", 0])
  * ```
  *
  * @category mutations
@@ -772,27 +641,16 @@ export const removeMany = TR.removeMany;
  *
  * **Example** (Inserting multiple entries)
  *
- * ```ts
- * import { Equal, Trie } from "effect"
- * import * as assert from "node:assert"
+ * ```ts import.meta.vitest
+ * import { Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
- *   Trie.insert("shells", 0),
- *   Trie.insert("sells", 1),
- *   Trie.insert("she", 2)
+ *   Trie.insert("shells", 0)
  * )
  *
- * const trieInsert = Trie.empty<number>().pipe(
- *   Trie.insert("shells", 0),
- *   Trie.insertMany(
- *     [["sells", 1], ["she", 2]]
- *   )
- * )
- *
- * assert.equal(
- *   Equal.equals(trie, trieInsert),
- *   true
- * )
+ * trie.pipe(
+ *   Trie.insertMany([["sells", 1], ["she", 2]])
+ * ) // => Trie.make(["shells", 0], ["sells", 1], ["she", 2])
  * ```
  *
  * @category mutations