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

package/dist/TxSubscriptionRef.js

@@ -1,6 +1,39 @@
 /**
- * TxSubscriptionRef is a TxRef that allows subscribing to all committed changes. Subscribers
- * receive the current value followed by every subsequent update via a transactional queue.
+ * The `TxSubscriptionRef` module provides a transactional reference that can
+ * also be observed as a stream of committed values. It combines the read and
+ * update behavior of a `TxRef.TxRef` with a subscription channel, so each
+ * subscriber first receives the current value and then receives every value
+ * published by later updates.
+ *
+ * **Mental model**
+ *
+ * - The current value is stored transactionally and can be read with
+ *   {@link get}
+ * - Mutations such as {@link set}, {@link update}, and {@link modify} commit a
+ *   new value and publish that value to active subscribers
+ * - {@link changes} creates a scoped transactional queue for one subscriber
+ * - {@link changesStream} exposes the same change feed as a `Stream.Stream`
+ * - Subscriptions are per subscriber; each subscriber gets its own queue of
+ *   committed values
+ *
+ * **Common tasks**
+ *
+ * - Create observable transactional state with {@link make}
+ * - Read or replace the current value with {@link get} and {@link set}
+ * - Derive new values atomically with {@link update} or {@link modify}
+ * - Consume changes from transactional code with {@link changes}
+ * - Consume changes from stream pipelines with {@link changesStream}
+ *
+ * **Gotchas**
+ *
+ * - A subscription starts with the value current at subscription time, not just
+ *   future updates
+ * - The queue returned by {@link changes} is scoped; leaving the scope removes
+ *   the subscriber
+ * - Updates are published even when the new value is equal to the previous
+ *   value
+ * - Subscriber queues are unbounded, so long-lived slow subscribers can retain
+ *   pending values until they catch up or their scope closes
  *
  * @since 4.0.0
  */
@@ -36,6 +69,11 @@ const TxSubscriptionRefProto = {
 /**
  * Creates a new TxSubscriptionRef with the specified initial value.
  *
+ * **When to use**
+ *
+ * Use to create transactional state that also publishes every committed update
+ * to subscribers.
+ *
  * **Example** (Creating a transactional subscription reference)
  *
  * ```ts
@@ -48,6 +86,8 @@ const TxSubscriptionRefProto = {
  * })
  * ```
  *
+ * @see {@link changes} for subscribing to the created reference
+ *
  * @category constructors
  * @since 3.10.0
  */
@@ -66,6 +106,11 @@ export const make = value => Effect.gen(function* () {
 /**
  * Reads the current value of the TxSubscriptionRef.
  *
+ * **When to use**
+ *
+ * Use to read the current transactional value without subscribing to future
+ * changes.
+ *
  * **Example** (Reading the current value)
  *
  * ```ts
@@ -78,6 +123,8 @@ export const make = value => Effect.gen(function* () {
  * })
  * ```
  *
+ * @see {@link changes} for reading the current value and subsequent updates
+ *
  * @category getters
  * @since 3.10.0
  */
@@ -89,6 +136,11 @@ export const get = self => TxRef.get(self.ref);
  * Modifies the value of the TxSubscriptionRef using a function that returns both a
  * result and the new value. The new value is published to all subscribers atomically.
  *
+ * **When to use**
+ *
+ * Use to compute a separate return value and next state in one transactional
+ * update.
+ *
  * **Example** (Modifying and returning a value)
  *
  * ```ts
@@ -102,6 +154,9 @@ export const get = self => TxRef.get(self.ref);
  * })
  * ```
  *
+ * @see {@link update} for deriving the next value without a separate return value
+ * @see {@link set} for replacing the value directly
+ *
  * @category mutations
  * @since 3.10.0
  */
@@ -115,6 +170,10 @@ export const modify = /*#__PURE__*/dual(2, (self, f) => Effect.gen(function* ()
 /**
  * Sets the value of the TxSubscriptionRef and publishes the new value to all subscribers.
  *
+ * **When to use**
+ *
+ * Use to replace the current value with a known value and publish it.
+ *
  * **Example** (Setting a new value)
  *
  * ```ts
@@ -127,6 +186,9 @@ export const modify = /*#__PURE__*/dual(2, (self, f) => Effect.gen(function* ()
  * })
  * ```
  *
+ * @see {@link update} for deriving the new value from the current value
+ * @see {@link getAndSet} for setting while returning the previous value
+ *
  * @category mutations
  * @since 3.10.0
  */
@@ -135,6 +197,10 @@ export const set = /*#__PURE__*/dual(2, (self, value) => modify(self, () => [voi
  * Updates the value of the TxSubscriptionRef using a function and publishes the new
  * value to all subscribers.
  *
+ * **When to use**
+ *
+ * Use to derive the next value from the current value and publish it.
+ *
  * **Example** (Updating a value)
  *
  * ```ts
@@ -147,6 +213,9 @@ export const set = /*#__PURE__*/dual(2, (self, value) => modify(self, () => [voi
  * })
  * ```
  *
+ * @see {@link set} for replacing the value directly
+ * @see {@link updateAndGet} for returning the new value after the update
+ *
  * @category mutations
  * @since 3.10.0
  */
@@ -155,6 +224,10 @@ export const update = /*#__PURE__*/dual(2, (self, f) => modify(self, current =>
  * Gets the current value and sets a new value atomically. Publishes the new value
  * to all subscribers.
  *
+ * **When to use**
+ *
+ * Use to replace the value while returning the previous value.
+ *
  * **Example** (Getting and setting atomically)
  *
  * ```ts
@@ -168,6 +241,9 @@ export const update = /*#__PURE__*/dual(2, (self, f) => modify(self, current =>
  * })
  * ```
  *
+ * @see {@link set} for setting without returning the previous value
+ * @see {@link getAndUpdate} for deriving the new value from the previous value
+ *
  * @category mutations
  * @since 3.10.0
  */
@@ -176,6 +252,10 @@ export const getAndSet = /*#__PURE__*/dual(2, (self, value) => modify(self, curr
  * Gets the current value and updates it using a function atomically. Publishes
  * the new value to all subscribers.
  *
+ * **When to use**
+ *
+ * Use to derive and publish a new value while returning the previous value.
+ *
  * **Example** (Getting and updating atomically)
  *
  * ```ts
@@ -189,6 +269,9 @@ export const getAndSet = /*#__PURE__*/dual(2, (self, value) => modify(self, curr
  * })
  * ```
  *
+ * @see {@link update} for updating without returning the previous value
+ * @see {@link updateAndGet} for returning the new value instead
+ *
  * @category mutations
  * @since 3.10.0
  */
@@ -197,6 +280,10 @@ export const getAndUpdate = /*#__PURE__*/dual(2, (self, f) => modify(self, curre
  * Updates the value using a function and returns the new value. Publishes the
  * new value to all subscribers.
  *
+ * **When to use**
+ *
+ * Use to derive and publish a new value while returning that new value.
+ *
  * **Example** (Updating and reading atomically)
  *
  * ```ts
@@ -209,6 +296,9 @@ export const getAndUpdate = /*#__PURE__*/dual(2, (self, f) => modify(self, curre
  * })
  * ```
  *
+ * @see {@link update} for updating without returning the new value
+ * @see {@link getAndUpdate} for returning the previous value instead
+ *
  * @category mutations
  * @since 3.10.0
  */
@@ -223,6 +313,10 @@ export const updateAndGet = /*#__PURE__*/dual(2, (self, f) => modify(self, curre
  * Subscribes to all changes of the TxSubscriptionRef. Returns a scoped TxDequeue
  * that first yields the current value, then every subsequent update.
  *
+ * **When to use**
+ *
+ * Use to subscribe to committed changes through a scoped transactional queue.
+ *
  * **Example** (Subscribing to changes)
  *
  * ```ts
@@ -245,6 +339,8 @@ export const updateAndGet = /*#__PURE__*/dual(2, (self, f) => modify(self, curre
  * })
  * ```
  *
+ * @see {@link changesStream} for subscribing through a `Stream`
+ *
  * @category subscriptions
  * @since 3.10.0
  */
@@ -258,6 +354,10 @@ export const changes = self => Effect.acquireRelease(Effect.tx(Effect.gen(functi
  * Returns a Stream of all changes to the TxSubscriptionRef, starting with the
  * current value followed by every subsequent update.
  *
+ * **When to use**
+ *
+ * Use to consume committed changes as a `Stream`.
+ *
  * **Example** (Streaming changes)
  *
  * ```ts
@@ -275,6 +375,8 @@ export const changes = self => Effect.acquireRelease(Effect.tx(Effect.gen(functi
  * })
  * ```
  *
+ * @see {@link changes} for subscribing through a transactional queue
+ *
  * @category subscriptions
  * @since 3.10.0
  */
@@ -285,6 +387,10 @@ export const changesStream = self => Stream.unwrap(Effect.map(changes(self), sub
 /**
  * Checks if the given value is a TxSubscriptionRef.
  *
+ * **When to use**
+ *
+ * Use to narrow an unknown value before treating it as a `TxSubscriptionRef`.
+ *
  * **Example** (Checking transactional subscription references)
  *
  * ```ts
@@ -297,6 +403,8 @@ export const changesStream = self => Stream.unwrap(Effect.map(changes(self), sub
  * }
  * ```
  *
+ * @see {@link make} for creating a `TxSubscriptionRef`
+ *
  * @category guards
  * @since 4.0.0
  */

package/dist/TxSubscriptionRef.js.map

@@ -1 +1 @@
-{"version":3,"file":"TxSubscriptionRef.js","names":["Effect","dual","NodeInspectSymbol","toJson","pipeArguments","hasProperty","Stream","TxPubSub","TxQueue","TxRef","TypeId","TxSubscriptionRefProto","toJSON","_id","toString","pipe","arguments","make","value","gen","ref","pubsub","unbounded","self","Object","create","tx","get","modify","f","current","returnValue","newValue","set","publish","update","getAndSet","getAndUpdate","updateAndGet","changes","acquireRelease","sub","acquireSubscriber","offer","queue","releaseSubscriber","changesStream","unwrap","map","fromEffectRepeat","take","isTxSubscriptionRef","u"],"sources":["../src/TxSubscriptionRef.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"TxSubscriptionRef.js","names":["Effect","dual","NodeInspectSymbol","toJson","pipeArguments","hasProperty","Stream","TxPubSub","TxQueue","TxRef","TypeId","TxSubscriptionRefProto","toJSON","_id","toString","pipe","arguments","make","value","gen","ref","pubsub","unbounded","self","Object","create","tx","get","modify","f","current","returnValue","newValue","set","publish","update","getAndSet","getAndUpdate","updateAndGet","changes","acquireRelease","sub","acquireSubscriber","offer","queue","releaseSubscriber","changesStream","unwrap","map","fromEffectRepeat","take","isTxSubscriptionRef","u"],"sources":["../src/TxSubscriptionRef.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/Types.d.ts

@@ -292,7 +292,7 @@ export type Simplify<A> = {
  *
  * **When to use**
  *
- * Use in conditional types or type-level tests to assert type equality.
+ * Use to assert type equality in conditional types or type-level tests.
  *
  * **Details**
  *
@@ -438,7 +438,7 @@ export type MergeRight<Target, Source> = Simplify<Source & {
  *
  * **When to use**
  *
- * Prefer {@link MergeLeft} or {@link MergeRight} for clarity about which
+ * Use when prefer {@link MergeLeft} or {@link MergeRight} for clarity about which
  * side wins.
  *
  * **Example** (Merging records)
@@ -464,6 +464,10 @@ export type MergeRecord<Source, Target> = MergeLeft<Source, Target>;
  * Describes the concurrency level for Effect operations that run multiple
  * effects.
  *
+ * **When to use**
+ *
+ * Use to type options that control how many effects may run at the same time.
+ *
  * **Details**
  *
  * - `number` — run at most N effects concurrently.
@@ -563,8 +567,8 @@ export type DeepMutable<T> = T extends ReadonlyMap<infer K, infer V> ? Map<DeepM
  *
  * **When to use**
  *
- * Use on a function parameter when you want inference to come from other
- * parameters, not this one.
+ * Use when a function parameter must match an inferred type without becoming
+ * an inference source.
  *
  * **Details**
  *
@@ -621,12 +625,20 @@ export type Invariant<A> = (_: A) => A;
 /**
  * Namespace for {@link Invariant}-related utilities.
  *
+ * **When to use**
+ *
+ * Use when referring to type-level helpers nested under `Invariant`.
+ *
  * @since 3.9.0
  */
 export declare namespace Invariant {
     /**
      * Extracts the type parameter `A` from an `Invariant<A>`.
      *
+     * **When to use**
+     *
+     * Use to recover the carried type from an invariant phantom marker.
+     *
      * **Example** (Extracting the inner type)
      *
      * ```ts
@@ -679,12 +691,20 @@ export type Covariant<A> = (_: never) => A;
 /**
  * Namespace for {@link Covariant}-related utilities.
  *
+ * **When to use**
+ *
+ * Use when referring to type-level helpers nested under `Covariant`.
+ *
  * @since 3.9.0
  */
 export declare namespace Covariant {
     /**
      * Extracts the type parameter `A` from a `Covariant<A>`.
      *
+     * **When to use**
+     *
+     * Use to recover the carried type from a covariant phantom marker.
+     *
      * **Example** (Extracting the inner type)
      *
      * ```ts
@@ -737,12 +757,20 @@ export type Contravariant<A> = (_: A) => void;
 /**
  * Namespace for {@link Contravariant}-related utilities.
  *
+ * **When to use**
+ *
+ * Use when referring to type-level helpers nested under `Contravariant`.
+ *
  * @since 3.9.0
  */
 export declare namespace Contravariant {
     /**
      * Extracts the type parameter `A` from a `Contravariant<A>`.
      *
+     * **When to use**
+     *
+     * Use to recover the carried type from a contravariant phantom marker.
+     *
      * **Example** (Extracting the inner type)
      *
      * ```ts
@@ -763,6 +791,10 @@ export declare namespace Contravariant {
  * Conditional type that returns `void` if `S` is an empty object type,
  * otherwise returns `S`.
  *
+ * **When to use**
+ *
+ * Use to erase an empty object type from an API result or parameter position.
+ *
  * @category types
  * @since 3.19.20
  */
@@ -796,8 +828,7 @@ export type NotFunction<T> = T extends Function ? never : T;
  *
  * **When to use**
  *
- * Use in generic functions to catch accidental extra properties at compile
- * time.
+ * Use to catch accidental extra properties in generic functions at compile time.
  *
  * **Details**
  *
@@ -822,6 +853,11 @@ export type NoExcessProperties<T, U> = T & Readonly<Record<Exclude<keyof U, keyo
 /**
  * Branded marker interface representing an unassigned type parameter.
  *
+ * **When to use**
+ *
+ * Use when Effect's type-level machinery needs to represent a type parameter
+ * that has not been assigned yet.
+ *
  * **Details**
  *
  * Used internally by the Effect type system to indicate that a type parameter
@@ -838,6 +874,11 @@ export interface unassigned {
 /**
  * Branded marker interface representing an unhandled error type.
  *
+ * **When to use**
+ *
+ * Use when Effect's type-level machinery needs to represent an error type that
+ * has not been handled yet.
+ *
  * **Details**
  *
  * Used internally by the Effect type system to indicate that an error type
@@ -854,6 +895,10 @@ export interface unhandled {
 /**
  * Checks whether a type `T` is a union type.
  *
+ * **When to use**
+ *
+ * Use to branch type-level logic depending on whether a type is a union.
+ *
  * **Details**
  *
  * - Compares `[T]` against `[UnionToIntersection<T>]`. If they differ, `T`
@@ -914,6 +959,11 @@ export type ReasonOf<E> = E extends {
 /**
  * Extracts the `_tag` values from the `reason` type of an error.
  *
+ * **When to use**
+ *
+ * Use to get the discriminant values available inside a nested `reason`
+ * error union.
+ *
  * **Details**
  *
  * This is shorthand for `Tags<ReasonOf<E>>`. It returns `never` if `E` has no
@@ -1100,6 +1150,10 @@ export type ExcludeReason<E, K extends string> = E extends {
 /**
  * Extracts the required keys from a type.
  *
+ * **When to use**
+ *
+ * Use to derive the keys whose properties must be present on an object type.
+ *
  * @category types
  * @since 4.0.0
  */

package/dist/Types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../src/Types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../src/Types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH;;;GAGG;AACH,KAAK,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,KAAK,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,SAAS,IAAI,MAAM,EAAE,GAAG,KAAK,GAC9F,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,GACzB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,MAAM,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAA;AAEjH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,KAAK,CAAA;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,OAAO,CAAC,CAAC,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAA;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,KAAK,CAAA;AAEpH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,GACxG,KAAK,CAAA;AAET;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KACvB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACrB,SAAS,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAChE,CAAC,OACI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAC7B,KAAK,CAAA;AAET;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAElH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,IAAI,CAAC,GAAG,SAAS,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC,SAAS,KAAK,GACnH,KAAK,GACL,IAAI,CAAA;AAER;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,IAAI,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,MAAM,UAAU,CAAC,MAAM,EAAE,MAAM,IAAI,QAAQ,CAC7C,MAAM,GACN;KACC,GAAG,IAAI,MAAM,MAAM,IAAI,GAAG,SAAS,MAAM,MAAM,GAAG,KAAK,GAAG,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;CAC7E,CACF,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,IAAI,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAA;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;IACvB,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC/B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,GACtG,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACpD,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,CAAC,GACpE;IAAE,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAA;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAA;AAEtC;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAY,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;CAC/D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAA;AAE1C;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAY,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;CAC/D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAA;AAE7C;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,WAAW,aAAa,CAAC;IACrC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAY,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;CACnE;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,MAAM,CAAC,SAAS,KAAK,GAAG,IAAI,GAAG,CAAC,CAAA;AAE7D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAA;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;AAE7F;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,CAAC,EAAE,OAAO,MAAM,CAAA;CAC1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,CAAC,EAAE,OAAO,MAAM,CAAA;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAA;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAA;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GACtG,KAAK,CAAA;AAET;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACnF,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,GAC9D,KAAK,GACL,KAAK,CAAA;AAET;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAClF,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GAAG,KAAK,GACvF,KAAK,GACL,KAAK,CAAA;AAET;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAChF,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,SAAS,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GACvF,KAAK,GACL,KAAK,CAAA;AAET;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACnF,OAAO,CAAC,CAAC,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,GAChC,KAAK,CAAA;AAET;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC;CAAE,CAAC,MAAM,CAAC,CAAC,CAAA"}