effect 4.0.0-beta.67 → 4.0.0-beta.68

package/src/Trie.ts

@@ -33,7 +33,7 @@ const TypeId = TR.TrieTypeId
  * **Example** (Using a trie for prefix search)
  *
  * ```ts
- * import * as Trie from "effect/Trie"
+ * import { Trie } from "effect"
  *
  * // Create a trie with string-to-number mappings
  * const trie: Trie.Trie<number> = Trie.make(
@@ -79,7 +79,7 @@ export interface Trie<in out Value> extends Iterable<[string, Value]>, Equal, Pi
  * **Example** (Creating an empty trie)
  *
  * ```ts
- * import * as Trie from "effect/Trie"
+ * import { Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<string>()
@@ -99,8 +99,7 @@ export const empty: <V = never>() => Trie<V> = TR.empty
  * **Example** (Creating a trie from entries)
  *
  * ```ts
- * import * as Equal from "effect/Equal"
- * import * as Trie from "effect/Trie"
+ * import { Equal, Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const iterable: Array<readonly [string, number]> = [["call", 0], ["me", 1], [
@@ -134,8 +133,7 @@ export const fromIterable: <V>(entries: Iterable<readonly [string, V]>) => Trie<
  * **Example** (Constructing a trie from entries)
  *
  * ```ts
- * import * as Equal from "effect/Equal"
- * import * as Trie from "effect/Trie"
+ * import { Equal, Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.make(["ca", 0], ["me", 1])
@@ -160,7 +158,7 @@ export const make: <Entries extends Array<readonly [string, any]>>(
  * **Example** (Inserting entries)
  *
  * ```ts
- * import * as Trie from "effect/Trie"
+ * import { Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie1 = Trie.empty<number>().pipe(
@@ -189,7 +187,7 @@ export const insert: {
    * **Example** (Inserting entries)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie1 = Trie.empty<number>().pipe(
@@ -218,7 +216,7 @@ export const insert: {
    * **Example** (Inserting entries)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie1 = Trie.empty<number>().pipe(
@@ -251,7 +249,7 @@ export const insert: {
  * **Example** (Reading keys in alphabetical order)
  *
  * ```ts
- * import * as Trie from "effect/Trie"
+ * import { Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -277,7 +275,7 @@ export const keys: <V>(self: Trie<V>) => IterableIterator<string> = TR.keys
  * **Example** (Reading values by key order)
  *
  * ```ts
- * import * as Trie from "effect/Trie"
+ * import { Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -303,7 +301,7 @@ export const values: <V>(self: Trie<V>) => IterableIterator<V> = TR.values
  * **Example** (Reading entries in alphabetical order)
  *
  * ```ts
- * import * as Trie from "effect/Trie"
+ * import { Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -328,7 +326,7 @@ export const entries: <V>(self: Trie<V>) => IterableIterator<[string, V]> = TR.e
  * **Example** (Converting entries to an array)
  *
  * ```ts
- * import * as Trie from "effect/Trie"
+ * import { Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -352,7 +350,7 @@ export const toEntries = <V>(self: Trie<V>): Array<[string, V]> => Array.from(en
  * **Example** (Finding keys with a prefix)
  *
  * ```ts
- * import * as Trie from "effect/Trie"
+ * import { Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -377,7 +375,7 @@ export const keysWithPrefix: {
    * **Example** (Finding keys with a prefix)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -402,7 +400,7 @@ export const keysWithPrefix: {
    * **Example** (Finding keys with a prefix)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -429,7 +427,7 @@ export const keysWithPrefix: {
  * **Example** (Finding values with a prefix)
  *
  * ```ts
- * import * as Trie from "effect/Trie"
+ * import { Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -456,7 +454,7 @@ export const valuesWithPrefix: {
    * **Example** (Finding values with a prefix)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -483,7 +481,7 @@ export const valuesWithPrefix: {
    * **Example** (Finding values with a prefix)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -512,7 +510,7 @@ export const valuesWithPrefix: {
  * **Example** (Finding entries with a prefix)
  *
  * ```ts
- * import * as Trie from "effect/Trie"
+ * import { Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -537,7 +535,7 @@ export const entriesWithPrefix: {
    * **Example** (Finding entries with a prefix)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -562,7 +560,7 @@ export const entriesWithPrefix: {
    * **Example** (Finding entries with a prefix)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -589,7 +587,7 @@ export const entriesWithPrefix: {
  * **Example** (Converting prefixed entries to an array)
  *
  * ```ts
- * import * as Trie from "effect/Trie"
+ * import { Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -614,7 +612,7 @@ export const toEntriesWithPrefix: {
    * **Example** (Converting prefixed entries to an array)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -639,7 +637,7 @@ export const toEntriesWithPrefix: {
    * **Example** (Converting prefixed entries to an array)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -666,7 +664,7 @@ export const toEntriesWithPrefix: {
  * **Example** (Finding the longest prefix)
  *
  * ```ts
- * import * as Trie from "effect/Trie"
+ * import { Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -696,7 +694,7 @@ export const longestPrefixOf: {
    * **Example** (Finding the longest prefix)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -726,7 +724,7 @@ export const longestPrefixOf: {
    * **Example** (Finding the longest prefix)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -757,7 +755,7 @@ export const longestPrefixOf: {
  * **Example** (Getting the size)
  *
  * ```ts
- * import * as Trie from "effect/Trie"
+ * import { Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -779,8 +777,7 @@ export const size: <V>(self: Trie<V>) => number = TR.size
  * **Example** (Looking up values safely)
  *
  * ```ts
- * import * as Option from "effect/Option"
- * import * as Trie from "effect/Trie"
+ * import { Option, Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -810,8 +807,7 @@ export const get: {
    * **Example** (Looking up values safely)
    *
    * ```ts
-   * import * as Option from "effect/Option"
-   * import * as Trie from "effect/Trie"
+   * import { Option, Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -841,8 +837,7 @@ export const get: {
    * **Example** (Looking up values safely)
    *
    * ```ts
-   * import * as Option from "effect/Option"
-   * import * as Trie from "effect/Trie"
+   * import { Option, Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -874,7 +869,7 @@ export const get: {
  * **Example** (Checking key membership)
  *
  * ```ts
- * import * as Trie from "effect/Trie"
+ * import { Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -904,7 +899,7 @@ export const has: {
    * **Example** (Checking key membership)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -934,7 +929,7 @@ export const has: {
    * **Example** (Checking key membership)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -966,7 +961,7 @@ export const has: {
  * **Example** (Checking whether a trie is empty)
  *
  * ```ts
- * import * as Trie from "effect/Trie"
+ * import { Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>()
@@ -990,7 +985,7 @@ export const isEmpty: <V>(self: Trie<V>) => boolean = TR.isEmpty
  * **Example** (Looking up values unsafely)
  *
  * ```ts
- * import * as Trie from "effect/Trie"
+ * import { Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -1002,7 +997,7 @@ export const isEmpty: <V>(self: Trie<V>) => boolean = TR.isEmpty
  * ```
  *
  * @category unsafe
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const getUnsafe: {
   /**
@@ -1014,7 +1009,7 @@ export const getUnsafe: {
    * **Example** (Looking up values unsafely)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1026,7 +1021,7 @@ export const getUnsafe: {
    * ```
    *
    * @category unsafe
-   * @since 2.0.0
+   * @since 4.0.0
    */
   (key: string): <V>(self: Trie<V>) => V
   /**
@@ -1038,7 +1033,7 @@ export const getUnsafe: {
    * **Example** (Looking up values unsafely)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1050,7 +1045,7 @@ export const getUnsafe: {
    * ```
    *
    * @category unsafe
-   * @since 2.0.0
+   * @since 4.0.0
    */
   <V>(self: Trie<V>, key: string): V
 } = TR.getUnsafe
@@ -1061,8 +1056,7 @@ export const getUnsafe: {
  * **Example** (Removing entries)
  *
  * ```ts
- * import * as Option from "effect/Option"
- * import * as Trie from "effect/Trie"
+ * import { Option, Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -1090,8 +1084,7 @@ export const remove: {
    * **Example** (Removing entries)
    *
    * ```ts
-   * import * as Option from "effect/Option"
-   * import * as Trie from "effect/Trie"
+   * import { Option, Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1119,8 +1112,7 @@ export const remove: {
    * **Example** (Removing entries)
    *
    * ```ts
-   * import * as Option from "effect/Option"
-   * import * as Trie from "effect/Trie"
+   * import { Option, Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1150,7 +1142,7 @@ export const remove: {
  * **Example** (Reducing entries)
  *
  * ```ts
- * import * as Trie from "effect/Trie"
+ * import { Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -1189,7 +1181,7 @@ export const reduce: {
    * **Example** (Reducing entries)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1228,7 +1220,7 @@ export const reduce: {
    * **Example** (Reducing entries)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1269,8 +1261,7 @@ export const reduce: {
  * **Example** (Mapping entries)
  *
  * ```ts
- * import * as Equal from "effect/Equal"
- * import * as Trie from "effect/Trie"
+ * import { Equal, Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -1305,8 +1296,7 @@ export const map: {
    * **Example** (Mapping entries)
    *
    * ```ts
-   * import * as Equal from "effect/Equal"
-   * import * as Trie from "effect/Trie"
+   * import { Equal, Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1341,8 +1331,7 @@ export const map: {
    * **Example** (Mapping entries)
    *
    * ```ts
-   * import * as Equal from "effect/Equal"
-   * import * as Trie from "effect/Trie"
+   * import { Equal, Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1379,8 +1368,7 @@ export const map: {
  * **Example** (Filtering entries)
  *
  * ```ts
- * import * as Equal from "effect/Equal"
- * import * as Trie from "effect/Trie"
+ * import { Equal, Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -1415,8 +1403,7 @@ export const filter: {
    * **Example** (Filtering entries)
    *
    * ```ts
-   * import * as Equal from "effect/Equal"
-   * import * as Trie from "effect/Trie"
+   * import { Equal, Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1451,8 +1438,7 @@ export const filter: {
    * **Example** (Filtering entries)
    *
    * ```ts
-   * import * as Equal from "effect/Equal"
-   * import * as Trie from "effect/Trie"
+   * import { Equal, Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1487,8 +1473,7 @@ export const filter: {
    * **Example** (Filtering entries)
    *
    * ```ts
-   * import * as Equal from "effect/Equal"
-   * import * as Trie from "effect/Trie"
+   * import { Equal, Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1523,8 +1508,7 @@ export const filter: {
    * **Example** (Filtering entries)
    *
    * ```ts
-   * import * as Equal from "effect/Equal"
-   * import * as Trie from "effect/Trie"
+   * import { Equal, Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1562,9 +1546,7 @@ export const filter: {
  * **Example** (Filtering and mapping entries)
  *
  * ```ts
- * import * as Equal from "effect/Equal"
- * import * as Result from "effect/Result"
- * import * as Trie from "effect/Trie"
+ * import { Equal, Result, Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -1612,9 +1594,7 @@ export const filterMap: {
    * **Example** (Filtering and mapping entries)
    *
    * ```ts
-   * import * as Equal from "effect/Equal"
-   * import * as Result from "effect/Result"
-   * import * as Trie from "effect/Trie"
+   * import { Equal, Result, Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1662,9 +1642,7 @@ export const filterMap: {
    * **Example** (Filtering and mapping entries)
    *
    * ```ts
-   * import * as Equal from "effect/Equal"
-   * import * as Result from "effect/Result"
-   * import * as Trie from "effect/Trie"
+   * import { Equal, Result, Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1713,9 +1691,7 @@ export const filterMap: {
  * **Example** (Compacting optional values)
  *
  * ```ts
- * import * as Equal from "effect/Equal"
- * import * as Option from "effect/Option"
- * import * as Trie from "effect/Trie"
+ * import { Equal, Option, Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<Option.Option<number>>().pipe(
@@ -1743,7 +1719,7 @@ export const compact: <A>(self: Trie<Option<A>>) => Trie<A> = TR.compact
  * **Example** (Iterating over entries)
  *
  * ```ts
- * import * as Trie from "effect/Trie"
+ * import { Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * let value = 0
@@ -1770,7 +1746,7 @@ export const forEach: {
    * **Example** (Iterating over entries)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * let value = 0
@@ -1797,7 +1773,7 @@ export const forEach: {
    * **Example** (Iterating over entries)
    *
    * ```ts
-   * import * as Trie from "effect/Trie"
+   * import { Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * let value = 0
@@ -1826,9 +1802,7 @@ export const forEach: {
  * **Example** (Modifying an existing value)
  *
  * ```ts
- * import * as Equal from "effect/Equal"
- * import * as Option from "effect/Option"
- * import * as Trie from "effect/Trie"
+ * import { Equal, Option, Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -1855,9 +1829,7 @@ export const modify: {
    * **Example** (Modifying an existing value)
    *
    * ```ts
-   * import * as Equal from "effect/Equal"
-   * import * as Option from "effect/Option"
-   * import * as Trie from "effect/Trie"
+   * import { Equal, Option, Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1884,9 +1856,7 @@ export const modify: {
    * **Example** (Modifying an existing value)
    *
    * ```ts
-   * import * as Equal from "effect/Equal"
-   * import * as Option from "effect/Option"
-   * import * as Trie from "effect/Trie"
+   * import { Equal, Option, Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1915,8 +1885,7 @@ export const modify: {
  * **Example** (Removing multiple entries)
  *
  * ```ts
- * import * as Equal from "effect/Equal"
- * import * as Trie from "effect/Trie"
+ * import { Equal, Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -1944,8 +1913,7 @@ export const removeMany: {
    * **Example** (Removing multiple entries)
    *
    * ```ts
-   * import * as Equal from "effect/Equal"
-   * import * as Trie from "effect/Trie"
+   * import { Equal, Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -1973,8 +1941,7 @@ export const removeMany: {
    * **Example** (Removing multiple entries)
    *
    * ```ts
-   * import * as Equal from "effect/Equal"
-   * import * as Trie from "effect/Trie"
+   * import { Equal, Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -2004,8 +1971,7 @@ export const removeMany: {
  * **Example** (Inserting multiple entries)
  *
  * ```ts
- * import * as Equal from "effect/Equal"
- * import * as Trie from "effect/Trie"
+ * import { Equal, Trie } from "effect"
  * import * as assert from "node:assert"
  *
  * const trie = Trie.empty<number>().pipe(
@@ -2037,8 +2003,7 @@ export const insertMany: {
    * **Example** (Inserting multiple entries)
    *
    * ```ts
-   * import * as Equal from "effect/Equal"
-   * import * as Trie from "effect/Trie"
+   * import { Equal, Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(
@@ -2070,8 +2035,7 @@ export const insertMany: {
    * **Example** (Inserting multiple entries)
    *
    * ```ts
-   * import * as Equal from "effect/Equal"
-   * import * as Trie from "effect/Trie"
+   * import { Equal, Trie } from "effect"
    * import * as assert from "node:assert"
    *
    * const trie = Trie.empty<number>().pipe(