effect 4.0.0-beta.70 → 4.0.0-beta.71

package/dist/Ref.d.ts

@@ -1,32 +1,54 @@
 /**
- * This module provides utilities for working with mutable references in a functional context.
- *
- * A Ref is a mutable reference that can be read, written, and atomically modified. Unlike plain
- * mutable variables, Refs are thread-safe and work seamlessly with Effect's concurrency model.
- * They provide atomic operations for safe state management in concurrent programs.
- *
- * **Example** (Managing shared state with refs)
+ * The `Ref` module provides fiber-safe mutable references for state inside
+ * Effect programs. A `Ref<A>` holds one value of type `A` and exposes reads,
+ * writes, and atomic transformations as effects, so state changes compose with
+ * Effect's concurrency model.
+ *
+ * **Mental model**
+ *
+ * - {@link make} creates a reference with an initial value
+ * - {@link get} reads the current value, and {@link set} replaces it
+ * - {@link update}, {@link updateAndGet}, and {@link getAndUpdate} transform
+ *   the current value atomically
+ * - {@link modify} updates the value and returns a separate result computed
+ *   from the previous value
+ * - The `Some` variants use `Option` to leave the value unchanged when a
+ *   partial update does not apply
+ *
+ * **Common tasks**
+ *
+ * - Create refs: {@link make}, {@link makeUnsafe}
+ * - Read and write: {@link get}, {@link set}, {@link getAndSet},
+ *   {@link setAndGet}
+ * - Update state: {@link update}, {@link updateAndGet}, {@link getAndUpdate}
+ * - Update conditionally: {@link updateSome}, {@link updateSomeAndGet},
+ *   {@link getAndUpdateSome}, {@link modifySome}
+ * - Compute while updating: {@link modify}
+ *
+ * **Example** (Updating shared state)
  *
  * ```ts
  * import { Effect, Ref } from "effect"
  *
  * const program = Effect.gen(function*() {
- *   // Create a ref with initial value
  *   const counter = yield* Ref.make(0)
  *
- *   // Atomic operations
- *   yield* Ref.update(counter, (n) => n + 1)
- *   yield* Ref.update(counter, (n) => n * 2)
- *
- *   const value = yield* Ref.get(counter)
- *   console.log(value) // 2
+ *   const next = yield* Ref.updateAndGet(counter, (n) => n + 1)
+ *   const label = yield* Ref.modify(counter, (n) => [`count=${n}`, n + 1])
  *
- *   // Atomic modify with return value
- *   const previous = yield* Ref.getAndSet(counter, 100)
- *   console.log(previous) // 2
+ *   return { label, next }
  * })
  * ```
  *
+ * **Gotchas**
+ *
+ * - Each `Ref` operation is atomic for that reference, but multiple refs are
+ *   not updated transactionally as a group
+ * - If the new value depends on the old value, prefer {@link update} or
+ *   {@link modify} over a separate {@link get} followed by {@link set}
+ * - Unsafe operations are synchronous low-level accessors; prefer effectful
+ *   operations in application code
+ *
  * @since 2.0.0
  */
 import * as Effect from "./Effect.ts";
@@ -38,6 +60,11 @@ declare const TypeId = "~effect/Ref";
 /**
  * A mutable reference that provides atomic read, write, and update operations.
  *
+ * **When to use**
+ *
+ * Use to keep shared mutable state that is read and updated inside Effect
+ * programs.
+ *
  * **Details**
  *
  * A `Ref` is a thread-safe mutable reference type for shared state. It supports
@@ -65,6 +92,10 @@ declare const TypeId = "~effect/Ref";
  * })
  * ```
  *
+ * @see {@link make} for creating a `Ref`
+ * @see {@link get} for reading the current value
+ * @see {@link set} for replacing the current value
+ *
  * @category models
  * @since 2.0.0
  */
@@ -74,12 +105,20 @@ export interface Ref<in out A> extends Ref.Variance<A>, Pipeable {
 /**
  * The Ref namespace containing type definitions and utilities.
  *
+ * **When to use**
+ *
+ * Use when referring to type members nested under the `Ref` namespace.
+ *
  * @since 2.0.0
  */
 export declare namespace Ref {
     /**
      * Variance interface for Ref types, defining the type parameter constraints.
      *
+     * **When to use**
+     *
+     * Use when working with the type-level variance marker carried by `Ref`.
+     *
      * **Example** (Using invariant refs)
      *
      * ```ts
@@ -110,7 +149,7 @@ export declare namespace Ref {
  *
  * **When to use**
  *
- * Use this when you need immediate synchronous construction and can guarantee
+ * Use when you need immediate synchronous construction and can guarantee
  * that creating the `Ref` outside of `Effect` is safe.
  *
  * **Gotchas**
@@ -140,6 +179,10 @@ export declare const makeUnsafe: <A>(value: A) => Ref<A>;
 /**
  * Creates a new Ref with the specified initial value.
  *
+ * **When to use**
+ *
+ * Use to create shared mutable state inside an Effect program.
+ *
  * **Example** (Creating a ref)
  *
  * ```ts
@@ -152,6 +195,8 @@ export declare const makeUnsafe: <A>(value: A) => Ref<A>;
  * })
  * ```
  *
+ * @see {@link makeUnsafe} for synchronous construction outside Effect code
+ *
  * @category constructors
  * @since 2.0.0
  */
@@ -159,6 +204,10 @@ export declare const make: <A>(value: A) => Effect.Effect<Ref<A>>;
 /**
  * Gets the current value of the Ref.
  *
+ * **When to use**
+ *
+ * Use to read the current value without changing it.
+ *
  * **Example** (Getting the current value)
  *
  * ```ts
@@ -171,6 +220,8 @@ export declare const make: <A>(value: A) => Effect.Effect<Ref<A>>;
  * })
  * ```
  *
+ * @see {@link set} for replacing the current value
+ *
  * @category getters
  * @since 2.0.0
  */
@@ -178,6 +229,10 @@ export declare const get: <A>(self: Ref<A>) => Effect.Effect<A, never, never>;
 /**
  * Sets the value of the Ref to the specified value.
  *
+ * **When to use**
+ *
+ * Use to replace the current value with a known value.
+ *
  * **Example** (Setting a value)
  *
  * ```ts
@@ -199,6 +254,9 @@ export declare const get: <A>(self: Ref<A>) => Effect.Effect<A, never, never>;
  * })
  * ```
  *
+ * @see {@link getAndSet} for setting while returning the previous value
+ * @see {@link setAndGet} for setting while returning the new value
+ *
  * @category setters
  * @since 2.0.0
  */
@@ -206,6 +264,10 @@ export declare const set: (<A>(value: A) => (self: Ref<A>) => Effect.Effect<void
 /**
  * Atomically gets the current value of the Ref, sets it to the specified value, and returns the previous value.
  *
+ * **When to use**
+ *
+ * Use to replace the value while returning the previous value.
+ *
  * **Example** (Replacing a value atomically)
  *
  * ```ts
@@ -223,6 +285,9 @@ export declare const set: (<A>(value: A) => (self: Ref<A>) => Effect.Effect<void
  * })
  * ```
  *
+ * @see {@link set} for setting without returning the previous value
+ * @see {@link getAndUpdate} for deriving the new value from the previous value
+ *
  * @category utils
  * @since 2.0.0
  */
@@ -230,6 +295,10 @@ export declare const getAndSet: (<A>(value: A) => (self: Ref<A>) => Effect.Effec
 /**
  * Atomically gets the current value of the Ref, updates it with the given function, and returns the previous value.
  *
+ * **When to use**
+ *
+ * Use to derive a new value while returning the previous value.
+ *
  * **Example** (Updating and returning the previous value)
  *
  * ```ts
@@ -247,6 +316,9 @@ export declare const getAndSet: (<A>(value: A) => (self: Ref<A>) => Effect.Effec
  * })
  * ```
  *
+ * @see {@link update} for updating without returning the previous value
+ * @see {@link updateAndGet} for returning the new value instead
+ *
  * @category utils
  * @since 2.0.0
  */
@@ -254,6 +326,10 @@ export declare const getAndUpdate: (<A>(f: (a: A) => A) => (self: Ref<A>) => Eff
 /**
  * Atomically gets the current value of the Ref and updates it with the given partial function.
  *
+ * **When to use**
+ *
+ * Use to return the previous value while applying a conditional update.
+ *
  * **Details**
  *
  * If the partial function returns `Option.some`, the Ref is updated with the
@@ -290,6 +366,9 @@ export declare const getAndUpdate: (<A>(f: (a: A) => A) => (self: Ref<A>) => Eff
  * })
  * ```
  *
+ * @see {@link getAndUpdate} for always applying an update
+ * @see {@link updateSome} for conditional updates without returning the previous value
+ *
  * @category utils
  * @since 2.0.0
  */
@@ -299,7 +378,7 @@ export declare const getAndUpdateSome: (<A>(pf: (a: A) => Option.Option<A>) => (
  *
  * **When to use**
  *
- * Use this when you want to set a value and immediately get it back in one
+ * Use when you want to set a value and immediately get it back in one
  * atomic operation.
  *
  * **Example** (Setting and returning the new value)
@@ -335,6 +414,11 @@ export declare const setAndGet: (<A>(value: A) => (self: Ref<A>) => Effect.Effec
 /**
  * Atomically modifies the value of the Ref using the given function.
  *
+ * **When to use**
+ *
+ * Use to compute both a separate return value and the next stored value in one
+ * atomic update.
+ *
  * **Details**
  *
  * The function receives the current value and returns a tuple of
@@ -374,6 +458,9 @@ export declare const setAndGet: (<A>(value: A) => (self: Ref<A>) => Effect.Effec
  * })
  * ```
  *
+ * @see {@link updateAndGet} for returning the new stored value
+ * @see {@link modifySome} for optionally updating while returning a separate result
+ *
  * @category setters
  * @since 2.0.0
  */
@@ -381,6 +468,10 @@ export declare const modify: (<A, B>(f: (a: A) => readonly [B, A]) => (self: Ref
 /**
  * Atomically computes a result and optionally updates the value of the `Ref`.
  *
+ * **When to use**
+ *
+ * Use to compute a return value while optionally updating the stored value.
+ *
  * **Details**
  *
  * The callback receives the current value and returns `[result, nextValue]`,
@@ -426,6 +517,9 @@ export declare const modify: (<A, B>(f: (a: A) => readonly [B, A]) => (self: Ref
  * })
  * ```
  *
+ * @see {@link modify} for always storing a new value
+ * @see {@link updateSome} for optional updates without a separate return value
+ *
  * @category setters
  * @since 2.0.0
  */
@@ -433,6 +527,10 @@ export declare const modifySome: {
     /**
      * Atomically computes a result and optionally updates the value of the `Ref`.
      *
+     * **When to use**
+     *
+     * Use to compute a return value while optionally updating the stored value.
+     *
      * **Details**
      *
      * The callback receives the current value and returns `[result, nextValue]`,
@@ -478,6 +576,9 @@ export declare const modifySome: {
      * })
      * ```
      *
+     * @see {@link modify} for always storing a new value
+     * @see {@link updateSome} for optional updates without a separate return value
+     *
      * @category setters
      * @since 2.0.0
      */
@@ -485,6 +586,10 @@ export declare const modifySome: {
     /**
      * Atomically computes a result and optionally updates the value of the `Ref`.
      *
+     * **When to use**
+     *
+     * Use to compute a return value while optionally updating the stored value.
+     *
      * **Details**
      *
      * The callback receives the current value and returns `[result, nextValue]`,
@@ -530,6 +635,9 @@ export declare const modifySome: {
      * })
      * ```
      *
+     * @see {@link modify} for always storing a new value
+     * @see {@link updateSome} for optional updates without a separate return value
+     *
      * @category setters
      * @since 2.0.0
      */
@@ -538,6 +646,10 @@ export declare const modifySome: {
 /**
  * Atomically updates the value of the Ref using the given function.
  *
+ * **When to use**
+ *
+ * Use to apply a state transition without returning a value.
+ *
  * **Example** (Updating a value)
  *
  * ```ts
@@ -562,6 +674,9 @@ export declare const modifySome: {
  * })
  * ```
  *
+ * @see {@link updateAndGet} for returning the new value
+ * @see {@link getAndUpdate} for returning the previous value
+ *
  * @category setters
  * @since 2.0.0
  */
@@ -569,6 +684,10 @@ export declare const update: (<A>(f: (a: A) => A) => (self: Ref<A>) => Effect.Ef
 /**
  * Atomically updates the value of the Ref using the given function and returns the new value.
  *
+ * **When to use**
+ *
+ * Use to apply a state transition and return the new stored value.
+ *
  * **Example** (Updating and returning the new value)
  *
  * ```ts
@@ -587,6 +706,9 @@ export declare const update: (<A>(f: (a: A) => A) => (self: Ref<A>) => Effect.Ef
  * })
  * ```
  *
+ * @see {@link update} for updating without returning the new value
+ * @see {@link getAndUpdate} for returning the previous value instead
+ *
  * @category utils
  * @since 2.0.0
  */
@@ -594,6 +716,10 @@ export declare const updateAndGet: (<A>(f: (a: A) => A) => (self: Ref<A>) => Eff
 /**
  * Atomically updates the value of the Ref using the given partial function.
  *
+ * **When to use**
+ *
+ * Use to apply a conditional update without returning a value.
+ *
  * **Details**
  *
  * If the partial function returns `Option.some`, the Ref is updated with the
@@ -628,6 +754,9 @@ export declare const updateAndGet: (<A>(f: (a: A) => A) => (self: Ref<A>) => Eff
  * })
  * ```
  *
+ * @see {@link update} for always applying an update
+ * @see {@link updateSomeAndGet} for returning the resulting current value
+ *
  * @category setters
  * @since 2.0.0
  */
@@ -635,6 +764,10 @@ export declare const updateSome: (<A>(f: (a: A) => Option.Option<A>) => (self: R
 /**
  * Atomically updates the value of the Ref using the given partial function and returns the current value.
  *
+ * **When to use**
+ *
+ * Use to apply a conditional update and return the resulting current value.
+ *
  * **Details**
  *
  * If the partial function returns `Option.some`, the Ref is updated with the
@@ -665,6 +798,9 @@ export declare const updateSome: (<A>(f: (a: A) => Option.Option<A>) => (self: R
  * })
  * ```
  *
+ * @see {@link updateSome} for conditional updates without returning a value
+ * @see {@link updateAndGet} for always updating and returning the new value
+ *
  * @category utils
  * @since 2.0.0
  */
@@ -674,7 +810,7 @@ export declare const updateSomeAndGet: (<A>(pf: (a: A) => Option.Option<A>) => (
  *
  * **When to use**
  *
- * Use this when you need immediate synchronous access and can guarantee that
+ * Use when you need immediate synchronous access and can guarantee that
  * reading the `Ref` outside of `Effect` is safe.
  *
  * **Gotchas**

package/dist/Ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Ref.d.ts","sourceRoot":"","sources":["../src/Ref.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Ref.d.ts","sourceRoot":"","sources":["../src/Ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAGrC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,QAAA,MAAM,MAAM,gBAAgB,CAAA;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,WAAW,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAE,SAAQ,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ;IAC9D,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;CACvC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,WAAW,GAAG,CAAC;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,UAAiB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE;YACjB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;SAC1B,CAAA;KACF;CACF;AAeD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,GAAG,CAAC,CAAC,CAI7C,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAyC,CAAA;AAEhG;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,GAAG,GAAI,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,mCAAwC,CAAA;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,GAAG,IAmCb,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAmCrD,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CACmC,CAAA;AAEvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,SAAS,IA+BnB,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MA+BlD,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAM5C,CAAA;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,YAAY,IA+BtB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MA+BxD,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAMlD,CAAA;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,eAAO,MAAM,gBAAgB,IAkD1B,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAkDxE,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CASlE,CAAA;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,SAAS,IAsCnB,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAsClD,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAC+B,CAAA;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,eAAO,MAAM,MAAM,IAsDhB,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAsDzE,CAAC,EAAE,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAMnE,CAAA;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,eAAO,MAAM,UAAU,EAAE;IACvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyDG;IACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IACxF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyDG;IACH,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;CA4HjF,CAAA;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,MAAM,IAsChB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAsC3D,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAIrD,CAAA;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,YAAY,IAgCtB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAgCxD,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAC6C,CAAA;AAEpG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,eAAO,MAAM,UAAU,IAgDpB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAgD1E,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAOpE,CAAA;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,eAAO,MAAM,gBAAgB,IA4C1B,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MA4CxE,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAQlE,CAAA;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,KAAG,CAAqB,CAAA"}