@matter/general 0.11.0-alpha.0-20241005-e3e4e4a7a

package/dist/cjs/util/Observable.js

@@ -0,0 +1,340 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Observable_exports = {};
+__export(Observable_exports, {
+  AsyncObservable: () => AsyncObservable,
+  BasicObservable: () => BasicObservable,
+  EventEmitter: () => EventEmitter,
+  Observable: () => Observable,
+  ObservableProxy: () => ObservableProxy,
+  ObserverGroup: () => ObserverGroup,
+  observant: () => observant
+});
+module.exports = __toCommonJS(Observable_exports);
+var import_MatterError = require("../MatterError.js");
+var import_Logger = require("../log/Logger.js");
+var import_disposable = require("../polyfills/disposable.js");
+var import_Promises = require("./Promises.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_Logger.Logger.get("Observable");
+const observant = Symbol("consider-observed");
+function defaultErrorHandler(error) {
+  throw error;
+}
+class BasicObservable {
+  #errorHandler;
+  #observers;
+  #once;
+  #isAsync;
+  #joinIteration;
+  #removeIterator;
+  #stopIteration;
+  constructor(errorHandler, isAsync) {
+    this.#errorHandler = errorHandler ?? defaultErrorHandler;
+    this.#isAsync = isAsync;
+  }
+  [Symbol.dispose]() {
+    this.#observers = this.#once = void 0;
+    this.#stopIteration?.();
+  }
+  get isAsync() {
+    return this.#isAsync;
+  }
+  set isAsync(isAsync) {
+    this.#isAsync = isAsync;
+  }
+  get isObserved() {
+    if (this.#observers) {
+      for (const observer of this.#observers) {
+        if (observer[observant] !== false) {
+          return true;
+        }
+      }
+    }
+    if (this.#once) {
+      for (const observer of this.#once) {
+        if (observer[observant] !== false) {
+          return true;
+        }
+      }
+    }
+    return false;
+  }
+  isObservedBy(observer) {
+    return !!this.#observers?.has(observer);
+  }
+  emit(...payload) {
+    if (!this.#observers) {
+      return;
+    }
+    const iterator = [...this.#observers][Symbol.iterator]();
+    const emitNext = (previousEmitResult) => {
+      if (previousEmitResult !== void 0) {
+        return previousEmitResult;
+      }
+      for (let iteration = iterator.next(); !iteration.done; iteration = iterator.next()) {
+        let result;
+        const observer = iteration.value;
+        try {
+          result = observer(...payload);
+        } catch (e) {
+          if (e instanceof Error) {
+            this.#errorHandler(e, observer);
+          } else {
+            this.#errorHandler(new Error(`${e}`), observer);
+          }
+        }
+        if (this.#once?.has(observer)) {
+          this.#once.delete(observer);
+          this.#observers?.delete(observer);
+        }
+        if (result === void 0) {
+          continue;
+        }
+        if (import_Promises.MaybePromise.is(result)) {
+          if (!this.isAsync) {
+            let identity;
+            if (observer.name) {
+              identity = ` "${observer.name}"`;
+            } else {
+              identity = "";
+            }
+            result.then(
+              void 0,
+              (error) => logger.error(`Unhandled error in async observer${identity}:`, error)
+            );
+            continue;
+          }
+          return result.then((result2) => {
+            if (result2 === void 0) {
+              return emitNext();
+            }
+            return result2;
+          });
+        }
+        return result;
+      }
+    };
+    return emitNext();
+  }
+  on(observer) {
+    if (!this.#observers) {
+      this.#observers = /* @__PURE__ */ new Set();
+    }
+    this.#observers.add(observer);
+  }
+  off(observer) {
+    this.#observers?.delete(observer);
+  }
+  once(observer) {
+    this.on(observer);
+    if (!this.#once) {
+      this.#once = /* @__PURE__ */ new Set();
+    }
+    this.#once.add(observer);
+  }
+  then(onfulfilled, onrejected) {
+    return new Promise((resolve) => {
+      this.once((...payload) => {
+        resolve(payload);
+      });
+    }).then(onfulfilled, onrejected);
+  }
+  async *[Symbol.asyncIterator]() {
+    let promise = this.#addIterator();
+    try {
+      while (promise) {
+        const next = await promise;
+        if (next) {
+          promise = next.promise;
+          yield next.value;
+        }
+      }
+    } finally {
+      this.#removeIterator?.();
+    }
+  }
+  #addIterator() {
+    if (this.#joinIteration) {
+      return this.#joinIteration();
+    }
+    let resolve;
+    let iteratorCount = 1;
+    function newPromise() {
+      return new Promise((r) => resolve = r);
+    }
+    let promise = newPromise();
+    function observer(...args) {
+      const oldResolve = resolve;
+      promise = newPromise();
+      oldResolve({ value: args[0], promise });
+    }
+    this.on(observer);
+    this.#joinIteration = () => {
+      iteratorCount++;
+      return promise;
+    };
+    this.#removeIterator = () => {
+      if (!iteratorCount--) {
+        this.#stopIteration?.();
+      }
+    };
+    this.#stopIteration = () => {
+      this.off(observer);
+      resolve(void 0);
+      this.#stopIteration = void 0;
+      this.#removeIterator = void 0;
+    };
+  }
+}
+function constructObservable(errorHandler) {
+  return new BasicObservable(errorHandler);
+}
+const Observable = constructObservable;
+function constructAsyncObservable(errorHandler) {
+  return new BasicObservable(errorHandler, true);
+}
+const AsyncObservable = constructAsyncObservable;
+function event(emitter, name) {
+  const observer = emitter[name];
+  if (typeof !observer?.on !== "function") {
+    throw new import_MatterError.ImplementationError(`Invalid event name ${name}`);
+  }
+  return observer;
+}
+class EventEmitter {
+  emit(name, ...payload) {
+    event(this, name).emit(...payload);
+  }
+  addListener(name, handler) {
+    event(this, name).on(handler);
+  }
+  removeListener(name, handler) {
+    event(this, name).off(handler);
+  }
+  get eventNames() {
+    return Object.keys(this).filter((k) => typeof this[k]?.on === "function");
+  }
+  [Symbol.dispose]() {
+    for (const name of this.eventNames) {
+      this[name][Symbol.dispose]?.();
+    }
+  }
+}
+class ObservableProxy extends BasicObservable {
+  #target;
+  #emitter = super.emit.bind(this);
+  constructor(target) {
+    super();
+    Object.defineProperty(this.#emitter, observant, {
+      get() {
+        return this.isObserved;
+      }
+    });
+    this.#target = target;
+    this.#target.on(this.#emitter);
+    this.emit = this.#target.emit.bind(this.#target);
+  }
+  [Symbol.dispose]() {
+    this.#target.off(this.#emitter);
+    super[Symbol.dispose]();
+  }
+  get isAsync() {
+    return this.#target.isAsync;
+  }
+  get isObserved() {
+    return this.#target.isObserved;
+  }
+  emit;
+}
+class ObserverGroup {
+  #defaultTarget;
+  #observers = /* @__PURE__ */ new Map();
+  #boundObservers = /* @__PURE__ */ new Map();
+  constructor(target) {
+    this.#defaultTarget = target;
+  }
+  /**
+   * Add an observer.
+   *
+   * @param observable the observable to observe
+   * @param observer the observer function
+   * @param target optional "this" to bind the observer
+   */
+  on(observable, observer, target = this.#defaultTarget) {
+    if (target !== void 0) {
+      observer = observer.bind(target);
+    }
+    observable.on(observer);
+    const observers = this.#observers.get(observable);
+    if (observers === void 0) {
+      this.#observers.set(observable, [observer]);
+    } else {
+      observers.push(observer);
+    }
+  }
+  /**
+   * Remove a single observer.
+   *
+   * @param observable the observable to observe
+   * @param observer the observer function
+   * @param target if the observer was bound in {@link on} this must match the bound target
+   */
+  off(observable, observer, target = this.#defaultTarget) {
+    if (target) {
+      const observers2 = this.#boundObservers.get(observer);
+      if (observers2 === void 0) {
+        return;
+      }
+      const bound = observers2.get(target);
+      if (bound === void 0) {
+        return;
+      }
+      observers2.delete(target);
+      if (observers2.size === 0) {
+        this.#boundObservers.delete(observer);
+      }
+    }
+    const observers = this.#observers.get(observable);
+    if (observers) {
+      const index = observers.indexOf(observer);
+      if (index !== -1) {
+        observers?.splice(index, 1);
+      }
+    }
+    observable.off(observer);
+  }
+  /**
+   * Remove all observers.
+   */
+  close() {
+    for (const [observable, observers] of this.#observers.entries()) {
+      for (const observer of observers) {
+        observable.off(observer);
+      }
+    }
+    this.#observers.clear();
+    this.#boundObservers.clear();
+  }
+}
+//# sourceMappingURL=Observable.js.map

package/dist/cjs/util/Observable.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/Observable.ts"],
+  "mappings": "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",
+  "names": ["result", "observers"]
+}

package/dist/cjs/util/PromiseQueue.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * A queue that processes promises with a given concurrency and delays after each promise if desired.
+ */
+export declare class PromiseQueue {
+    #private;
+    constructor(concurrency?: number, delay?: number);
+    /**
+     * Add a promise to the queue. It returns a promise that can be awaited.
+     */
+    add<T>(executor: () => Promise<T>): Promise<T>;
+    /**
+     * Clear the queue.
+     */
+    clear(reject: boolean): void;
+    /**
+     * Close the queue and remove all outstanding promises (but do not reject them).
+     */
+    close(): void;
+}
+//# sourceMappingURL=PromiseQueue.d.ts.map

package/dist/cjs/util/PromiseQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromiseQueue.d.ts","sourceRoot":"","sources":["../../../src/util/PromiseQueue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;GAEG;AACH,qBAAa,YAAY;;gBAMT,WAAW,SAAI,EAAE,KAAK,SAAI;IAKtC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAsD9C;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAS5B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGhB"}

package/dist/cjs/util/PromiseQueue.js

@@ -0,0 +1,107 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var PromiseQueue_exports = {};
+__export(PromiseQueue_exports, {
+  PromiseQueue: () => PromiseQueue
+});
+module.exports = __toCommonJS(PromiseQueue_exports);
+var import_Time = require("#time/Time.js");
+var import_Logger = require("../log/Logger.js");
+var import_Promises = require("./Promises.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_Logger.Logger.get("PromiseQueue");
+class PromiseQueue {
+  #delay;
+  #queue = new Array();
+  #concurrency;
+  #runningCount = 0;
+  constructor(concurrency = 1, delay = 0) {
+    this.#concurrency = concurrency;
+    this.#delay = delay;
+  }
+  /**
+   * Add a promise to the queue. It returns a promise that can be awaited.
+   */
+  add(executor) {
+    const { promise, resolver, rejecter } = (0, import_Promises.createPromise)();
+    logger.debug("Add promise to queue on place", this.#queue.length + 1);
+    this.#queue.push({
+      func: () => executor().then(resolver).catch(rejecter),
+      rejecter
+    });
+    this.#run();
+    return promise;
+  }
+  /**
+   * Run the next promise in the queue.
+   */
+  #run() {
+    if (this.#runningCount >= this.#concurrency || this.#queue.length === 0) {
+      return;
+    }
+    logger.debug(
+      "Processing promise from queue ... Current queue length:",
+      this.#queue.length,
+      "Already running:",
+      this.#runningCount
+    );
+    const { func } = this.#queue.shift() ?? {};
+    if (func !== void 0) {
+      this.#runningCount++;
+      func().catch((error) => {
+        throw error;
+      }).finally(() => {
+        logger.debug("Promise processed ... Still running:", this.#runningCount - 1);
+        if (this.#delay > 0) {
+          import_Time.Time.sleep("Queue delay", this.#delay).then(() => this.#runNext()).catch((error) => {
+            throw error;
+          });
+        } else {
+          this.#runNext();
+        }
+      });
+    }
+  }
+  #runNext() {
+    this.#runningCount--;
+    this.#run();
+  }
+  /**
+   * Clear the queue.
+   */
+  clear(reject) {
+    if (reject) {
+      for (const { rejecter } of this.#queue) {
+        rejecter();
+      }
+    }
+    this.#queue.length = 0;
+  }
+  /**
+   * Close the queue and remove all outstanding promises (but do not reject them).
+   */
+  close() {
+    this.clear(false);
+  }
+}
+//# sourceMappingURL=PromiseQueue.js.map

package/dist/cjs/util/PromiseQueue.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/PromiseQueue.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,kBAAqB;AACrB,oBAAuB;AACvB,sBAA8B;AAR9B;AAAA;AAAA;AAAA;AAAA;AAUA,MAAM,SAAS,qBAAO,IAAI,cAAc;AAKjC,MAAM,aAAa;AAAA,EACb;AAAA,EACA,SAAS,IAAI,MAAsE;AAAA,EACnF;AAAA,EACT,gBAAgB;AAAA,EAEhB,YAAY,cAAc,GAAG,QAAQ,GAAG;AACpC,SAAK,eAAe;AACpB,SAAK,SAAS;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA,EAKA,IAAO,UAAwC;AAC3C,UAAM,EAAE,SAAS,UAAU,SAAS,QAAI,+BAAiB;AAEzD,WAAO,MAAM,iCAAiC,KAAK,OAAO,SAAS,CAAC;AACpE,SAAK,OAAO,KAAK;AAAA,MACb,MAAM,MAAM,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,QAAQ;AAAA,MACpD;AAAA,IACJ,CAAC;AACD,SAAK,KAAK;AACV,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,OAAa;AACT,QAAI,KAAK,iBAAiB,KAAK,gBAAgB,KAAK,OAAO,WAAW,GAAG;AACrE;AAAA,IACJ;AAEA,WAAO;AAAA,MACH;AAAA,MACA,KAAK,OAAO;AAAA,MACZ;AAAA,MACA,KAAK;AAAA,IACT;AACA,UAAM,EAAE,KAAK,IAAI,KAAK,OAAO,MAAM,KAAK,CAAC;AACzC,QAAI,SAAS,QAAW;AACpB,WAAK;AACL,WAAK,EACA,MAAM,WAAS;AACZ,cAAM;AAAA,MACV,CAAC,EACA,QAAQ,MAAM;AACX,eAAO,MAAM,wCAAwC,KAAK,gBAAgB,CAAC;AAC3E,YAAI,KAAK,SAAS,GAAG;AAEjB,2BAAK,MAAM,eAAe,KAAK,MAAM,EAChC,KAAK,MAAM,KAAK,SAAS,CAAC,EAC1B,MAAM,WAAS;AACZ,kBAAM;AAAA,UACV,CAAC;AAAA,QACT,OAAO;AACH,eAAK,SAAS;AAAA,QAClB;AAAA,MACJ,CAAC;AAAA,IACT;AAAA,EACJ;AAAA,EAEA,WAAiB;AACb,SAAK;AACL,SAAK,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QAAuB;AACzB,QAAI,QAAQ;AACR,iBAAW,EAAE,SAAS,KAAK,KAAK,QAAQ;AACpC,iBAAS;AAAA,MACb;AAAA,IACJ;AACA,SAAK,OAAO,SAAS;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA,EAKA,QAAc;AACV,SAAK,MAAM,KAAK;AAAA,EACpB;AACJ;",
+  "names": []
+}

package/dist/cjs/util/Promises.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Utils for promises.
+ *
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MatterError } from "../MatterError.js";
+/**
+ * Obtain a promise with functions to resolve and reject.
+ */
+export declare function createPromise<T>(): {
+    promise: Promise<T>;
+    resolver: (value: T) => void;
+    rejecter: (reason?: any) => void;
+};
+/**
+ * Use all promises or promise returning methods and return the first resolved promise or reject when all promises
+ * rejected
+ */
+export declare function anyPromise<T>(promises: ((() => Promise<T>) | Promise<T>)[]): Promise<T>;
+/**
+ * Thrown when a timed promise times out.
+ */
+export declare class PromiseTimeoutError extends MatterError {
+    constructor(message?: string);
+}
+/**
+ * Create a promise with a timeout.
+ *
+ * By default rejects with {@link PromiseTimeoutError} on timeout but you can override by supplying {@link cancel}.
+ *
+ * @param timeoutMs the timeout in milliseconds
+ * @param promise a promise that resolves or rejects when the timed task completes
+ * @param cancel invoked on timeout (default implementation throws {@link PromiseTimeoutError})
+ */
+export declare function withTimeout<T>(timeoutMs: number, promise: Promise<T>, cancel?: AbortController | (() => void)): Promise<T>;
+/**
+ * Return type for functions that are optionally asynchronous.
+ *
+ * TODO - as currently defined MaybePromise of a Promise incorrectly wraps as a Promise of a Promise
+ */
+export type MaybePromise<T = void> = T | PromiseLike<T>;
+/**
+ * Promise-like version of above.
+ */
+export type MaybePromiseLike<T = void> = T | PromiseLike<T>;
+export declare const MaybePromise: {
+    /**
+     * Determine whether a {@link MaybePromiseLike} is a {@link Promise}.
+     */
+    is<T>(value: MaybePromise<T>): value is PromiseLike<T>;
+    /**
+     * Chained MaybePromise.  Invokes the resolve function immediately if the {@link MaybePromise} is not a
+     * {@link Promise}, otherwise the same as a normal {@link Promise.then}.
+     */
+    then<I, O1 = never, O2 = never>(producer: MaybePromise<I> | (() => MaybePromise<I>), resolve?: ((input: I) => MaybePromise<O1>) | null, reject?: ((error: any) => MaybePromise<O2>) | null): MaybePromise<O1 | O2>;
+    /**
+     * Equivalent of {@link Promise.catch}.
+     */
+    catch<T, TResult = never>(producer: MaybePromise<T> | (() => MaybePromise<T>), onrejected?: ((reason: any) => MaybePromise<TResult>) | undefined | null): MaybePromise<TResult>;
+    /**
+     * Equivalent of {@link Promise.finally}.
+     */
+    finally<T>(producer: MaybePromise<T> | (() => MaybePromise<T>), onfinally?: (() => MaybePromise<void>) | undefined | null): MaybePromise<T>;
+    [Symbol.toStringTag]: string;
+};
+//# sourceMappingURL=Promises.d.ts.map

package/dist/cjs/util/Promises.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Promises.d.ts","sourceRoot":"","sources":["../../../src/util/Promises.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAiB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAG/D;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,KAAK;IAChC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;CACpC,CAiBA;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAqBvF;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;gBACpC,OAAO,SAAwB;CAG9C;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,MAAM,CAAC,EAAE,eAAe,GAAG,CAAC,MAAM,IAAI,CAAC,GACxC,OAAO,CAAC,CAAC,CAAC,CA4CZ;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAE5D,eAAO,MAAM,YAAY;IACrB;;OAEG;OACA,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC;IAKtD;;;OAGG;SACE,CAAC,EAAE,EAAE,UAAU,EAAE,oBACR,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,YAAY,CAAC,CAAC,CAAC,CAAC,YACzC,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,YAAY,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,WACxC,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,YAAY,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,GACnD,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC;IAsCxB;;OAEG;UACG,CAAC,EAAE,OAAO,oBACF,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,YAAY,CAAC,CAAC,CAAC,CAAC,eACtC,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI;IAK5E;;OAEG;YACK,CAAC,YACK,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,YAAY,CAAC,CAAC,CAAC,CAAC,cACvC,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,GAC1D,YAAY,CAAC,CAAC,CAAC;;CA4DrB,CAAC"}