@johnhenry/iteration 0.0.0 → 0.1.0

package/dist/async-channel.d.ts

@@ -14,6 +14,14 @@ export interface AsyncChannelOptions<T> {
     limit?: number;
     transform?: (item: T) => T | Promise<T>;
     debug?: (...args: unknown[]) => unknown;
+    /**
+     * How an error queued by `throw()` reaches a `take()` that arrives after
+     * it (a `take()` already waiting when `throw()` is called always rejects).
+     * - `"value"` (default, the pre-0.0.1 behaviour): `take()` resolves with
+     *   the `Error` object, and async iteration yields it as an item.
+     * - `"throw"`: `take()` rejects with it, so async iteration throws.
+     */
+    errors?: "value" | "throw";
 }
 /**
  * Asynchronous Channel class
@@ -25,9 +33,15 @@ export declare class AsyncChannel<T = unknown> {
     cache: Array<T | typeof CHANNEL_END | Error>;
     transform: (item: T) => T | Promise<T>;
     debug?: (...args: unknown[]) => unknown;
-    private promise?;
-    private resolve?;
-    private reject?;
+    errors: "value" | "throw";
+    /**
+     * Consumers waiting in take(), served FIFO. Before 0.0.1 this was a
+     * single slot, so a second concurrent take() replaced the first, which
+     * then never resolved.
+     */
+    private takers;
+    /** Errors queued by throw() (as opposed to Error objects put() as values). */
+    private thrown;
     /** Producers awaiting capacity, FIFO (backpressure -- see put()). */
     private putters;
     /**
@@ -43,7 +57,13 @@ export declare class AsyncChannel<T = unknown> {
      * @kind function
      * @name constructor
      */
-    constructor({ cache, limit, transform, debug }?: AsyncChannelOptions<T>);
+    constructor({ cache, limit, transform, debug, errors, }?: AsyncChannelOptions<T>);
+    /**
+     * Hand an item that came off the cache or a producer to a take() caller:
+     * with `errors: "throw"`, an error queued by throw() rejects.
+     * @ignore
+     */
+    private deliver;
     /**
      * Move waiting producers' items into the cache while there is capacity,
      * releasing their pending put() promises (FIFO).

package/dist/async-channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"async-channel.d.ts","sourceRoot":"","sources":["../src/async-channel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,OAAO,MAA8B,CAAC;AAuBhE,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,OAAO,WAAW,GAAG,KAAK,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;CACzC;AAED;;;;GAIG;AACH,qBAAa,YAAY,CAAC,CAAC,GAAG,OAAO;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,OAAO,WAAW,GAAG,KAAK,CAAC,CAAC;IAC7C,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IACxC,OAAO,CAAC,OAAO,CAAC,CAAkC;IAClD,OAAO,CAAC,OAAO,CAAC,CAA0C;IAC1D,OAAO,CAAC,MAAM,CAAC,CAA6B;IAC5C,qEAAqE;IACrE,OAAO,CAAC,OAAO,CAGP;IACR;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAoC;IAEpD;;;;OAIG;gBACS,EAAE,KAAU,EAAE,KAAgB,EAAE,SAAuB,EAAE,KAAK,EAAE,GAAE,mBAAmB,CAAC,CAAC,CAAM;IAMzG;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAUpB;;;;;;;;OAQG;IACG,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BtD;;;;OAIG;IACG,IAAI,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,OAAO,WAAW,CAAC;IA2BhE;;;;OAIG;IACG,KAAK,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/C;;;;OAIG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjE;;;;;OAKG;IACH,OAAO,IAAI,OAAO;IAGlB;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAGlB;;;;OAIG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC;CAStE"}
+{"version":3,"file":"async-channel.d.ts","sourceRoot":"","sources":["../src/async-channel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,OAAO,MAA8B,CAAC;AAEhE,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,OAAO,WAAW,GAAG,KAAK,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IACxC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CAC5B;AAQD;;;;GAIG;AACH,qBAAa,YAAY,CAAC,CAAC,GAAG,OAAO;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,OAAO,WAAW,GAAG,KAAK,CAAC,CAAC;IAC7C,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IACxC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAuB;IACrC,8EAA8E;IAC9E,OAAO,CAAC,MAAM,CAAwB;IACtC,qEAAqE;IACrE,OAAO,CAAC,OAAO,CAGP;IACR;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAoC;IAEpD;;;;OAIG;gBACS,EACV,KAAU,EACV,KAAgB,EAChB,SAAuB,EACvB,KAAK,EACL,MAAgB,GACjB,GAAE,mBAAmB,CAAC,CAAC,CAAM;IAO9B;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAMf;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAUpB;;;;;;;;OAQG;IACG,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BtD;;;;OAIG;IACG,IAAI,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,OAAO,WAAW,CAAC;IAqBhE;;;;OAIG;IACG,KAAK,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAa/C;;;;OAIG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAcjE;;;;;OAKG;IACH,OAAO,IAAI,OAAO;IAGlB;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAGlB;;;;OAIG;IACI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC;CAStE"}

package/dist/async-channel.js

@@ -9,20 +9,6 @@
  * @name CHANNEL_END
  */
 export const CHANNEL_END = Symbol("CHANNEL_END");
-/**
- * Creates a promise that can be resolved/rejected outside of initial closure
- * @kind function
- * @name InvertedPromise
- * @ignore
- */
-const InvertedPromise = () => {
-    const out = {};
-    out.promise = new Promise((resolve, reject) => {
-        out.resolve = resolve;
-        out.reject = reject;
-    });
-    return out;
-};
 /**
  * Asynchronous Channel class
  * @kind class
@@ -33,9 +19,15 @@ export class AsyncChannel {
     cache;
     transform;
     debug;
-    promise;
-    resolve;
-    reject;
+    errors;
+    /**
+     * Consumers waiting in take(), served FIFO. Before 0.0.1 this was a
+     * single slot, so a second concurrent take() replaced the first, which
+     * then never resolved.
+     */
+    takers = [];
+    /** Errors queued by throw() (as opposed to Error objects put() as values). */
+    thrown = new WeakSet();
     /** Producers awaiting capacity, FIFO (backpressure -- see put()). */
     putters = [];
     /**
@@ -51,11 +43,23 @@ export class AsyncChannel {
      * @kind function
      * @name constructor
      */
-    constructor({ cache = [], limit = Infinity, transform = ($) => $, debug } = {}) {
+    constructor({ cache = [], limit = Infinity, transform = ($) => $, debug, errors = "value", } = {}) {
         this.limit = limit;
         this.cache = cache.slice(0, limit);
         this.transform = transform;
         this.debug = debug;
+        this.errors = errors;
+    }
+    /**
+     * Hand an item that came off the cache or a producer to a take() caller:
+     * with `errors: "throw"`, an error queued by throw() rejects.
+     * @ignore
+     */
+    deliver(value) {
+        if (this.errors === "throw" && value instanceof Error && this.thrown.has(value)) {
+            throw value;
+        }
+        return value;
     }
     /**
      * Move waiting producers' items into the cache while there is capacity,
@@ -91,8 +95,9 @@ export class AsyncChannel {
         try {
             const value = await this.transform(item);
             await myTurn;
-            if (this.promise) {
-                this.resolve?.(value);
+            const taker = this.takers.shift();
+            if (taker) {
+                taker.resolve(value);
                 return;
             }
             if (this.cache.length < this.limit) {
@@ -117,24 +122,18 @@ export class AsyncChannel {
         if (this.cache.length) {
             const value = this.cache.shift();
             this.drainPutters();
-            return value;
+            return this.deliver(value);
         }
         if (this.putters.length) {
             // limit of 0 (rendezvous) or drained cache with waiting producers:
             // hand off directly.
             const { value, release } = this.putters.shift();
             release();
-            return value;
+            return this.deliver(value);
         }
-        const { promise, resolve, reject } = InvertedPromise();
-        this.promise = promise;
-        this.resolve = resolve;
-        this.reject = reject;
-        const value = await this.promise;
-        delete this.promise;
-        delete this.resolve;
-        delete this.reject;
-        return value;
+        return new Promise((resolve, reject) => {
+            this.takers.push({ resolve, reject });
+        });
     }
     /**
      * Pause Asynchronous Channel
@@ -143,8 +142,9 @@ export class AsyncChannel {
      */
     async break(...debug) {
         this.debug?.("break", ...debug);
-        if (this.promise) {
-            await this.resolve?.(CHANNEL_END);
+        const taker = this.takers.shift();
+        if (taker) {
+            taker.resolve(CHANNEL_END);
         }
         else if (this.putters.length > 0) {
             // Keep FIFO order: the end marker must not overtake producers
@@ -162,15 +162,18 @@ export class AsyncChannel {
      */
     async throw(message, ...debug) {
         this.debug?.("throw", ...debug);
-        if (this.promise) {
-            await this.reject?.(new Error(message));
+        const error = new Error(message);
+        this.thrown.add(error);
+        const taker = this.takers.shift();
+        if (taker) {
+            taker.reject(error);
         }
         else if (this.putters.length > 0) {
             // Keep FIFO order behind producers already waiting for capacity.
-            this.putters.push({ value: new Error(message), release: () => { } });
+            this.putters.push({ value: error, release: () => { } });
         }
         else {
-            this.cache.push(new Error(message));
+            this.cache.push(error);
         }
     }
     /**
@@ -180,7 +183,7 @@ export class AsyncChannel {
      * Note: should this be a getter?
      */
     pending() {
-        return !!this.promise;
+        return this.takers.length > 0;
     }
     /**
      * Return string representation of Asynchronous Channel

package/dist/async-channel.js.map

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

package/dist/combine.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Combinators for live values and events: merge several async sources,
+ * combine their latest values, sample one by another, and conflate a fast
+ * source down to its newest value.
+ *
+ * Every combinator here:
+ * - accepts async or sync iterables as inputs;
+ * - takes an optional `{ signal }`; on abort it rejects with the signal's
+ *   reason (an "AbortError" DOMException by default);
+ * - closes (`return()`) every input that has not ended when it finishes,
+ *   when an input errors, when the signal aborts, and when the consumer
+ *   exits early (`break`, or calling `return()` on it). An input with a
+ *   `next()` still pending is closed without waiting for that `next()`.
+ *
+ * The "latest value" combinators (combineLatestAsync, withLatestFromAsync,
+ * latestAsync, sampleAsync) drain some inputs eagerly: they keep pulling
+ * from them whether or not the consumer is reading, and keep only the
+ * newest value. Like every generator in this library they start when the
+ * consumer first calls `next()`.
+ */
+import { type SignalOptions } from "./abort.ts";
+import { type AnyIterable } from "./internal.ts";
+/** The value type of an async or sync iterable. */
+export type IteratedValue<I> = I extends AsyncIterable<infer V> ? V : I extends Iterable<infer V> ? V : never;
+/** Inputs for combineLatestAsync / withLatestFromAsync: an array or a record of iterables. */
+export type IterableShape = readonly AnyIterable<unknown>[] | {
+    readonly [key: string]: AnyIterable<unknown>;
+};
+/** A snapshot with the same shape as its inputs: each iterable replaced by its latest value. */
+export type LatestOf<I> = {
+    -readonly [K in keyof I]: IteratedValue<I[K]>;
+};
+/**
+ * Merge several (async or sync) iterables into one, yielding each value as
+ * it arrives from any input. Ends when every input has ended.
+ *
+ * - Lazy: each input has at most one `next()` outstanding, and the next
+ *   value is requested from an input only after its previous value has
+ *   been consumed. Inputs that are ready at the same time are served in
+ *   rotation, so a fast or synchronous input cannot starve the others.
+ * - An error from any input closes the others and is rethrown.
+ * - Consumer exit or abort closes every input.
+ *
+ * Pass `{ signal }` as the last argument.
+ * @kind function
+ * @name mergeAsync
+ * @example
+ * ```javascript
+ * for await (const event of mergeAsync(clicks, keys, { signal })) { ... }
+ * ```
+ */
+export declare function mergeAsync<T>(...inputs: Array<AnyIterable<T>>): AsyncGenerator<T>;
+export declare function mergeAsync<T>(...args: [...inputs: Array<AnyIterable<T>>, options: SignalOptions]): AsyncGenerator<T>;
+export interface CombineLatestOptions<I> extends SignalOptions {
+    /**
+     * Starting values for some or all inputs (same shape as the inputs), so a
+     * snapshot can be emitted before those inputs have yielded. They are not
+     * emitted on their own: the first snapshot still waits for an input to
+     * yield.
+     */
+    initial?: Partial<LatestOf<I>>;
+    /**
+     * `"all"` (default): end once every input has ended. `"any"`: end as
+     * soon as any input ends. Either way, an input that ends without ever
+     * having a value (and no `initial` for it) ends the output at once,
+     * since no complete snapshot can ever be made.
+     */
+    endOn?: "all" | "any";
+}
+/**
+ * Combine the latest values of several inputs. `inputs` is an array or a
+ * record of (async or sync) iterables; each output is a snapshot of the
+ * same shape holding every input's latest value. A snapshot is emitted
+ * whenever an input yields, once every input has a value (from the input
+ * itself or from `initial`).
+ *
+ * Latest-wins: inputs are drained eagerly, and while the consumer is busy
+ * the snapshots that would have been emitted coalesce into one, holding
+ * the newest values. Every snapshot is a fresh object.
+ *
+ * An input error closes the others and is rethrown (a pending snapshot is
+ * dropped). Consumer exit or abort closes every input.
+ * @kind function
+ * @name combineLatestAsync
+ * @example
+ * ```javascript
+ * for await (const { x, y } of combineLatestAsync({ x: xs, y: ys })) { ... }
+ * ```
+ */
+export declare const combineLatestAsync: <const I extends IterableShape>(inputs: I, { signal, initial, endOn }?: CombineLatestOptions<I>) => AsyncGenerator<LatestOf<I>>;
+/**
+ * Pair each value of `source` with the latest value of each of `others`
+ * (an array or a record of iterables): yields `[value, snapshot]`, where
+ * `snapshot` has the same shape as `others`. This is the "an event samples
+ * values" pattern.
+ *
+ * `source` is pulled lazily, as the consumer reads; `others` are drained
+ * eagerly. Source values that arrive before every one of `others` has a
+ * value are dropped. An input in `others` that ends keeps its last value.
+ * Ends when `source` ends. An error from any input closes the rest and is
+ * rethrown; consumer exit or abort closes every input.
+ * @kind function
+ * @name withLatestFromAsync
+ * @example
+ * ```javascript
+ * for await (const [click, { price }] of withLatestFromAsync(clicks, { price: prices })) { ... }
+ * ```
+ */
+export declare const withLatestFromAsync: <T, const I extends IterableShape>(source: AnyIterable<T>, others: I, { signal }?: SignalOptions) => AsyncGenerator<[T, LatestOf<I>]>;
+/**
+ * Conflate a source down to its newest value. The source is drained
+ * eagerly; only the newest value not yet read is kept. Each `next()`
+ * returns that value, or waits for the next one. A value is returned at
+ * most once.
+ *
+ * Ends once the source has ended and its last value has been read. A source
+ * error is rethrown on the next read (an unread value is dropped). Closing
+ * the result, or aborting, closes the source.
+ * @kind function
+ * @name latestAsync
+ * @example
+ * ```javascript
+ * for await (const position of latestAsync(pointerMoves)) {
+ *   await render(position); // never falls behind: stale positions are skipped
+ * }
+ * ```
+ */
+export declare const latestAsync: <T>(iterable: AnyIterable<T>, { signal }?: SignalOptions) => AsyncGenerator<T>;
+/**
+ * On each value from `trigger`, yield the latest value of `source`, if it
+ * has produced one yet. The same source value is yielded again on every
+ * trigger until the source produces a new one.
+ *
+ * `source` is drained eagerly; `trigger` is pulled lazily, as the consumer
+ * reads. Ends when `trigger` ends (a source that ends keeps its last
+ * value). An error from either closes the other and is rethrown; consumer
+ * exit or abort closes both.
+ * @kind function
+ * @name sampleAsync
+ * @example
+ * ```javascript
+ * for await (const position of sampleAsync(pointerMoves, animationFrames)) { ... }
+ * ```
+ */
+export declare const sampleAsync: <T>(source: AnyIterable<T>, trigger: AnyIterable<unknown>, { signal }?: SignalOptions) => AsyncGenerator<T>;
+//# sourceMappingURL=combine.d.ts.map

package/dist/combine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combine.d.ts","sourceRoot":"","sources":["../src/combine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,YAAY,CAAC;AAChE,OAAO,EACL,KAAK,WAAW,EASjB,MAAM,eAAe,CAAC;AAEvB,mDAAmD;AACnD,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE9G,8FAA8F;AAC9F,MAAM,MAAM,aAAa,GAAG,SAAS,WAAW,CAAC,OAAO,CAAC,EAAE,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC;AAE/G,gGAAgG;AAChG,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;IAAE,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAyD5E;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;AACnF,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;AA4CtH,MAAM,WAAW,oBAAoB,CAAC,CAAC,CAAE,SAAQ,aAAa;IAC5D;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB,GAAoB,KAAK,CAAC,CAAC,SAAS,aAAa,EAC9E,QAAQ,CAAC,EACT,6BAAoC,oBAAoB,CAAC,CAAC,CAAM,KAC/D,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAyD5B,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB,GAAoB,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,aAAa,EAClF,QAAQ,WAAW,CAAC,CAAC,CAAC,EACtB,QAAQ,CAAC,EACT,aAAY,aAAkB,KAC7B,cAAc,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAmCjC,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,WAAW,GAAoB,CAAC,EAC3C,UAAU,WAAW,CAAC,CAAC,CAAC,EACxB,aAAY,aAAkB,KAC7B,cAAc,CAAC,CAAC,CA6ClB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW,GAAoB,CAAC,EAC3C,QAAQ,WAAW,CAAC,CAAC,CAAC,EACtB,SAAS,WAAW,CAAC,OAAO,CAAC,EAC7B,aAAY,aAAkB,KAC7B,cAAc,CAAC,CAAC,CAgClB,CAAC"}