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

package/dist/TxChunk.d.ts

@@ -1,11 +1,44 @@
 /**
- * TxChunk is a transactional chunk data structure that provides Software Transactional Memory (STM)
- * semantics for chunk operations. It uses a `TxRef<Chunk<A>>` internally to ensure all operations
- * are performed atomically within transactions.
- *
- * Accessed values are tracked by the transaction in order to detect conflicts and to track changes.
- * A transaction will retry whenever a conflict is detected or whenever the transaction explicitly
- * calls `Effect.txRetry` and any of the accessed TxChunk values change.
+ * The `TxChunk` module provides a transactional collection backed by an
+ * immutable {@link Chunk}. A `TxChunk<A>` stores the current chunk in a
+ * {@link TxRef}, so reads and updates are tracked by Effect transactions and
+ * committed atomically.
+ *
+ * **Mental model**
+ *
+ * - A `TxChunk` is mutable at the reference level, but every stored value is a
+ *   persistent `Chunk`
+ * - Single operations such as {@link append}, {@link drop}, or {@link get} run
+ *   as transactions on their own
+ * - Wrap several operations in `Effect.tx` when they must observe one
+ *   consistent snapshot and commit or retry together
+ * - If a transaction reads a `TxChunk` and another transaction changes it
+ *   before commit, the transaction retries instead of publishing a stale write
+ *
+ * **Common tasks**
+ *
+ * - Create collections: {@link empty}, {@link make}, {@link fromIterable}
+ * - Replace or transform contents: {@link set}, {@link update}, {@link modify}
+ * - Add values: {@link append}, {@link prepend}, {@link appendAll},
+ *   {@link prependAll}
+ * - Keep or remove ranges: {@link take}, {@link drop}, {@link slice},
+ *   {@link filter}
+ * - Inspect contents: {@link get}, {@link size}, {@link isEmpty},
+ *   {@link isNonEmpty}
+ *
+ * **Gotchas**
+ *
+ * - `get` returns the current immutable `Chunk`, not a live mutable view
+ * - Operations such as {@link append}, {@link drop}, and {@link filter} update
+ *   the stored chunk; they do not return a new `TxChunk`
+ * - Use `TxQueue` instead when producers should wait, drop, or slide based on
+ *   queue capacity
+ *
+ * **See also**
+ *
+ * - {@link TxRef} for the lower-level transactional reference used internally
+ * - {@link Chunk} for immutable chunk operations
+ * - `TxQueue` for transactional producer/consumer queues
  *
  * @since 4.0.0
  */

package/dist/TxChunk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TxChunk.d.ts","sourceRoot":"","sources":["../src/TxChunk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAGrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC,QAAA,MAAM,MAAM,iCAAiC,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,WAAW,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAE,SAAQ,WAAW,EAAE,QAAQ;IAC9D,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,MAAM,CAAA;IAChC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;CAC1C;AAoBD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,SAAS,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CACf,CAAA;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,GAAG,KAAK,OAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CACQ,CAAA;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,UAAU,QAAQ,CAAC,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CACA,CAAA;AAEhF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAKzE,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,MAAM,EAAE;IACnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,CAAC,CAAC,EAAE,CAAC,EACH,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAClF,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IACzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,CAAC,CAAC,EAAE,CAAC,EACH,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAChB,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GACzE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;CAOpB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,MAAM,EAAE;IACnB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACvG;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAO3F,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,GAAG,GAAI,CAAC,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAwB,CAAA;AAE9F;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,GAAG,EAAE;IAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACrE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAIlE,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,MAAM,EAAE;IACnB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC1D;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAIvD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,OAAO,EAAE;IACpB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC1D;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAIvD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CACJ,CAAA;AAE3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CACL,CAAA;AAE9D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CACL,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,IAAI,EAAE;IACjB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACzD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAItD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,IAAI,EAAE;IACjB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACzD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAItD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,KAAK,EAAE;IAClB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC1E;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAKvE,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,GAAG,EAAE;IAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACvE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAI3D,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,MAAM,EAAE;IACnB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACzF;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC5E;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACrF;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAKzE,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,SAAS,EAAE;IACtB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACrE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAKlE,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,UAAU,EAAE;IACvB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACrE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAKlE,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,MAAM,EAAE;IACnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAQ9D,CAAA"}
+{"version":3,"file":"TxChunk.d.ts","sourceRoot":"","sources":["../src/TxChunk.ts"],"names":[],"mappings":"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"}

package/dist/TxChunk.js

@@ -1,11 +1,44 @@
 /**
- * TxChunk is a transactional chunk data structure that provides Software Transactional Memory (STM)
- * semantics for chunk operations. It uses a `TxRef<Chunk<A>>` internally to ensure all operations
- * are performed atomically within transactions.
- *
- * Accessed values are tracked by the transaction in order to detect conflicts and to track changes.
- * A transaction will retry whenever a conflict is detected or whenever the transaction explicitly
- * calls `Effect.txRetry` and any of the accessed TxChunk values change.
+ * The `TxChunk` module provides a transactional collection backed by an
+ * immutable {@link Chunk}. A `TxChunk<A>` stores the current chunk in a
+ * {@link TxRef}, so reads and updates are tracked by Effect transactions and
+ * committed atomically.
+ *
+ * **Mental model**
+ *
+ * - A `TxChunk` is mutable at the reference level, but every stored value is a
+ *   persistent `Chunk`
+ * - Single operations such as {@link append}, {@link drop}, or {@link get} run
+ *   as transactions on their own
+ * - Wrap several operations in `Effect.tx` when they must observe one
+ *   consistent snapshot and commit or retry together
+ * - If a transaction reads a `TxChunk` and another transaction changes it
+ *   before commit, the transaction retries instead of publishing a stale write
+ *
+ * **Common tasks**
+ *
+ * - Create collections: {@link empty}, {@link make}, {@link fromIterable}
+ * - Replace or transform contents: {@link set}, {@link update}, {@link modify}
+ * - Add values: {@link append}, {@link prepend}, {@link appendAll},
+ *   {@link prependAll}
+ * - Keep or remove ranges: {@link take}, {@link drop}, {@link slice},
+ *   {@link filter}
+ * - Inspect contents: {@link get}, {@link size}, {@link isEmpty},
+ *   {@link isNonEmpty}
+ *
+ * **Gotchas**
+ *
+ * - `get` returns the current immutable `Chunk`, not a live mutable view
+ * - Operations such as {@link append}, {@link drop}, and {@link filter} update
+ *   the stored chunk; they do not return a new `TxChunk`
+ * - Use `TxQueue` instead when producers should wait, drop, or slide based on
+ *   queue capacity
+ *
+ * **See also**
+ *
+ * - {@link TxRef} for the lower-level transactional reference used internally
+ * - {@link Chunk} for immutable chunk operations
+ * - `TxQueue` for transactional producer/consumer queues
  *
  * @since 4.0.0
  */

package/dist/TxChunk.js.map

@@ -1 +1 @@
-{"version":3,"file":"TxChunk.js","names":["Chunk","Effect","format","dual","NodeInspectSymbol","toJson","pipeArguments","TxRef","TypeId","TxChunkProto","toJSON","toString","ref","_id","pipe","arguments","make","initial","map","makeUnsafe","empty","fromIterable","iterable","txChunk","Object","create","modify","self","f","update","get","set","chunk","append","element","current","prepend","size","isEmpty","isNonEmpty","take","n","drop","slice","start","end","filter","predicate","appendAll","other","prependAll","concat","gen","otherChunk","tx"],"sources":["../src/TxChunk.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"TxChunk.js","names":["Chunk","Effect","format","dual","NodeInspectSymbol","toJson","pipeArguments","TxRef","TypeId","TxChunkProto","toJSON","toString","ref","_id","pipe","arguments","make","initial","map","makeUnsafe","empty","fromIterable","iterable","txChunk","Object","create","modify","self","f","update","get","set","chunk","append","element","current","prepend","size","isEmpty","isNonEmpty","take","n","drop","slice","start","end","filter","predicate","appendAll","other","prependAll","concat","gen","otherChunk","tx"],"sources":["../src/TxChunk.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/TxDeferred.d.ts

@@ -1,6 +1,29 @@
 /**
- * A transactional deferred value — a write-once cell that can be read within transactions.
- * Readers retry until a value is set; once set, the value is immutable.
+ * Transactional deferred values for coordinating Effect transactions.
+ *
+ * A `TxDeferred<A, E>` is a write-once cell whose completion is a
+ * `Result<A, E>` stored in transactional state. Readers can wait for the value
+ * from inside a transaction: while the cell is empty the transaction retries,
+ * and when another transaction completes the deferred the waiting transaction
+ * can resume with either the success value or the typed failure.
+ *
+ * **Mental model**
+ *
+ * `TxDeferred` is the transaction-aware counterpart to a regular deferred
+ * value. Completion is single-assignment, reads participate in transaction
+ * retry semantics, and all observers see the same committed result once the
+ * deferred has been completed.
+ *
+ * **Common tasks**
+ *
+ * Create an empty deferred with {@link make}, wait for completion with
+ * `await`, inspect the current state with {@link poll}, and complete it with
+ * {@link done}, {@link succeed}, or {@link fail}.
+ *
+ * **Gotchas**
+ *
+ * Only the first completion wins. Later completion attempts return `false`
+ * instead of replacing the stored result.
  *
  * @since 4.0.0
  */
@@ -16,6 +39,11 @@ declare const TypeId = "~effect/transactions/TxDeferred";
  * Readers block (retry the transaction) until a value is committed, and writers
  * succeed only on the first call; subsequent writes return `false`.
  *
+ * **When to use**
+ *
+ * Use to coordinate transaction-local readers and one-time completion with a
+ * success or failure result.
+ *
  * **Example** (Completing a transactional deferred)
  *
  * ```ts
@@ -48,6 +76,10 @@ export interface TxDeferred<in out A, in out E = never> extends Inspectable, Pip
 /**
  * Creates a new empty `TxDeferred`.
  *
+ * **When to use**
+ *
+ * Use to create a transactional deferred that can be completed exactly once.
+ *
  * **Example** (Creating a transactional deferred)
  *
  * ```ts
@@ -90,6 +122,13 @@ export {
  * Reads the deferred value. Retries the transaction if the deferred has not
  * been completed yet.
  *
+ * **When to use**
+ *
+ * Use to read the success value of a `TxDeferred` while retrying until the
+ * deferred is completed.
+ *
+ * @see {@link poll} for inspecting the current completion state without retrying the transaction
+ *
  * @category getters
  * @since 4.0.0
  */
@@ -98,6 +137,10 @@ await_ as await };
  * Reads the current state of the deferred without retrying. Returns `None` if
  * not yet completed.
  *
+ * **When to use**
+ *
+ * Use to inspect a `TxDeferred` without retrying when it is not completed yet.
+ *
  * **Example** (Polling a deferred)
  *
  * ```ts
@@ -122,6 +165,10 @@ export declare const poll: <A, E>(self: TxDeferred<A, E>) => Effect.Effect<Optio
  * Completes the deferred with a `Result`. Returns `true` if this was the first
  * completion, `false` if already completed.
  *
+ * **When to use**
+ *
+ * Use to complete a `TxDeferred` with an already computed `Result`.
+ *
  * **Example** (Completing with a result)
  *
  * ```ts
@@ -144,6 +191,10 @@ export declare const done: {
      * Completes the deferred with a `Result`. Returns `true` if this was the first
      * completion, `false` if already completed.
      *
+     * **When to use**
+     *
+     * Use to complete a `TxDeferred` with an already computed `Result`.
+     *
      * **Example** (Completing with a result)
      *
      * ```ts
@@ -166,6 +217,10 @@ export declare const done: {
      * Completes the deferred with a `Result`. Returns `true` if this was the first
      * completion, `false` if already completed.
      *
+     * **When to use**
+     *
+     * Use to complete a `TxDeferred` with an already computed `Result`.
+     *
      * **Example** (Completing with a result)
      *
      * ```ts
@@ -189,6 +244,10 @@ export declare const done: {
  * Completes the deferred with a success value. Returns `true` if this was the
  * first completion, `false` if already completed.
  *
+ * **When to use**
+ *
+ * Use to complete a `TxDeferred` with a successful value.
+ *
  * **Example** (Completing with a success value)
  *
  * ```ts
@@ -211,6 +270,10 @@ export declare const succeed: {
      * Completes the deferred with a success value. Returns `true` if this was the
      * first completion, `false` if already completed.
      *
+     * **When to use**
+     *
+     * Use to complete a `TxDeferred` with a successful value.
+     *
      * **Example** (Completing with a success value)
      *
      * ```ts
@@ -233,6 +296,10 @@ export declare const succeed: {
      * Completes the deferred with a success value. Returns `true` if this was the
      * first completion, `false` if already completed.
      *
+     * **When to use**
+     *
+     * Use to complete a `TxDeferred` with a successful value.
+     *
      * **Example** (Completing with a success value)
      *
      * ```ts
@@ -256,6 +323,10 @@ export declare const succeed: {
  * Completes the deferred with a failure. Returns `true` if this was the first
  * completion, `false` if already completed.
  *
+ * **When to use**
+ *
+ * Use to complete a `TxDeferred` with a typed failure value.
+ *
  * **Example** (Completing with a failure)
  *
  * ```ts
@@ -278,6 +349,10 @@ export declare const fail: {
      * Completes the deferred with a failure. Returns `true` if this was the first
      * completion, `false` if already completed.
      *
+     * **When to use**
+     *
+     * Use to complete a `TxDeferred` with a typed failure value.
+     *
      * **Example** (Completing with a failure)
      *
      * ```ts
@@ -300,6 +375,10 @@ export declare const fail: {
      * Completes the deferred with a failure. Returns `true` if this was the first
      * completion, `false` if already completed.
      *
+     * **When to use**
+     *
+     * Use to complete a `TxDeferred` with a typed failure value.
+     *
      * **Example** (Completing with a failure)
      *
      * ```ts
@@ -322,6 +401,10 @@ export declare const fail: {
 /**
  * Determines if the provided value is a `TxDeferred`.
  *
+ * **When to use**
+ *
+ * Use to narrow an unknown value before treating it as a transactional deferred.
+ *
  * **Example** (Checking transactional deferreds)
  *
  * ```ts

package/dist/TxDeferred.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TxDeferred.d.ts","sourceRoot":"","sources":["../src/TxDeferred.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TxDeferred.d.ts","sourceRoot":"","sources":["../src/TxDeferred.ts"],"names":[],"mappings":"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"}

package/dist/TxDeferred.js

@@ -1,6 +1,29 @@
 /**
- * A transactional deferred value — a write-once cell that can be read within transactions.
- * Readers retry until a value is set; once set, the value is immutable.
+ * Transactional deferred values for coordinating Effect transactions.
+ *
+ * A `TxDeferred<A, E>` is a write-once cell whose completion is a
+ * `Result<A, E>` stored in transactional state. Readers can wait for the value
+ * from inside a transaction: while the cell is empty the transaction retries,
+ * and when another transaction completes the deferred the waiting transaction
+ * can resume with either the success value or the typed failure.
+ *
+ * **Mental model**
+ *
+ * `TxDeferred` is the transaction-aware counterpart to a regular deferred
+ * value. Completion is single-assignment, reads participate in transaction
+ * retry semantics, and all observers see the same committed result once the
+ * deferred has been completed.
+ *
+ * **Common tasks**
+ *
+ * Create an empty deferred with {@link make}, wait for completion with
+ * `await`, inspect the current state with {@link poll}, and complete it with
+ * {@link done}, {@link succeed}, or {@link fail}.
+ *
+ * **Gotchas**
+ *
+ * Only the first completion wins. Later completion attempts return `false`
+ * instead of replacing the stored result.
  *
  * @since 4.0.0
  */
@@ -35,6 +58,10 @@ const makeTxDeferred = ref => {
 /**
  * Creates a new empty `TxDeferred`.
  *
+ * **When to use**
+ *
+ * Use to create a transactional deferred that can be completed exactly once.
+ *
  * **Example** (Creating a transactional deferred)
  *
  * ```ts
@@ -83,6 +110,13 @@ export {
  * Reads the deferred value. Retries the transaction if the deferred has not
  * been completed yet.
  *
+ * **When to use**
+ *
+ * Use to read the success value of a `TxDeferred` while retrying until the
+ * deferred is completed.
+ *
+ * @see {@link poll} for inspecting the current completion state without retrying the transaction
+ *
  * @category getters
  * @since 4.0.0
  */
@@ -91,6 +125,10 @@ await_ as await };
  * Reads the current state of the deferred without retrying. Returns `None` if
  * not yet completed.
  *
+ * **When to use**
+ *
+ * Use to inspect a `TxDeferred` without retrying when it is not completed yet.
+ *
  * **Example** (Polling a deferred)
  *
  * ```ts
@@ -115,6 +153,10 @@ export const poll = self => TxRef.get(self.ref);
  * Completes the deferred with a `Result`. Returns `true` if this was the first
  * completion, `false` if already completed.
  *
+ * **When to use**
+ *
+ * Use to complete a `TxDeferred` with an already computed `Result`.
+ *
  * **Example** (Completing with a result)
  *
  * ```ts
@@ -142,6 +184,10 @@ export const done = /*#__PURE__*/dual(2, (self, result) => TxRef.modify(self.ref
  * Completes the deferred with a success value. Returns `true` if this was the
  * first completion, `false` if already completed.
  *
+ * **When to use**
+ *
+ * Use to complete a `TxDeferred` with a successful value.
+ *
  * **Example** (Completing with a success value)
  *
  * ```ts
@@ -164,6 +210,10 @@ export const succeed = /*#__PURE__*/dual(2, (self, value) => done(self, Res.succ
  * Completes the deferred with a failure. Returns `true` if this was the first
  * completion, `false` if already completed.
  *
+ * **When to use**
+ *
+ * Use to complete a `TxDeferred` with a typed failure value.
+ *
  * **Example** (Completing with a failure)
  *
  * ```ts
@@ -185,6 +235,10 @@ export const fail = /*#__PURE__*/dual(2, (self, error) => done(self, Res.fail(er
 /**
  * Determines if the provided value is a `TxDeferred`.
  *
+ * **When to use**
+ *
+ * Use to narrow an unknown value before treating it as a transactional deferred.
+ *
  * **Example** (Checking transactional deferreds)
  *
  * ```ts

package/dist/TxDeferred.js.map

@@ -1 +1 @@
-{"version":3,"file":"TxDeferred.js","names":["Effect","dual","NodeInspectSymbol","toJson","O","pipeArguments","hasProperty","Res","TxRef","TypeId","TxDeferredProto","toJSON","_id","pipe","arguments","makeTxDeferred","ref","self","Object","create","make","map","none","await_","gen","option","get","isNone","txRetry","isSuccess","value","success","fail","failure","tx","await","poll","done","result","modify","current","isSome","some","succeed","error","isTxDeferred","u"],"sources":["../src/TxDeferred.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"TxDeferred.js","names":["Effect","dual","NodeInspectSymbol","toJson","O","pipeArguments","hasProperty","Res","TxRef","TypeId","TxDeferredProto","toJSON","_id","pipe","arguments","makeTxDeferred","ref","self","Object","create","make","map","none","await_","gen","option","get","isNone","txRetry","isSuccess","value","success","fail","failure","tx","await","poll","done","result","modify","current","isSome","some","succeed","error","isTxDeferred","u"],"sources":["../src/TxDeferred.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/TxPriorityQueue.d.ts

@@ -1,6 +1,33 @@
 /**
- * A transactional priority queue. Elements are dequeued in order determined by the
- * provided `Order` instance. All operations participate in the STM transaction system.
+ * The `TxPriorityQueue` module provides a mutable priority queue whose state is
+ * stored in a transactional reference. Elements are kept in the order defined by
+ * the `Order` supplied at construction time, and dequeue operations return the
+ * first element according to that ordering.
+ *
+ * A `TxPriorityQueue<A>` is useful when multiple fibers coordinate through a
+ * shared queue and the queue operation needs to compose with other
+ * transactional state changes. Every operation returns an `Effect`; group
+ * several queue operations with `Effect.tx` when the whole sequence must commit
+ * or retry as one transaction.
+ *
+ * **Common tasks**
+ *
+ * - Create queues with {@link empty}, {@link fromIterable}, or {@link make}
+ * - Insert values with {@link offer} and {@link offerAll}
+ * - Read priority order with {@link peek}, {@link peekOption}, and
+ *   {@link toArray}
+ * - Remove values with {@link take}, {@link takeOption}, {@link takeAll}, and
+ *   {@link takeUpTo}
+ * - Keep or remove subsets with {@link retainIf} and {@link removeIf}
+ *
+ * **Gotchas**
+ *
+ * - `take` and `peek` retry when the queue is empty; use `takeOption` or
+ *   `peekOption` when empty queues should be represented as `Option.none`.
+ * - `Order.Number` is ascending, so lower numbers are dequeued first. Provide a
+ *   reversed order when larger values should have higher priority.
+ * - The queue preserves all values with equal priority; equal values are not
+ *   merged or deduplicated.
  *
  * @since 4.0.0
  */

package/dist/TxPriorityQueue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TxPriorityQueue.d.ts","sourceRoot":"","sources":["../src/TxPriorityQueue.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TxPriorityQueue.d.ts","sourceRoot":"","sources":["../src/TxPriorityQueue.ts"],"names":[],"mappings":"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"}

package/dist/TxPriorityQueue.js

@@ -1,6 +1,33 @@
 /**
- * A transactional priority queue. Elements are dequeued in order determined by the
- * provided `Order` instance. All operations participate in the STM transaction system.
+ * The `TxPriorityQueue` module provides a mutable priority queue whose state is
+ * stored in a transactional reference. Elements are kept in the order defined by
+ * the `Order` supplied at construction time, and dequeue operations return the
+ * first element according to that ordering.
+ *
+ * A `TxPriorityQueue<A>` is useful when multiple fibers coordinate through a
+ * shared queue and the queue operation needs to compose with other
+ * transactional state changes. Every operation returns an `Effect`; group
+ * several queue operations with `Effect.tx` when the whole sequence must commit
+ * or retry as one transaction.
+ *
+ * **Common tasks**
+ *
+ * - Create queues with {@link empty}, {@link fromIterable}, or {@link make}
+ * - Insert values with {@link offer} and {@link offerAll}
+ * - Read priority order with {@link peek}, {@link peekOption}, and
+ *   {@link toArray}
+ * - Remove values with {@link take}, {@link takeOption}, {@link takeAll}, and
+ *   {@link takeUpTo}
+ * - Keep or remove subsets with {@link retainIf} and {@link removeIf}
+ *
+ * **Gotchas**
+ *
+ * - `take` and `peek` retry when the queue is empty; use `takeOption` or
+ *   `peekOption` when empty queues should be represented as `Option.none`.
+ * - `Order.Number` is ascending, so lower numbers are dequeued first. Provide a
+ *   reversed order when larger values should have higher priority.
+ * - The queue preserves all values with equal priority; equal values are not
+ *   merged or deduplicated.
  *
  * @since 4.0.0
  */

package/dist/TxPriorityQueue.js.map

@@ -1 +1 @@
-{"version":3,"file":"TxPriorityQueue.js","names":["C","Effect","dual","NodeInspectSymbol","toJson","O","pipeArguments","hasProperty","TxRef","TypeId","TxPriorityQueueProto","toJSON","_id","pipe","arguments","makeTxPriorityQueue","ref","ord","self","Object","create","insertSorted","chunk","value","arr","toArray","lo","hi","length","mid","out","Array","i","fromIterable","empty","order","map","make","iterable","from","sort","a","b","elements","size","get","isEmpty","n","isNonEmpty","peek","gen","head","isNone","txRetry","tx","peekOption","offer","update","offerAll","values","take","set","drop","takeAll","modify","takeOption","none","some","takeUpTo","taken","rest","removeIf","predicate","filter","retainIf","isTxPriorityQueue","u"],"sources":["../src/TxPriorityQueue.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"TxPriorityQueue.js","names":["C","Effect","dual","NodeInspectSymbol","toJson","O","pipeArguments","hasProperty","TxRef","TypeId","TxPriorityQueueProto","toJSON","_id","pipe","arguments","makeTxPriorityQueue","ref","ord","self","Object","create","insertSorted","chunk","value","arr","toArray","lo","hi","length","mid","out","Array","i","fromIterable","empty","order","map","make","iterable","from","sort","a","b","elements","size","get","isEmpty","n","isNonEmpty","peek","gen","head","isNone","txRetry","tx","peekOption","offer","update","offerAll","values","take","set","drop","takeAll","modify","takeOption","none","some","takeUpTo","taken","rest","removeIf","predicate","filter","retainIf","isTxPriorityQueue","u"],"sources":["../src/TxPriorityQueue.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,OAAO,KAAKA,CAAC,MAAM,YAAY;AAC/B,OAAO,KAAKC,MAAM,MAAM,aAAa;AACrC,SAASC,IAAI,QAAQ,eAAe;AAEpC,SAASC,iBAAiB,EAAEC,MAAM,QAAQ,kBAAkB;AAE5D,OAAO,KAAKC,CAAC,MAAM,aAAa;AAGhC,SAASC,aAAa,QAAQ,eAAe;AAC7C,SAASC,WAAW,QAAwB,gBAAgB;AAC5D,OAAO,KAAKC,KAAK,MAAM,YAAY;AAEnC,MAAMC,MAAM,GAAG,sCAAsC;AAmCrD,MAAMC,oBAAoB,GAAkE;EAC1F,CAACP,iBAAiB,IAAC;IACjB,OAAOC,MAAM,CAAC,IAAI,CAAC;EACrB,CAAC;EACDO,MAAMA,CAAA;IACJ,OAAO;MACLC,GAAG,EAAE;KACN;EACH,CAAC;EACDC,IAAIA,CAAA;IACF,OAAOP,aAAa,CAAC,IAAI,EAAEQ,SAAS,CAAC;EACvC;CACD;AAED,MAAMC,mBAAmB,GAAGA,CAAIC,GAA0B,EAAEC,GAAa,KAAwB;EAC/F,MAAMC,IAAI,GAAGC,MAAM,CAACC,MAAM,CAACV,oBAAoB,CAAC;EAChDQ,IAAI,CAACT,MAAM,CAAC,GAAGA,MAAM;EACrBS,IAAI,CAACF,GAAG,GAAGA,GAAG;EACdE,IAAI,CAACD,GAAG,GAAGA,GAAG;EACd,OAAOC,IAAI;AACb,CAAC;AAED,MAAMG,YAAY,GAAGA,CAAIC,KAAe,EAAEC,KAAQ,EAAEN,GAAa,KAAc;EAC7E,MAAMO,GAAG,GAAGxB,CAAC,CAACyB,OAAO,CAACH,KAAK,CAAa;EACxC,IAAII,EAAE,GAAG,CAAC;EACV,IAAIC,EAAE,GAAGH,GAAG,CAACI,MAAM;EACnB,OAAOF,EAAE,GAAGC,EAAE,EAAE;IACd,MAAME,GAAG,GAAIH,EAAE,GAAGC,EAAE,KAAM,CAAC;IAC3B,IAAIV,GAAG,CAACO,GAAG,CAACK,GAAG,CAAC,EAAEN,KAAK,CAAC,IAAI,CAAC,EAAE;MAC7BG,EAAE,GAAGG,GAAG,GAAG,CAAC;IACd,CAAC,MAAM;MACLF,EAAE,GAAGE,GAAG;IACV;EACF;EACA,MAAMC,GAAG,GAAGC,KAAK,CAACP,GAAG,CAACI,MAAM,GAAG,CAAC,CAAa;EAC7C,KAAK,IAAII,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGN,EAAE,EAAEM,CAAC,EAAE,EAAEF,GAAG,CAACE,CAAC,CAAC,GAAGR,GAAG,CAACQ,CAAC,CAAC;EAC5CF,GAAG,CAACJ,EAAE,CAAC,GAAGH,KAAK;EACf,KAAK,IAAIS,CAAC,GAAGN,EAAE,EAAEM,CAAC,GAAGR,GAAG,CAACI,MAAM,EAAEI,CAAC,EAAE,EAAEF,GAAG,CAACE,CAAC,GAAG,CAAC,CAAC,GAAGR,GAAG,CAACQ,CAAC,CAAC;EACzD,OAAOhC,CAAC,CAACiC,YAAY,CAACH,GAAG,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;;;;;;;AAkBA,OAAO,MAAMI,KAAK,GAAOC,KAAe,IACtClC,MAAM,CAACmC,GAAG,CAAC5B,KAAK,CAAC6B,IAAI,CAAWrC,CAAC,CAACkC,KAAK,EAAE,CAAC,EAAGlB,GAAG,IAAKD,mBAAmB,CAACC,GAAG,EAAEmB,KAAK,CAAC,CAAC;AAEvF;;;;;;;;;;;;;;;;;;AAkBA,OAAO,MAAMF,YAAY,gBAuCrB/B,IAAI,CACN,CAAC,EACD,CAAIiC,KAAe,EAAEG,QAAqB,KAAuC;EAC/E,MAAMd,GAAG,GAAGO,KAAK,CAACQ,IAAI,CAACD,QAAQ,CAAC,CAACE,IAAI,CAAC,CAACC,CAAC,EAAEC,CAAC,KAAKP,KAAK,CAACM,CAAC,EAAEC,CAAC,CAAC,CAAC;EAC5D,OAAOzC,MAAM,CAACmC,GAAG,CACf5B,KAAK,CAAC6B,IAAI,CAkBArC,CAAC,CAACiC,YAAY,CAACT,GAAG,CAAC,CAAC,EAC7BR,GAAG,IAAKD,mBAAmB,CAACC,GAAG,EAAEmB,KAAK,CAAC,CACzC;AACH,CAAC,CACF;AAED;;;;;;;;;;;;;;;;;;AAkBA,OAAO,MAAME,IAAI,GAAOF,KAAe,IAAK,CAAC,GAAGQ,QAAkB,KAChEV,YAAY,CAACE,KAAK,EAAEQ,QAAQ,CAAC;AAE/B;;;;;;;;;;;;;;;;;;AAkBA,OAAO,MAAMC,IAAI,GAAO1B,IAAwB,IAA4BjB,MAAM,CAACmC,GAAG,CAAC5B,KAAK,CAACqC,GAAG,CAAC3B,IAAI,CAACF,GAAG,CAAC,EAAEhB,CAAC,CAAC4C,IAAI,CAAC;AAEnH;;;;;;;;;;;;;;;;;;AAkBA,OAAO,MAAME,OAAO,GAAO5B,IAAwB,IAA6BjB,MAAM,CAACmC,GAAG,CAACQ,IAAI,CAAC1B,IAAI,CAAC,EAAG6B,CAAC,IAAKA,CAAC,KAAK,CAAC,CAAC;AAEtH;;;;;;;;;;;;;;;;;;AAkBA,OAAO,MAAMC,UAAU,GAAO9B,IAAwB,IAA6BjB,MAAM,CAACmC,GAAG,CAACQ,IAAI,CAAC1B,IAAI,CAAC,EAAG6B,CAAC,IAAKA,CAAC,GAAG,CAAC,CAAC;AAEvH;;;;;;;;;;;;;;;;;;;AAmBA,OAAO,MAAME,IAAI,GAAO/B,IAAwB,IAC9CjB,MAAM,CAACiD,GAAG,CAAC,aAAS;EAClB,MAAM5B,KAAK,GAAG,OAAOd,KAAK,CAACqC,GAAG,CAAC3B,IAAI,CAACF,GAAG,CAAC;EACxC,MAAMmC,IAAI,GAAGnD,CAAC,CAACmD,IAAI,CAAC7B,KAAK,CAAC;EAC1B,IAAIjB,CAAC,CAAC+C,MAAM,CAACD,IAAI,CAAC,EAAE;IAClB,OAAO,OAAOlD,MAAM,CAACoD,OAAO;EAC9B;EACA,OAAOF,IAAI,CAAC5B,KAAK;AACnB,CAAC,CAAC,CAACV,IAAI,CAACZ,MAAM,CAACqD,EAAE,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;AAmBA,OAAO,MAAMC,UAAU,GAAOrC,IAAwB,IACpDjB,MAAM,CAACmC,GAAG,CAAC5B,KAAK,CAACqC,GAAG,CAAC3B,IAAI,CAACF,GAAG,CAAC,EAAEhB,CAAC,CAACmD,IAAI,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;AAoBA,OAAO,MAAMK,KAAK,gBA2CdtD,IAAI,CACN,CAAC,EACD,CAAIgB,IAAwB,EAAEK,KAAQ,KACpCf,KAAK,CAACiD,MAAM,CAACvC,IAAI,CAACF,GAAG,EAAGM,KAAK,IAAKD,YAAY,CAACC,KAAK,EAAEC,KAAK,EAAEL,IAAI,CAACD,GAAG,CAAC,CAAC,CAC1E;AAED;;;;;;;;;;;;;;;;;;;AAmBA,OAAO,MAAMyC,QAAQ,gBAyCjBxD,IAAI,CACN,CAAC,EACD,CAAIgB,IAAwB,EAAEyC,MAAmB,KAC/CnD,KAAK,CAACiD,MAAM,CAACvC,IAAI,CAACF,GAAG,EAAGM,KAAK,IAAI;EAC/B,MAAME,GAAG,GAAG,CAAC,GAAGxB,CAAC,CAACyB,OAAO,CAACH,KAAK,CAAC,EAAE,GAAGqC,MAAM,CAAC,CAACnB,IAAI,CAAC,CAACC,CAAC,EAAEC,CAAC,KAAKxB,IAAI,CAACD,GAAG,CAACwB,CAAC,EAAEC,CAAC,CAAC,CAAC;EAC3E,OAAO1C,CAAC,CAACiC,YAAY,CAACT,GAAG,CAAC;AAC5B,CAAC,CAAC,CACL;AAED;;;;;;;;;;;;;;;;;;AAkBA,OAAO,MAAMoC,IAAI,GAAO1C,IAAwB,IAC9CjB,MAAM,CAACiD,GAAG,CAAC,aAAS;EAClB,MAAM5B,KAAK,GAAG,OAAOd,KAAK,CAACqC,GAAG,CAAC3B,IAAI,CAACF,GAAG,CAAC;EACxC,MAAMmC,IAAI,GAAGnD,CAAC,CAACmD,IAAI,CAAC7B,KAAK,CAAC;EAC1B,IAAIjB,CAAC,CAAC+C,MAAM,CAACD,IAAI,CAAC,EAAE;IAClB,OAAO,OAAOlD,MAAM,CAACoD,OAAO;EAC9B;EACA,OAAO7C,KAAK,CAACqD,GAAG,CAAC3C,IAAI,CAACF,GAAG,EAAEhB,CAAC,CAAC8D,IAAI,CAACxC,KAAK,EAAE,CAAC,CAAC,CAAC;EAC5C,OAAO6B,IAAI,CAAC5B,KAAK;AACnB,CAAC,CAAC,CAACV,IAAI,CAACZ,MAAM,CAACqD,EAAE,CAAC;AAEpB;;;;;;;;;;;;;;;;;;AAkBA,OAAO,MAAMS,OAAO,GAAO7C,IAAwB,IACjDjB,MAAM,CAACmC,GAAG,CACR5B,KAAK,CAACwD,MAAM,CAAC9C,IAAI,CAACF,GAAG,EAAGM,KAAK,IAAK,CAACA,KAAK,EAAEtB,CAAC,CAACkC,KAAK,EAAE,CAAC,CAAC,EACrDlC,CAAC,CAACyB,OAAO,CACV;AAEH;;;;;;;;;;;;;;;;;;AAkBA,OAAO,MAAMwC,UAAU,GAAO/C,IAAwB,IACpDV,KAAK,CAACwD,MAAM,CAAC9C,IAAI,CAACF,GAAG,EAAGM,KAAK,IAAI;EAC/B,MAAM6B,IAAI,GAAGnD,CAAC,CAACmD,IAAI,CAAC7B,KAAK,CAAC;EAC1B,IAAIjB,CAAC,CAAC+C,MAAM,CAACD,IAAI,CAAC,EAAE;IAClB,OAAO,CAAC9C,CAAC,CAAC6D,IAAI,EAAK,EAAE5C,KAAK,CAAC;EAC7B;EACA,OAAO,CAACjB,CAAC,CAAC8D,IAAI,CAAChB,IAAI,CAAC5B,KAAK,CAAC,EAAEvB,CAAC,CAAC8D,IAAI,CAACxC,KAAK,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC,CAAC;AAEJ;;;;;;;;;;;;;;;;;;AAkBA,OAAO,MAAM8C,QAAQ,gBAuCjBlE,IAAI,CACN,CAAC,EACD,CAAIgB,IAAwB,EAAE6B,CAAS,KACrC9C,MAAM,CAACmC,GAAG,CACR5B,KAAK,CAACwD,MAAM,CAAC9C,IAAI,CAACF,GAAG,EAAGM,KAAK,IAAI;EAC/B,MAAM+C,KAAK,GAAGrE,CAAC,CAAC4D,IAAI,CAACtC,KAAK,EAAEyB,CAAC,CAAC;EAC9B,MAAMuB,IAAI,GAAGtE,CAAC,CAAC8D,IAAI,CAACxC,KAAK,EAAEyB,CAAC,CAAC;EAC7B,OAAO,CAACsB,KAAK,EAAEC,IAAI,CAAC;AACtB,CAAC,CAAC,EACFtE,CAAC,CAACyB,OAAO,CACV,CACJ;AAED;;;;;;;;;;;;;;;;;;;AAmBA,OAAO,MAAM8C,QAAQ,gBAyCjBrE,IAAI,CACN,CAAC,EACD,CAAIgB,IAAwB,EAAEsD,SAAuB,KACnDhE,KAAK,CAACiD,MAAM,CAACvC,IAAI,CAACF,GAAG,EAAGM,KAAK,IAAKtB,CAAC,CAACyE,MAAM,CAACnD,KAAK,EAAGmB,CAAC,IAAK,CAAC+B,SAAS,CAAC/B,CAAC,CAAC,CAAC,CAAC,CAC3E;AAED;;;;;;;;;;;;;;;;;;;AAmBA,OAAO,MAAMiC,QAAQ,gBAyCjBxE,IAAI,CACN,CAAC,EACD,CAAIgB,IAAwB,EAAEsD,SAAuB,KACnDhE,KAAK,CAACiD,MAAM,CAACvC,IAAI,CAACF,GAAG,EAAGM,KAAK,IAAKtB,CAAC,CAACyE,MAAM,CAACnD,KAAK,EAAEkD,SAAS,CAAC,CAAC,CAChE;AAED;;;;;;;;;;;;;;;;;;AAkBA,OAAO,MAAM/C,OAAO,GAAOP,IAAwB,IACjDjB,MAAM,CAACmC,GAAG,CAAC5B,KAAK,CAACqC,GAAG,CAAC3B,IAAI,CAACF,GAAG,CAAC,EAAEhB,CAAC,CAACyB,OAAO,CAAC;AAE5C;;;;;;;;;;;;;;;;;;AAkBA,OAAO,MAAMkD,iBAAiB,GAAIC,CAAU,IAAoCrE,WAAW,CAACqE,CAAC,EAAEnE,MAAM,CAAC","ignoreList":[]}