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

package/dist/esm/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/esm/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"}

package/dist/esm/util/Promises.js

@@ -0,0 +1,179 @@
+/**
+ * Utils for promises.
+ *
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InternalError, MatterError } from "../MatterError.js";
+import { Time } from "../time/Time.js";
+function createPromise() {
+  let resolver, rejecter;
+  const promise = new Promise((resolve, reject) => {
+    resolver = resolve;
+    rejecter = reject;
+  });
+  if (!resolver || !rejecter) {
+    throw new InternalError("Failed to extract resolve/reject from Promise context");
+  }
+  return {
+    promise,
+    resolver,
+    rejecter
+  };
+}
+function anyPromise(promises) {
+  return new Promise((resolve, reject) => {
+    let numberRejected = 0;
+    let wasResolved = false;
+    for (const entry of promises) {
+      const promise = typeof entry === "function" ? entry() : entry;
+      promise.then((value) => {
+        if (!wasResolved) {
+          wasResolved = true;
+          resolve(value);
+        }
+      }).catch((reason) => {
+        numberRejected++;
+        if (!wasResolved && numberRejected === promises.length) {
+          reject(reason);
+        }
+      });
+    }
+  });
+}
+class PromiseTimeoutError extends MatterError {
+  constructor(message = "Operation timed out") {
+    super(message);
+  }
+}
+async function withTimeout(timeoutMs, promise, cancel) {
+  let cancelFn;
+  if (typeof cancel === "function") {
+    cancelFn = cancel;
+  } else if (typeof cancel?.abort === "function") {
+    cancelFn = () => cancel.abort();
+  } else {
+    cancelFn = () => {
+      throw new PromiseTimeoutError();
+    };
+  }
+  let cancelTimer;
+  const timeout = new Promise((resolve, reject) => {
+    const timer = Time.getTimer("promise-timeout", timeoutMs, () => reject(cancelFn));
+    cancelTimer = () => {
+      timer.stop();
+      resolve();
+    };
+    timer.start();
+  });
+  let result;
+  const producer = promise.then(
+    (r) => {
+      cancelTimer?.();
+      result = r;
+    },
+    (e) => {
+      cancelTimer?.();
+      throw e;
+    }
+  );
+  await Promise.all([timeout, producer]);
+  return result;
+}
+const MaybePromise = {
+  /**
+   * Determine whether a {@link MaybePromiseLike} is a {@link Promise}.
+   */
+  is(value) {
+    return typeof value === "object" && value !== null && typeof value.then === "function";
+  },
+  /**
+   * 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(producer, resolve, reject) {
+    let rejected = false;
+    try {
+      let value;
+      if (producer instanceof Function) {
+        value = producer();
+      } else {
+        value = producer;
+      }
+      if (MaybePromise.is(value)) {
+        return value.then(
+          resolve,
+          reject ? (error) => {
+            rejected = true;
+            return reject?.(error);
+          } : void 0
+        );
+      }
+      if (resolve) {
+        return resolve(value);
+      }
+    } catch (e) {
+      if (reject && !rejected) {
+        return reject(e);
+      }
+      throw e;
+    }
+    return void 0;
+  },
+  /**
+   * Equivalent of {@link Promise.catch}.
+   */
+  catch(producer, onrejected) {
+    return this.then(producer, void 0, onrejected);
+  },
+  /**
+   * Equivalent of {@link Promise.finally}.
+   */
+  finally(producer, onfinally) {
+    let result;
+    try {
+      if (typeof producer === "function") {
+        result = producer();
+      } else {
+        result = producer;
+      }
+    } finally {
+      if (MaybePromise.is(result)) {
+        if (typeof result.finally === "function") {
+          result = result.finally(onfinally);
+        } else {
+          result = result.then(
+            (value) => MaybePromise.then(
+              () => onfinally?.(),
+              () => value
+            ),
+            (error) => MaybePromise.then(
+              () => onfinally?.(),
+              () => {
+                throw error;
+              }
+            )
+          );
+        }
+      } else {
+        const finallyResult = onfinally?.();
+        if (MaybePromise.is(finallyResult)) {
+          const actualResult = result;
+          result = finallyResult.then(() => actualResult);
+        }
+      }
+    }
+    return result;
+  },
+  [Symbol.toStringTag]: "MaybePromise"
+};
+MaybePromise.toString = () => "MaybePromise";
+export {
+  MaybePromise,
+  PromiseTimeoutError,
+  anyPromise,
+  createPromise,
+  withTimeout
+};
+//# sourceMappingURL=Promises.js.map

package/dist/esm/util/Promises.js.map

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

package/dist/esm/util/Set.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Observable } from "./Observable.js";
+/**
+ * A read-only set.
+ */
+export interface ImmutableSet<T> {
+    [Symbol.iterator]: () => Iterator<T, undefined>;
+    has(item: T): boolean;
+    get size(): number;
+    find(predicate: (item: T) => boolean | undefined): T | undefined;
+    filter(predicate: (item: T) => boolean | undefined): T[];
+}
+/**
+ * A write-only set.
+ */
+export interface MutableSet<T, AddT = T> {
+    add(definition: AddT): void;
+    delete(definition: T): boolean;
+    clear(): void;
+}
+/**
+ * Set change events.
+ */
+export interface ObservableSet<T> {
+    get added(): Observable<[T]>;
+    get deleted(): Observable<[T]>;
+}
+/**
+ * An interface for index set lookup.
+ */
+export interface IndexedSet<T> {
+    get<F extends keyof T>(field: F, value: T[F]): T | undefined;
+}
+/**
+ * A generic set implementation supporting all interfaces in this module.
+ *
+ * Unused features have minimal performance impact.
+ */
+export declare class BasicSet<T, AddT = T> implements ImmutableSet<T>, MutableSet<T, AddT>, ObservableSet<T>, IndexedSet<T> {
+    #private;
+    constructor(...initialItems: AddT[]);
+    [Symbol.iterator](): SetIterator<T>;
+    get size(): number;
+    map<R>(mapper: (item: T) => R): R[];
+    find(predicate: (item: T) => boolean | undefined): T | undefined;
+    filter(predicate: (item: T) => boolean | undefined): T[];
+    has(item: T): boolean;
+    add(item: AddT): void;
+    get<F extends keyof T>(field: F, value: T[F]): T | undefined;
+    delete(item: T): boolean;
+    clear(): void;
+    get added(): Observable<[T], void>;
+    get deleted(): Observable<[T], void>;
+    protected create(definition: AddT): T;
+}
+//# sourceMappingURL=Set.d.ts.map

package/dist/esm/util/Set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Set.d.ts","sourceRoot":"","sources":["../../../src/util/Set.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC3B,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAChD,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC;IACtB,IAAI,IAAI,IAAI,MAAM,CAAC;IACnB,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,SAAS,GAAG,CAAC,GAAG,SAAS,CAAC;IACjE,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,SAAS,GAAG,CAAC,EAAE,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC;IACnC,GAAG,CAAC,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,UAAU,EAAE,CAAC,GAAG,OAAO,CAAC;IAC/B,KAAK,IAAI,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC5B,IAAI,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IACzB,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;CAChE;AAED;;;;GAIG;AACH,qBAAa,QAAQ,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;;gBAQnG,GAAG,YAAY,EAAE,IAAI,EAAE;IAMnC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAIjB,IAAI,IAAI,WAEP;IAED,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;IAI7B,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,SAAS;IAQhD,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,SAAS;IAUlD,GAAG,CAAC,IAAI,EAAE,CAAC;IAIX,GAAG,CAAC,IAAI,EAAE,IAAI;IA4Bd,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAmB5C,MAAM,CAAC,IAAI,EAAE,CAAC;IAwBd,KAAK;IAIL,IAAI,KAAK,0BAKR;IAED,IAAI,OAAO,0BAKV;IAED,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,GACG,CAAC;CAExC"}

package/dist/esm/util/Set.js

@@ -0,0 +1,125 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Observable } from "./Observable.js";
+class BasicSet {
+  #entries = /* @__PURE__ */ new Set();
+  #added;
+  #deleted;
+  #indices;
+  constructor(...initialItems) {
+    for (const item of initialItems) {
+      this.add(item);
+    }
+  }
+  [Symbol.iterator]() {
+    return this.#entries[Symbol.iterator]();
+  }
+  get size() {
+    return this.#entries.size;
+  }
+  map(mapper) {
+    return [...this].map(mapper);
+  }
+  find(predicate) {
+    for (const item of this) {
+      if (predicate(item)) {
+        return item;
+      }
+    }
+  }
+  filter(predicate) {
+    const result = new Array();
+    for (const item of this) {
+      if (predicate(item)) {
+        result.push(item);
+      }
+    }
+    return result;
+  }
+  has(item) {
+    return this.#entries.has(item);
+  }
+  add(item) {
+    const created = this.create(item);
+    if (this.#entries.has(item)) {
+      return;
+    }
+    this.#entries.add(item);
+    if (this.#indices) {
+      for (const field in this.#indices) {
+        const value = created[field];
+        if (value === void 0) {
+          continue;
+        }
+        const index = this.#indices[field];
+        if (index === void 0 || index.has(value)) {
+          continue;
+        }
+        index.set(value, created);
+      }
+    }
+    this.#added?.emit(created);
+  }
+  get(field, value) {
+    if (!this.#indices) {
+      this.#indices = {};
+    }
+    let index = this.#indices[field];
+    if (index === void 0) {
+      index = /* @__PURE__ */ new Map();
+      for (const item of this) {
+        const value2 = item[field];
+        if (value2 === void 0 || index.has(value2)) {
+          continue;
+        }
+        index.set(value2, item);
+      }
+      this.#indices[field] = index;
+    }
+    return index?.get(value);
+  }
+  delete(item) {
+    if (!this.#entries.delete(item)) {
+      return false;
+    }
+    if (this.#indices) {
+      for (const field in this.#indices) {
+        const value = item[field];
+        if (value === void 0) {
+          continue;
+        }
+        const index = this.#indices[field];
+        if (index !== void 0 && index.get(value) === item) {
+          index.delete(value);
+        }
+      }
+    }
+    this.#deleted?.emit(item);
+    return true;
+  }
+  clear() {
+    this.#entries.clear();
+  }
+  get added() {
+    if (this.#added === void 0) {
+      this.#added = Observable();
+    }
+    return this.#added;
+  }
+  get deleted() {
+    if (this.#deleted === void 0) {
+      this.#deleted = Observable();
+    }
+    return this.#deleted;
+  }
+  create(definition) {
+    return definition;
+  }
+}
+export {
+  BasicSet
+};
+//# sourceMappingURL=Set.js.map

package/dist/esm/util/Set.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/Set.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,kBAAkB;AA0CpB,MAAM,SAAuG;AAAA,EAChH,WAAW,oBAAI,IAAO;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EAIA,eAAe,cAAsB;AACjC,eAAW,QAAQ,cAAc;AAC7B,WAAK,IAAI,IAAI;AAAA,IACjB;AAAA,EACJ;AAAA,EAEA,CAAC,OAAO,QAAQ,IAAI;AAChB,WAAO,KAAK,SAAS,OAAO,QAAQ,EAAE;AAAA,EAC1C;AAAA,EAEA,IAAI,OAAO;AACP,WAAO,KAAK,SAAS;AAAA,EACzB;AAAA,EAEA,IAAO,QAAwB;AAC3B,WAAO,CAAC,GAAG,IAAI,EAAE,IAAI,MAAM;AAAA,EAC/B;AAAA,EAEA,KAAK,WAA6C;AAC9C,eAAW,QAAQ,MAAM;AACrB,UAAI,UAAU,IAAI,GAAG;AACjB,eAAO;AAAA,MACX;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,OAAO,WAA6C;AAChD,UAAM,SAAS,IAAI,MAAS;AAC5B,eAAW,QAAQ,MAAM;AACrB,UAAI,UAAU,IAAI,GAAG;AACjB,eAAO,KAAK,IAAI;AAAA,MACpB;AAAA,IACJ;AACA,WAAO;AAAA,EACX;AAAA,EAEA,IAAI,MAAS;AACT,WAAO,KAAK,SAAS,IAAI,IAAI;AAAA,EACjC;AAAA,EAEA,IAAI,MAAY;AACZ,UAAM,UAAU,KAAK,OAAO,IAAI;AAEhC,QAAI,KAAK,SAAS,IAAI,IAAW,GAAG;AAChC;AAAA,IACJ;AAEA,SAAK,SAAS,IAAI,IAAW;AAE7B,QAAI,KAAK,UAAU;AACf,iBAAW,SAAS,KAAK,UAAU;AAC/B,cAAM,QAAQ,QAAQ,KAAK;AAC3B,YAAI,UAAU,QAAW;AACrB;AAAA,QACJ;AAEA,cAAM,QAAQ,KAAK,SAAS,KAAK;AACjC,YAAI,UAAU,UAAa,MAAM,IAAI,KAAK,GAAG;AACzC;AAAA,QACJ;AAEA,cAAM,IAAI,OAAO,OAAO;AAAA,MAC5B;AAAA,IACJ;AAEA,SAAK,QAAQ,KAAK,OAAO;AAAA,EAC7B;AAAA,EAEA,IAAuB,OAAU,OAAa;AAC1C,QAAI,CAAC,KAAK,UAAU;AAChB,WAAK,WAAW,CAAC;AAAA,IACrB;AACA,QAAI,QAAQ,KAAK,SAAS,KAAK;AAC/B,QAAI,UAAU,QAAW;AACrB,cAAQ,oBAAI,IAAY;AACxB,iBAAW,QAAQ,MAAM;AACrB,cAAMA,SAAQ,KAAK,KAAK;AACxB,YAAIA,WAAU,UAAa,MAAM,IAAIA,MAAK,GAAG;AACzC;AAAA,QACJ;AACA,cAAM,IAAIA,QAAO,IAAI;AAAA,MACzB;AACA,WAAK,SAAS,KAAK,IAAI;AAAA,IAC3B;AACA,WAAO,OAAO,IAAI,KAAK;AAAA,EAC3B;AAAA,EAEA,OAAO,MAAS;AACZ,QAAI,CAAC,KAAK,SAAS,OAAO,IAAI,GAAG;AAC7B,aAAO;AAAA,IACX;AAEA,QAAI,KAAK,UAAU;AACf,iBAAW,SAAS,KAAK,UAAU;AAC/B,cAAM,QAAQ,KAAK,KAAK;AACxB,YAAI,UAAU,QAAW;AACrB;AAAA,QACJ;AAEA,cAAM,QAAQ,KAAK,SAAS,KAAK;AACjC,YAAI,UAAU,UAAa,MAAM,IAAI,KAAK,MAAM,MAAM;AAClD,gBAAM,OAAO,KAAK;AAAA,QACtB;AAAA,MACJ;AAAA,IACJ;AAEA,SAAK,UAAU,KAAK,IAAI;AAExB,WAAO;AAAA,EACX;AAAA,EAEA,QAAQ;AACJ,SAAK,SAAS,MAAM;AAAA,EACxB;AAAA,EAEA,IAAI,QAAQ;AACR,QAAI,KAAK,WAAW,QAAW;AAC3B,WAAK,SAAS,WAAW;AAAA,IAC7B;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,UAAU;AACV,QAAI,KAAK,aAAa,QAAW;AAC7B,WAAK,WAAW,WAAW;AAAA,IAC/B;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEU,OAAO,YAAkB;AAC/B,WAAO;AAAA,EACX;AACJ;",
+  "names": ["value"]
+}

package/dist/esm/util/Singleton.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare function singleton<T>(create: () => T): () => T;
+//# sourceMappingURL=Singleton.d.ts.map

package/dist/esm/util/Singleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Singleton.d.ts","sourceRoot":"","sources":["../../../src/util/Singleton.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,WAM3C"}

package/dist/esm/util/Singleton.js

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function singleton(create) {
+  let instance;
+  return () => {
+    if (instance === void 0) instance = create();
+    return instance;
+  };
+}
+export {
+  singleton
+};
+//# sourceMappingURL=Singleton.js.map

package/dist/esm/util/Singleton.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/Singleton.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMO,SAAS,UAAa,QAAiB;AAC1C,MAAI;AACJ,SAAO,MAAM;AACT,QAAI,aAAa,OAAW,YAAW,OAAO;AAC9C,WAAO;AAAA,EACX;AACJ;",
+  "names": []
+}

package/dist/esm/util/Stream.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MatterError } from "../MatterError.js";
+export declare class EndOfStreamError extends MatterError {
+    constructor(message?: string);
+}
+export declare class NoResponseTimeoutError extends MatterError {
+}
+export interface Stream<T> {
+    read(): Promise<T>;
+    write(data: T): Promise<void>;
+}
+//# sourceMappingURL=Stream.d.ts.map

package/dist/esm/util/Stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stream.d.ts","sourceRoot":"","sources":["../../../src/util/Stream.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,qBAAa,gBAAiB,SAAQ,WAAW;gBACjC,OAAO,SAA6B;CAGnD;AAED,qBAAa,sBAAuB,SAAQ,WAAW;CAAG;AAE1D,MAAM,WAAW,MAAM,CAAC,CAAC;IACrB,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;IACnB,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC"}

package/dist/esm/util/Stream.js

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MatterError } from "../MatterError.js";
+class EndOfStreamError extends MatterError {
+  constructor(message = "Unexpected end of stream") {
+    super(message);
+  }
+}
+class NoResponseTimeoutError extends MatterError {
+}
+export {
+  EndOfStreamError,
+  NoResponseTimeoutError
+};
+//# sourceMappingURL=Stream.js.map

package/dist/esm/util/Stream.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/Stream.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,SAAS,mBAAmB;AAErB,MAAM,yBAAyB,YAAY;AAAA,EAC9C,YAAY,UAAU,4BAA4B;AAC9C,UAAM,OAAO;AAAA,EACjB;AACJ;AAEO,MAAM,+BAA+B,YAAY;AAAC;",
+  "names": []
+}

package/dist/esm/util/String.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare function capitalize<T extends string>(text: T): Capitalize<T>;
+/**
+ * Converts identifiers of the form "foo-bar", "foo_bar", "foo bar", "foo*bar",
+ * "fooBar" or "FOOBar" into "fooBar" or "FooBar".
+ */
+export declare function camelize(name: string, upperFirst?: boolean): string;
+/**
+ * Converts an identifier from CamelCase to snake_case.
+ */
+export declare function decamelize(name: string, separator?: string): string;
+/**
+ * Like JSON.stringify but targets well-formed JS and is slightly more readable.
+ */
+export declare function serialize(value: any): string | undefined;
+export declare namespace serialize {
+    /**
+     * Custom serialization function key.
+     */
+    const SERIALIZE: unique symbol;
+    /**
+     * Mark a value as serialized so the serializer just uses its string
+     * representation.
+     */
+    function asIs(value: any): any;
+    /**
+     * Test whether a value serializes as a structure or a primitive.
+     */
+    function isPrimitive(value: any): boolean;
+}
+/**
+ * Create a human readable version of a list of items.
+ */
+export declare function describeList(setType: "and" | "or", ...entries: string[]): string;
+//# sourceMappingURL=String.d.ts.map

package/dist/esm/util/String.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"String.d.ts","sourceRoot":"","sources":["../../../src/util/String.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GACE,UAAU,CAAC,CAAC,CAAC,CAClE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,UAAQ,UA8DxD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAM,UAgBvD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,sBA8EnC;AAED,yBAAiB,SAAS,CAAC;IACvB;;OAEG;IACI,MAAM,SAAS,eAAsB,CAAC;IAE7C;;;OAGG;IACH,SAAgB,IAAI,CAAC,KAAK,EAAE,GAAG,OAU9B;IAED;;OAEG;IACH,SAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,WAgBrC;CACJ;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,UAkBvE"}