effect 3.10.18 → 3.11.0

package/src/Trie.ts

@@ -44,12 +44,14 @@ export interface Trie<in out Value> extends Iterable<[string, Value]>, Equal, Pi
  * Creates an empty `Trie`.
  *
  * @example
+ * ```ts
  * import { Trie, Equal } from "effect"
  *
  * const trie = Trie.empty<string>()
  *
  * assert.equal(Trie.size(trie), 0)
  * assert.deepStrictEqual(Array.from(trie), [])
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -60,6 +62,7 @@ export const empty: <V = never>() => Trie<V> = TR.empty
  * Creates a new `Trie` from an iterable collection of key/value pairs (e.g. `Array<[string, V]>`).
  *
  * @example
+ * ```ts
  * import { Trie, Equal } from "effect"
  *
  * const iterable: Array<readonly [string, number]> = [["call", 0], ["me", 1], ["mind", 2], ["mid", 3]]
@@ -68,6 +71,7 @@ export const empty: <V = never>() => Trie<V> = TR.empty
  * // 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)
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -78,12 +82,14 @@ export const fromIterable: <V>(entries: Iterable<readonly [string, V]>) => Trie<
  * Constructs a new `Trie` from the specified entries (`[string, V]`).
  *
  * @example
+ * ```ts
  * import { Trie, Equal } 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)
+ * ```
  *
  * @since 2.0.0
  * @category constructors
@@ -96,6 +102,7 @@ export const make: <Entries extends Array<readonly [string, any]>>(
  * Insert a new entry in the `Trie`.
  *
  * @example
+ * ```ts
  * import { Trie } from "effect"
  *
  * const trie1 = Trie.empty<number>().pipe(
@@ -109,6 +116,7 @@ export const make: <Entries extends Array<readonly [string, any]>>(
  * 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]])
+ * ```
  *
  * @since 2.0.0
  * @category mutations
@@ -118,6 +126,7 @@ export const insert: {
    * Insert a new entry in the `Trie`.
    *
    * @example
+   * ```ts
    * import { Trie } from "effect"
    *
    * const trie1 = Trie.empty<number>().pipe(
@@ -131,6 +140,7 @@ export const insert: {
    * 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]])
+   * ```
    *
    * @since 2.0.0
    * @category mutations
@@ -140,6 +150,7 @@ export const insert: {
    * Insert a new entry in the `Trie`.
    *
    * @example
+   * ```ts
    * import { Trie } from "effect"
    *
    * const trie1 = Trie.empty<number>().pipe(
@@ -153,6 +164,7 @@ export const insert: {
    * 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]])
+   * ```
    *
    * @since 2.0.0
    * @category mutations
@@ -166,6 +178,7 @@ export const insert: {
  * The keys are returned in alphabetical order, regardless of insertion order.
  *
  * @example
+ * ```ts
  * import { Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -176,6 +189,7 @@ export const insert: {
  *
  * const result = Array.from(Trie.keys(trie))
  * assert.deepStrictEqual(result, ["abc", "bca", "cab"])
+ * ```
  *
  * @since 2.0.0
  * @category getters
@@ -188,6 +202,7 @@ export const keys: <V>(self: Trie<V>) => IterableIterator<string> = TR.keys
  * Values are ordered based on their key in alphabetical order, regardless of insertion order.
  *
  * @example
+ * ```ts
  * import { Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -198,6 +213,7 @@ export const keys: <V>(self: Trie<V>) => IterableIterator<string> = TR.keys
  *
  * const result = Array.from(Trie.values(trie))
  * assert.deepStrictEqual(result, [2, 0, 1])
+ * ```
  *
  * @since 2.0.0
  * @category getters
@@ -210,6 +226,7 @@ export const values: <V>(self: Trie<V>) => IterableIterator<V> = TR.values
  * The entries are returned by keys in alphabetical order, regardless of insertion order.
  *
  * @example
+ * ```ts
  * import { Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -219,6 +236,7 @@ export const values: <V>(self: Trie<V>) => IterableIterator<V> = TR.values
  *
  * const result = Array.from(Trie.entries(trie))
  * assert.deepStrictEqual(result, [["call", 0], ["me", 1]])
+ * ```
  *
  * @since 2.0.0
  * @category getters
@@ -231,6 +249,7 @@ export const entries: <V>(self: Trie<V>) => IterableIterator<[string, V]> = TR.e
  * Equivalent to `Array.from(Trie.entries(trie))`.
  *
  * @example
+ * ```ts
  * import { Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -240,6 +259,7 @@ export const entries: <V>(self: Trie<V>) => IterableIterator<[string, V]> = TR.e
  * const result = Trie.toEntries(trie)
  *
  * assert.deepStrictEqual(result, [["call", 0], ["me", 1]])
+ * ```
  *
  * @since 2.0.0
  * @category getters
@@ -251,6 +271,7 @@ export const toEntries = <V>(self: Trie<V>): Array<[string, V]> => Array.from(en
  * that have `prefix` as prefix (`prefix` included if it exists).
  *
  * @example
+ * ```ts
  * import { Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -262,6 +283,7 @@ export const toEntries = <V>(self: Trie<V>): Array<[string, V]> => Array.from(en
  *
  * const result = Array.from(Trie.keysWithPrefix(trie, "she"))
  * assert.deepStrictEqual(result, ["she", "shells"])
+ * ```
  *
  * @since 2.0.0
  * @category getters
@@ -272,6 +294,7 @@ export const keysWithPrefix: {
    * that have `prefix` as prefix (`prefix` included if it exists).
    *
    * @example
+   * ```ts
    * import { Trie } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -283,6 +306,7 @@ export const keysWithPrefix: {
    *
    * const result = Array.from(Trie.keysWithPrefix(trie, "she"))
    * assert.deepStrictEqual(result, ["she", "shells"])
+   * ```
    *
    * @since 2.0.0
    * @category getters
@@ -293,6 +317,7 @@ export const keysWithPrefix: {
    * that have `prefix` as prefix (`prefix` included if it exists).
    *
    * @example
+   * ```ts
    * import { Trie } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -304,6 +329,7 @@ export const keysWithPrefix: {
    *
    * const result = Array.from(Trie.keysWithPrefix(trie, "she"))
    * assert.deepStrictEqual(result, ["she", "shells"])
+   * ```
    *
    * @since 2.0.0
    * @category getters
@@ -316,6 +342,7 @@ export const keysWithPrefix: {
  * that have `prefix` as prefix (`prefix` included if it exists).
  *
  * @example
+ * ```ts
  * import { Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -329,6 +356,7 @@ export const keysWithPrefix: {
  *
  * // 0: "she", 1: "shells"
  * assert.deepStrictEqual(result, [0, 1])
+ * ```
  *
  * @since 2.0.0
  * @category getters
@@ -339,6 +367,7 @@ export const valuesWithPrefix: {
    * that have `prefix` as prefix (`prefix` included if it exists).
    *
    * @example
+   * ```ts
    * import { Trie } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -352,6 +381,7 @@ export const valuesWithPrefix: {
    *
    * // 0: "she", 1: "shells"
    * assert.deepStrictEqual(result, [0, 1])
+   * ```
    *
    * @since 2.0.0
    * @category getters
@@ -362,6 +392,7 @@ export const valuesWithPrefix: {
    * that have `prefix` as prefix (`prefix` included if it exists).
    *
    * @example
+   * ```ts
    * import { Trie } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -375,6 +406,7 @@ export const valuesWithPrefix: {
    *
    * // 0: "she", 1: "shells"
    * assert.deepStrictEqual(result, [0, 1])
+   * ```
    *
    * @since 2.0.0
    * @category getters
@@ -387,6 +419,7 @@ export const valuesWithPrefix: {
  * that have `prefix` as prefix (`prefix` included if it exists).
  *
  * @example
+ * ```ts
  * import { Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -398,6 +431,7 @@ export const valuesWithPrefix: {
  *
  * const result = Array.from(Trie.entriesWithPrefix(trie, "she"))
  * assert.deepStrictEqual(result, [["she", 0], ["shells", 1]])
+ * ```
  *
  * @since 2.0.0
  * @category getters
@@ -408,6 +442,7 @@ export const entriesWithPrefix: {
    * that have `prefix` as prefix (`prefix` included if it exists).
    *
    * @example
+   * ```ts
    * import { Trie } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -419,6 +454,7 @@ export const entriesWithPrefix: {
    *
    * const result = Array.from(Trie.entriesWithPrefix(trie, "she"))
    * assert.deepStrictEqual(result, [["she", 0], ["shells", 1]])
+   * ```
    *
    * @since 2.0.0
    * @category getters
@@ -429,6 +465,7 @@ export const entriesWithPrefix: {
    * that have `prefix` as prefix (`prefix` included if it exists).
    *
    * @example
+   * ```ts
    * import { Trie } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -440,6 +477,7 @@ export const entriesWithPrefix: {
    *
    * const result = Array.from(Trie.entriesWithPrefix(trie, "she"))
    * assert.deepStrictEqual(result, [["she", 0], ["shells", 1]])
+   * ```
    *
    * @since 2.0.0
    * @category getters
@@ -452,6 +490,7 @@ export const entriesWithPrefix: {
  * that have `prefix` as prefix (`prefix` included if it exists).
  *
  * @example
+ * ```ts
  * import { Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -463,6 +502,7 @@ export const entriesWithPrefix: {
  *
  * const result = Trie.toEntriesWithPrefix(trie, "she")
  * assert.deepStrictEqual(result, [["she", 3], ["shells", 0]])
+ * ```
  *
  * @since 2.0.0
  * @category getters
@@ -473,6 +513,7 @@ export const toEntriesWithPrefix: {
    * that have `prefix` as prefix (`prefix` included if it exists).
    *
    * @example
+   * ```ts
    * import { Trie } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -484,6 +525,7 @@ export const toEntriesWithPrefix: {
    *
    * const result = Trie.toEntriesWithPrefix(trie, "she")
    * assert.deepStrictEqual(result, [["she", 3], ["shells", 0]])
+   * ```
    *
    * @since 2.0.0
    * @category getters
@@ -494,6 +536,7 @@ export const toEntriesWithPrefix: {
    * that have `prefix` as prefix (`prefix` included if it exists).
    *
    * @example
+   * ```ts
    * import { Trie } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -505,6 +548,7 @@ export const toEntriesWithPrefix: {
    *
    * const result = Trie.toEntriesWithPrefix(trie, "she")
    * assert.deepStrictEqual(result, [["she", 3], ["shells", 0]])
+   * ```
    *
    * @since 2.0.0
    * @category getters
@@ -517,6 +561,7 @@ export const toEntriesWithPrefix: {
  * that is a prefix of that `key` if it exists, `None` otherwise.
  *
  * @example
+ * ```ts
  * import { Trie, Option } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -529,6 +574,7 @@ export const toEntriesWithPrefix: {
  * assert.deepStrictEqual(Trie.longestPrefixOf(trie, "sells"), Option.some(["sells", 1]))
  * assert.deepStrictEqual(Trie.longestPrefixOf(trie, "shell"), Option.some(["she", 2]))
  * assert.deepStrictEqual(Trie.longestPrefixOf(trie, "shellsort"), Option.some(["shells", 0]))
+ * ```
  *
  * @since 2.0.0
  * @category getters
@@ -539,6 +585,7 @@ export const longestPrefixOf: {
    * that is a prefix of that `key` if it exists, `None` otherwise.
    *
    * @example
+   * ```ts
    * import { Trie, Option } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -551,6 +598,7 @@ export const longestPrefixOf: {
    * assert.deepStrictEqual(Trie.longestPrefixOf(trie, "sells"), Option.some(["sells", 1]))
    * assert.deepStrictEqual(Trie.longestPrefixOf(trie, "shell"), Option.some(["she", 2]))
    * assert.deepStrictEqual(Trie.longestPrefixOf(trie, "shellsort"), Option.some(["shells", 0]))
+   * ```
    *
    * @since 2.0.0
    * @category getters
@@ -561,6 +609,7 @@ export const longestPrefixOf: {
    * that is a prefix of that `key` if it exists, `None` otherwise.
    *
    * @example
+   * ```ts
    * import { Trie, Option } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -573,6 +622,7 @@ export const longestPrefixOf: {
    * assert.deepStrictEqual(Trie.longestPrefixOf(trie, "sells"), Option.some(["sells", 1]))
    * assert.deepStrictEqual(Trie.longestPrefixOf(trie, "shell"), Option.some(["she", 2]))
    * assert.deepStrictEqual(Trie.longestPrefixOf(trie, "shellsort"), Option.some(["shells", 0]))
+   * ```
    *
    * @since 2.0.0
    * @category getters
@@ -584,6 +634,7 @@ export const longestPrefixOf: {
  * Returns the size of the `Trie` (number of entries in the `Trie`).
  *
  * @example
+ * ```ts
  * import { Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -592,6 +643,7 @@ export const longestPrefixOf: {
  * )
  *
  * assert.equal(Trie.size(trie), 2)
+ * ```
  *
  * @since 2.0.0
  * @category getters
@@ -602,6 +654,7 @@ export const size: <V>(self: Trie<V>) => number = TR.size
  * Safely lookup the value for the specified key in the `Trie`.
  *
  * @example
+ * ```ts
  * import { Trie, Option } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -619,6 +672,7 @@ export const size: <V>(self: Trie<V>) => number = TR.size
  * assert.deepStrictEqual(Trie.get(trie, "ma"), Option.none())
  * assert.deepStrictEqual(Trie.get(trie, "midn"), Option.none())
  * assert.deepStrictEqual(Trie.get(trie, "mea"), Option.none())
+ * ```
  *
  * @since 2.0.0
  * @category elements
@@ -628,6 +682,7 @@ export const get: {
    * Safely lookup the value for the specified key in the `Trie`.
    *
    * @example
+   * ```ts
    * import { Trie, Option } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -645,6 +700,7 @@ export const get: {
    * assert.deepStrictEqual(Trie.get(trie, "ma"), Option.none())
    * assert.deepStrictEqual(Trie.get(trie, "midn"), Option.none())
    * assert.deepStrictEqual(Trie.get(trie, "mea"), Option.none())
+   * ```
    *
    * @since 2.0.0
    * @category elements
@@ -654,6 +710,7 @@ export const get: {
    * Safely lookup the value for the specified key in the `Trie`.
    *
    * @example
+   * ```ts
    * import { Trie, Option } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -671,6 +728,7 @@ export const get: {
    * assert.deepStrictEqual(Trie.get(trie, "ma"), Option.none())
    * assert.deepStrictEqual(Trie.get(trie, "midn"), Option.none())
    * assert.deepStrictEqual(Trie.get(trie, "mea"), Option.none())
+   * ```
    *
    * @since 2.0.0
    * @category elements
@@ -682,6 +740,7 @@ export const get: {
  * Check if the given key exists in the `Trie`.
  *
  * @example
+ * ```ts
  * import { Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -699,6 +758,7 @@ export const get: {
  * assert.equal(Trie.has(trie, "ma"), false)
  * assert.equal(Trie.has(trie, "midn"), false)
  * assert.equal(Trie.has(trie, "mea"), false)
+ * ```
  *
  * @since 2.0.0
  * @category elements
@@ -708,6 +768,7 @@ export const has: {
    * Check if the given key exists in the `Trie`.
    *
    * @example
+   * ```ts
    * import { Trie } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -725,6 +786,7 @@ export const has: {
    * assert.equal(Trie.has(trie, "ma"), false)
    * assert.equal(Trie.has(trie, "midn"), false)
    * assert.equal(Trie.has(trie, "mea"), false)
+   * ```
    *
    * @since 2.0.0
    * @category elements
@@ -734,6 +796,7 @@ export const has: {
    * Check if the given key exists in the `Trie`.
    *
    * @example
+   * ```ts
    * import { Trie } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -751,6 +814,7 @@ export const has: {
    * assert.equal(Trie.has(trie, "ma"), false)
    * assert.equal(Trie.has(trie, "midn"), false)
    * assert.equal(Trie.has(trie, "mea"), false)
+   * ```
    *
    * @since 2.0.0
    * @category elements
@@ -762,6 +826,7 @@ export const has: {
  * Checks if the `Trie` contains any entries.
  *
  * @example
+ * ```ts
  * import { Trie } from "effect"
  *
  * const trie = Trie.empty<number>()
@@ -769,6 +834,7 @@ export const has: {
  *
  * assert.equal(Trie.isEmpty(trie), true)
  * assert.equal(Trie.isEmpty(trie1), false)
+ * ```
  *
  * @since 2.0.0
  * @category elements
@@ -782,6 +848,7 @@ export const isEmpty: <V>(self: Trie<V>) => boolean = TR.isEmpty
  * get a value from the `Trie`.
  *
  * @example
+ * ```ts
  * import { Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -790,6 +857,7 @@ export const isEmpty: <V>(self: Trie<V>) => boolean = TR.isEmpty
  * )
  *
  * assert.throws(() => Trie.unsafeGet(trie, "mae"))
+ * ```
  *
  * @since 2.0.0
  * @category unsafe
@@ -802,6 +870,7 @@ export const unsafeGet: {
    * get a value from the `Trie`.
    *
    * @example
+   * ```ts
    * import { Trie } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -810,6 +879,7 @@ export const unsafeGet: {
    * )
    *
    * assert.throws(() => Trie.unsafeGet(trie, "mae"))
+   * ```
    *
    * @since 2.0.0
    * @category unsafe
@@ -822,6 +892,7 @@ export const unsafeGet: {
    * get a value from the `Trie`.
    *
    * @example
+   * ```ts
    * import { Trie } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -830,6 +901,7 @@ export const unsafeGet: {
    * )
    *
    * assert.throws(() => Trie.unsafeGet(trie, "mae"))
+   * ```
    *
    * @since 2.0.0
    * @category unsafe
@@ -841,6 +913,7 @@ export const unsafeGet: {
  * Remove the entry for the specified key in the `Trie`.
  *
  * @example
+ * ```ts
  * import { Trie, Option } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -856,6 +929,7 @@ export const unsafeGet: {
  * 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())
+ * ```
  *
  * @since 2.0.0
  * @category mutations
@@ -865,6 +939,7 @@ export const remove: {
    * Remove the entry for the specified key in the `Trie`.
    *
    * @example
+   * ```ts
    * import { Trie, Option } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -880,6 +955,7 @@ export const remove: {
    * 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())
+   * ```
    *
    * @since 2.0.0
    * @category mutations
@@ -889,6 +965,7 @@ export const remove: {
    * Remove the entry for the specified key in the `Trie`.
    *
    * @example
+   * ```ts
    * import { Trie, Option } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -904,6 +981,7 @@ export const remove: {
    * 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())
+   * ```
    *
    * @since 2.0.0
    * @category mutations
@@ -915,6 +993,7 @@ export const remove: {
  * Reduce a state over the entries of the `Trie`.
  *
  * @example
+ * ```ts
  * import { Trie } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -941,6 +1020,7 @@ export const remove: {
  *   ),
  *   "sellssheshells"
  * )
+ * ```
  *
  * @since 2.0.0
  * @category folding
@@ -950,6 +1030,7 @@ export const reduce: {
    * Reduce a state over the entries of the `Trie`.
    *
    * @example
+   * ```ts
    * import { Trie } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -976,6 +1057,7 @@ export const reduce: {
    *   ),
    *   "sellssheshells"
    * )
+   * ```
    *
    * @since 2.0.0
    * @category folding
@@ -985,6 +1067,7 @@ export const reduce: {
    * Reduce a state over the entries of the `Trie`.
    *
    * @example
+   * ```ts
    * import { Trie } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1011,6 +1094,7 @@ export const reduce: {
    *   ),
    *   "sellssheshells"
    * )
+   * ```
    *
    * @since 2.0.0
    * @category folding
@@ -1022,6 +1106,7 @@ export const reduce: {
  * Maps over the entries of the `Trie` using the specified function.
  *
  * @example
+ * ```ts
  * import { Trie, Equal } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -1044,6 +1129,7 @@ export const reduce: {
  *
  * assert.equal(Equal.equals(Trie.map(trie, (v) => v + 1), trieMapV), true)
  * assert.equal(Equal.equals(Trie.map(trie, (_, k) => k.length), trieMapK), true)
+ * ```
  *
  * @since 2.0.0
  * @category folding
@@ -1053,6 +1139,7 @@ export const map: {
    * Maps over the entries of the `Trie` using the specified function.
    *
    * @example
+   * ```ts
    * import { Trie, Equal } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1075,6 +1162,7 @@ export const map: {
    *
    * assert.equal(Equal.equals(Trie.map(trie, (v) => v + 1), trieMapV), true)
    * assert.equal(Equal.equals(Trie.map(trie, (_, k) => k.length), trieMapK), true)
+   * ```
    *
    * @since 2.0.0
    * @category folding
@@ -1084,6 +1172,7 @@ export const map: {
    * Maps over the entries of the `Trie` using the specified function.
    *
    * @example
+   * ```ts
    * import { Trie, Equal } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1106,6 +1195,7 @@ export const map: {
    *
    * assert.equal(Equal.equals(Trie.map(trie, (v) => v + 1), trieMapV), true)
    * assert.equal(Equal.equals(Trie.map(trie, (_, k) => k.length), trieMapK), true)
+   * ```
    *
    * @since 2.0.0
    * @category folding
@@ -1117,6 +1207,7 @@ export const map: {
  * Filters entries out of a `Trie` using the specified predicate.
  *
  * @example
+ * ```ts
  * import { Trie, Equal } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -1136,6 +1227,7 @@ export const map: {
  *
  * 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)
+ * ```
  *
  * @since 2.0.0
  * @category filtering
@@ -1145,6 +1237,7 @@ export const filter: {
    * Filters entries out of a `Trie` using the specified predicate.
    *
    * @example
+   * ```ts
    * import { Trie, Equal } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1164,6 +1257,7 @@ export const filter: {
    *
    * 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)
+   * ```
    *
    * @since 2.0.0
    * @category filtering
@@ -1173,6 +1267,7 @@ export const filter: {
    * Filters entries out of a `Trie` using the specified predicate.
    *
    * @example
+   * ```ts
    * import { Trie, Equal } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1192,6 +1287,7 @@ export const filter: {
    *
    * 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)
+   * ```
    *
    * @since 2.0.0
    * @category filtering
@@ -1201,6 +1297,7 @@ export const filter: {
    * Filters entries out of a `Trie` using the specified predicate.
    *
    * @example
+   * ```ts
    * import { Trie, Equal } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1220,6 +1317,7 @@ export const filter: {
    *
    * 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)
+   * ```
    *
    * @since 2.0.0
    * @category filtering
@@ -1229,6 +1327,7 @@ export const filter: {
    * Filters entries out of a `Trie` using the specified predicate.
    *
    * @example
+   * ```ts
    * import { Trie, Equal } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1248,6 +1347,7 @@ export const filter: {
    *
    * 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)
+   * ```
    *
    * @since 2.0.0
    * @category filtering
@@ -1260,6 +1360,7 @@ export const filter: {
  * and filters out `None` values.
  *
  * @example
+ * ```ts
  * import { Trie, Equal, Option } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -1282,6 +1383,7 @@ export const filter: {
  *   Equal.equals(Trie.filterMap(trie, (v, k) => k.length > 3 ? Option.some(v) : Option.none()), trieMapK),
  *   true
  * )
+ * ```
  *
  * @since 2.0.0
  * @category filtering
@@ -1292,6 +1394,7 @@ export const filterMap: {
    * and filters out `None` values.
    *
    * @example
+   * ```ts
    * import { Trie, Equal, Option } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1314,6 +1417,7 @@ export const filterMap: {
    *   Equal.equals(Trie.filterMap(trie, (v, k) => k.length > 3 ? Option.some(v) : Option.none()), trieMapK),
    *   true
    * )
+   * ```
    *
    * @since 2.0.0
    * @category filtering
@@ -1324,6 +1428,7 @@ export const filterMap: {
    * and filters out `None` values.
    *
    * @example
+   * ```ts
    * import { Trie, Equal, Option } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1346,6 +1451,7 @@ export const filterMap: {
    *   Equal.equals(Trie.filterMap(trie, (v, k) => k.length > 3 ? Option.some(v) : Option.none()), trieMapK),
    *   true
    * )
+   * ```
    *
    * @since 2.0.0
    * @category filtering
@@ -1357,6 +1463,7 @@ export const filterMap: {
  * Filters out `None` values from a `Trie` of `Options`s.
  *
  * @example
+ * ```ts
  * import { Trie, Equal, Option } from "effect"
  *
  * const trie = Trie.empty<Option.Option<number>>().pipe(
@@ -1371,6 +1478,7 @@ export const filterMap: {
  * )
  *
  * assert.equal(Equal.equals(Trie.compact(trie), trieMapV), true)
+ * ```
  *
  * @since 2.0.0
  * @category filtering
@@ -1381,6 +1489,7 @@ export const compact: <A>(self: Trie<Option<A>>) => Trie<A> = TR.compact
  * Applies the specified function to the entries of the `Trie`.
  *
  * @example
+ * ```ts
  * import { Trie } from "effect"
  *
  * let value = 0
@@ -1395,6 +1504,7 @@ export const compact: <A>(self: Trie<Option<A>>) => Trie<A> = TR.compact
  * )
  *
  * assert.equal(value, 17)
+ * ```
  *
  * @since 2.0.0
  * @category traversing
@@ -1404,6 +1514,7 @@ export const forEach: {
    * Applies the specified function to the entries of the `Trie`.
    *
    * @example
+   * ```ts
    * import { Trie } from "effect"
    *
    * let value = 0
@@ -1418,6 +1529,7 @@ export const forEach: {
    * )
    *
    * assert.equal(value, 17)
+   * ```
    *
    * @since 2.0.0
    * @category traversing
@@ -1427,6 +1539,7 @@ export const forEach: {
    * Applies the specified function to the entries of the `Trie`.
    *
    * @example
+   * ```ts
    * import { Trie } from "effect"
    *
    * let value = 0
@@ -1441,6 +1554,7 @@ export const forEach: {
    * )
    *
    * assert.equal(value, 17)
+   * ```
    *
    * @since 2.0.0
    * @category traversing
@@ -1452,6 +1566,7 @@ export const forEach: {
  * Updates the value of the specified key within the `Trie` if it exists.
  *
  * @example
+ * ```ts
  * import { Trie, Equal, Option } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -1463,6 +1578,7 @@ export const forEach: {
  * 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)
+ * ```
  *
  * @since 2.0.0
  * @category mutations
@@ -1472,6 +1588,7 @@ export const modify: {
    * Updates the value of the specified key within the `Trie` if it exists.
    *
    * @example
+   * ```ts
    * import { Trie, Equal, Option } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1483,6 +1600,7 @@ export const modify: {
    * 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)
+   * ```
    *
    * @since 2.0.0
    * @category mutations
@@ -1492,6 +1610,7 @@ export const modify: {
    * Updates the value of the specified key within the `Trie` if it exists.
    *
    * @example
+   * ```ts
    * import { Trie, Equal, Option } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1503,6 +1622,7 @@ export const modify: {
    * 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)
+   * ```
    *
    * @since 2.0.0
    * @category mutations
@@ -1514,6 +1634,7 @@ export const modify: {
  * Removes all entries in the `Trie` which have the specified keys.
  *
  * @example
+ * ```ts
  * import { Trie, Equal } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -1526,6 +1647,7 @@ export const modify: {
  *   Equal.equals(trie.pipe(Trie.removeMany(["she", "sells"])), Trie.empty<number>().pipe(Trie.insert("shells", 0))),
  *   true
  * )
+ * ```
  *
  * @since 2.0.0
  * @category mutations
@@ -1535,6 +1657,7 @@ export const removeMany: {
    * Removes all entries in the `Trie` which have the specified keys.
    *
    * @example
+   * ```ts
    * import { Trie, Equal } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1547,6 +1670,7 @@ export const removeMany: {
    *   Equal.equals(trie.pipe(Trie.removeMany(["she", "sells"])), Trie.empty<number>().pipe(Trie.insert("shells", 0))),
    *   true
    * )
+   * ```
    *
    * @since 2.0.0
    * @category mutations
@@ -1556,6 +1680,7 @@ export const removeMany: {
    * Removes all entries in the `Trie` which have the specified keys.
    *
    * @example
+   * ```ts
    * import { Trie, Equal } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1568,6 +1693,7 @@ export const removeMany: {
    *   Equal.equals(trie.pipe(Trie.removeMany(["she", "sells"])), Trie.empty<number>().pipe(Trie.insert("shells", 0))),
    *   true
    * )
+   * ```
    *
    * @since 2.0.0
    * @category mutations
@@ -1579,6 +1705,7 @@ export const removeMany: {
  * Insert multiple entries in the `Trie` at once.
  *
  * @example
+ * ```ts
  * import { Trie, Equal } from "effect"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -1598,6 +1725,7 @@ export const removeMany: {
  *   Equal.equals(trie, trieInsert),
  *   true
  * )
+ * ```
  *
  * @since 2.0.0
  * @category mutations
@@ -1607,6 +1735,7 @@ export const insertMany: {
    * Insert multiple entries in the `Trie` at once.
    *
    * @example
+   * ```ts
    * import { Trie, Equal } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1626,6 +1755,7 @@ export const insertMany: {
    *   Equal.equals(trie, trieInsert),
    *   true
    * )
+   * ```
    *
    * @since 2.0.0
    * @category mutations
@@ -1635,6 +1765,7 @@ export const insertMany: {
    * Insert multiple entries in the `Trie` at once.
    *
    * @example
+   * ```ts
    * import { Trie, Equal } from "effect"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1654,6 +1785,7 @@ export const insertMany: {
    *   Equal.equals(trie, trieInsert),
    *   true
    * )
+   * ```
    *
    * @since 2.0.0
    * @category mutations