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

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

@@ -0,0 +1,97 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ImplementationError, MatterAggregateError } from "../MatterError.js";
+import { MaybePromise } from "../util/Promises.js";
+export declare namespace Lifecycle {
+    /**
+     * Standard statuses in an object's lifecycle.
+     */
+    enum Status {
+        Unknown = "unknown",
+        Inactive = "inactive",
+        Initializing = "initializing",
+        Active = "active",
+        Crashed = "crashed",
+        Destroying = "destroying",
+        Destroyed = "destroyed"
+    }
+    /**
+     * Lifecycle status for multiple items.
+     */
+    type Map<T extends keyof any> = Record<T, Status>;
+    /**
+     * Assert subject is active.
+     */
+    function assertActive(status: Status, description?: string): void;
+}
+/**
+ * Base class for errors related to the lifecycle of a dependency.
+ */
+export declare class DependencyLifecycleError extends ImplementationError {
+    constructor(what: string, why: string);
+}
+/**
+ * Standard interface for objects that have a primary task that may initiate after construction.
+ */
+export interface Startable {
+    /**
+     * Commence with the object's primary activity.
+     *
+     * Start should have no effect if the object is already started.
+     */
+    start(): void;
+}
+/**
+ * Standard interface for objects supporting a task that may be aborted or stopped prior to destruction.
+ */
+export interface Cancellable {
+    /**
+     * Stop the object's primary activity.  This should result in termination as quickly as possible.
+     *
+     * Cancellation have no effect if the object is cancelled or otherwise in a state where cancellation is irrelevant.
+     */
+    cancel(): void;
+}
+/**
+ * Standard interface for disposing of object resources.
+ */
+export interface Destructable {
+    close(): void | Promise<void>;
+    [Symbol.dispose]?: () => void;
+    [Symbol.asyncDispose]?: () => MaybePromise<void>;
+}
+/**
+ * Thrown when a dependency is in an unsupported state.
+ */
+export declare class UnsupportedDependencyStatusError extends DependencyLifecycleError {
+}
+/**
+ * Thrown for actions that cannot be performed until further initialization occurs.
+ */
+export declare class UninitializedDependencyError extends DependencyLifecycleError {
+}
+/**
+ * Thrown for actions that cannot be performed because dependency crashed.
+ */
+export declare class CrashedDependencyError extends DependencyLifecycleError {
+    subject?: object;
+}
+/**
+ * Thrown for actions that cannot be performed because a dependency has been destroyed.
+ */
+export declare class DestroyedDependencyError extends DependencyLifecycleError {
+}
+/**
+ * Thrown for actions that cannot be performed because a dependency is not supported.
+ */
+export declare class UnsupportedDependencyError extends DependencyLifecycleError {
+}
+/**
+ * Thrown if multiple dependencies crash.
+ */
+export declare class CrashedDependenciesError extends MatterAggregateError {
+}
+//# sourceMappingURL=Lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Lifecycle.d.ts","sourceRoot":"","sources":["../../../src/util/Lifecycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,yBAAiB,SAAS,CAAC;IACvB;;OAEG;IACH,KAAY,MAAM;QACd,OAAO,YAAY;QACnB,QAAQ,aAAa;QACrB,YAAY,iBAAiB;QAC7B,MAAM,WAAW;QACjB,OAAO,YAAY;QACnB,UAAU,eAAe;QACzB,SAAS,cAAc;KAC1B;IAED;;OAEG;IACH,KAAY,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,IAAI,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAEzD;;OAEG;IACH,SAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,QA0BhE;CACJ;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,mBAAmB;gBACjD,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAGxC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB;;;;OAIG;IACH,MAAM,IAAI,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC;IAE9B,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,qBAAa,gCAAiC,SAAQ,wBAAwB;CAAG;AAEjF;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,wBAAwB;CAAG;AAE7E;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,wBAAwB;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,wBAAwB;CAAG;AAEzE;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,wBAAwB;CAAG;AAE3E;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,oBAAoB;CAAG"}

package/dist/esm/util/Lifecycle.js

@@ -0,0 +1,69 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ImplementationError, MatterAggregateError } from "../MatterError.js";
+var Lifecycle;
+((Lifecycle2) => {
+  let Status;
+  ((Status2) => {
+    Status2["Unknown"] = "unknown";
+    Status2["Inactive"] = "inactive";
+    Status2["Initializing"] = "initializing";
+    Status2["Active"] = "active";
+    Status2["Crashed"] = "crashed";
+    Status2["Destroying"] = "destroying";
+    Status2["Destroyed"] = "destroyed";
+  })(Status = Lifecycle2.Status || (Lifecycle2.Status = {}));
+  function assertActive(status, description) {
+    if (!description) {
+      description = "dependency";
+    }
+    switch (status) {
+      case "active" /* Active */:
+        return;
+      case "inactive" /* Inactive */:
+        throw new UninitializedDependencyError(description, "is not initialized");
+      case "initializing" /* Initializing */:
+        throw new UninitializedDependencyError(description, "is still initializing");
+      case "crashed" /* Crashed */:
+        throw new CrashedDependencyError(description, "initialization failed");
+      case "destroying" /* Destroying */:
+        throw new DestroyedDependencyError(description, "is closing");
+      case "destroyed" /* Destroyed */:
+        throw new DestroyedDependencyError(description, "is closed");
+    }
+    throw new DependencyLifecycleError(description, `status "${status}" is unknown`);
+  }
+  Lifecycle2.assertActive = assertActive;
+})(Lifecycle || (Lifecycle = {}));
+class DependencyLifecycleError extends ImplementationError {
+  constructor(what, why) {
+    super(`${what} ${why}`);
+  }
+}
+class UnsupportedDependencyStatusError extends DependencyLifecycleError {
+}
+class UninitializedDependencyError extends DependencyLifecycleError {
+}
+class CrashedDependencyError extends DependencyLifecycleError {
+  subject;
+}
+class DestroyedDependencyError extends DependencyLifecycleError {
+}
+class UnsupportedDependencyError extends DependencyLifecycleError {
+}
+class CrashedDependenciesError extends MatterAggregateError {
+}
+export {
+  CrashedDependenciesError,
+  CrashedDependencyError,
+  DependencyLifecycleError,
+  DestroyedDependencyError,
+  Lifecycle,
+  UninitializedDependencyError,
+  UnsupportedDependencyError,
+  UnsupportedDependencyStatusError
+};
+//# sourceMappingURL=Lifecycle.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/Lifecycle.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,qBAAqB,4BAA4B;AAGnD,IAAU;AAAA,CAAV,CAAUA,eAAV;AAII,MAAK;AAAL,IAAKC,YAAL;AACH,IAAAA,QAAA,aAAU;AACV,IAAAA,QAAA,cAAW;AACX,IAAAA,QAAA,kBAAe;AACf,IAAAA,QAAA,YAAS;AACT,IAAAA,QAAA,aAAU;AACV,IAAAA,QAAA,gBAAa;AACb,IAAAA,QAAA,eAAY;AAAA,KAPJ,SAAAD,WAAA,WAAAA,WAAA;AAkBL,WAAS,aAAa,QAAgB,aAAsB;AAC/D,QAAI,CAAC,aAAa;AACd,oBAAc;AAAA,IAClB;AAEA,YAAQ,QAAQ;AAAA,MACZ,KAAK;AACD;AAAA,MAEJ,KAAK;AACD,cAAM,IAAI,6BAA6B,aAAa,oBAAoB;AAAA,MAE5E,KAAK;AACD,cAAM,IAAI,6BAA6B,aAAa,uBAAuB;AAAA,MAE/E,KAAK;AACD,cAAM,IAAI,uBAAuB,aAAa,uBAAuB;AAAA,MAEzE,KAAK;AACD,cAAM,IAAI,yBAAyB,aAAa,YAAY;AAAA,MAEhE,KAAK;AACD,cAAM,IAAI,yBAAyB,aAAa,WAAW;AAAA,IACnE;AAEA,UAAM,IAAI,yBAAyB,aAAa,WAAW,MAAM,cAAc;AAAA,EACnF;AA1BO,EAAAA,WAAS;AAAA,GAtBH;AAsDV,MAAM,iCAAiC,oBAAoB;AAAA,EAC9D,YAAY,MAAc,KAAa;AACnC,UAAM,GAAG,IAAI,IAAI,GAAG,EAAE;AAAA,EAC1B;AACJ;AAwCO,MAAM,yCAAyC,yBAAyB;AAAC;AAKzE,MAAM,qCAAqC,yBAAyB;AAAC;AAKrE,MAAM,+BAA+B,yBAAyB;AAAA,EACjE;AACJ;AAKO,MAAM,iCAAiC,yBAAyB;AAAC;AAKjE,MAAM,mCAAmC,yBAAyB;AAAC;AAKnE,MAAM,iCAAiC,qBAAqB;AAAC;",
+  "names": ["Lifecycle", "Status"]
+}

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

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * A "multiplex" tracks an extensible set of promises.
+ */
+export interface Multiplex {
+    add(worker: Promise<unknown>): void;
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=Multiplex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Multiplex.d.ts","sourceRoot":"","sources":["../../../src/util/Multiplex.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C"}

package/dist/esm/util/Multiplex.js

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=Multiplex.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/Multiplex.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

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

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * A mutex is a task queue where at most one task is active at a time.
+ */
+export declare class Mutex implements PromiseLike<unknown> {
+    #private;
+    constructor(owner: {}, initial?: PromiseLike<unknown>);
+    /**
+     * As a PromiseLike, you can await the Mutex.  This promise resolves when current activity completes but the mutex
+     * may engage in another activity immediately thereafter.  So the mutex is not guaranteed to be available after an
+     * await.
+     */
+    then<TResult1 = void, TResult2 = never>(onfulfilled?: ((value: unknown) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
+    /**
+     * Enqueue additional work.
+     *
+     * If {@link task} is a function it runs when current activity completes.  If it is a promise then the mutex will
+     * not clear until {@link task} resolves.
+     */
+    run(task: PromiseLike<unknown> | (() => PromiseLike<unknown>), cancel?: () => void): void;
+    /**
+     * Cancel remaining work and perform one last task with the Mutex held.
+     */
+    terminate(cleanup?: () => PromiseLike<void>): void;
+    /**
+     * Execute a task immediately if it is a function.
+     */
+    protected initiateTask(task: PromiseLike<unknown> | (() => PromiseLike<unknown>)): Promise<unknown>;
+}
+//# sourceMappingURL=Mutex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Mutex.d.ts","sourceRoot":"","sources":["../../../src/util/Mutex.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,qBAAa,KAAM,YAAW,WAAW,CAAC,OAAO,CAAC;;gBAMlC,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC;IAOrD;;;;OAIG;IACH,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,GAAG,KAAK,EAClC,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,EACvF,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,GACpF,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAInC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,IAAI;IAuBlF;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,WAAW,CAAC,IAAI,CAAC;IAoB3C;;OAEG;cACa,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;CAMzF"}

package/dist/esm/util/Mutex.js

@@ -0,0 +1,85 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Logger } from "../log/Logger.js";
+const logger = Logger.get("Mutex");
+class Mutex {
+  #owner;
+  #cancel;
+  #canceled = false;
+  #promise;
+  constructor(owner, initial) {
+    this.#owner = owner;
+    if (initial) {
+      this.run(() => initial);
+    }
+  }
+  /**
+   * As a PromiseLike, you can await the Mutex.  This promise resolves when current activity completes but the mutex
+   * may engage in another activity immediately thereafter.  So the mutex is not guaranteed to be available after an
+   * await.
+   */
+  then(onfulfilled, onrejected) {
+    return (this.#promise || Promise.resolve()).then(onfulfilled, onrejected);
+  }
+  /**
+   * Enqueue additional work.
+   *
+   * If {@link task} is a function it runs when current activity completes.  If it is a promise then the mutex will
+   * not clear until {@link task} resolves.
+   */
+  run(task, cancel) {
+    if (this.#canceled) {
+      cancel?.();
+      return;
+    }
+    if (!this.#promise) {
+      this.#promise = this.initiateTask(task);
+    } else {
+      this.#promise = this.#promise.then(() => {
+        if (this.#canceled) {
+          cancel?.();
+          return;
+        }
+        this.#cancel = cancel;
+        return this.initiateTask(task).finally(() => {
+          this.#cancel = void 0;
+        });
+      });
+    }
+  }
+  /**
+   * Cancel remaining work and perform one last task with the Mutex held.
+   */
+  terminate(cleanup) {
+    if (this.#canceled) {
+      return;
+    }
+    this.#canceled = true;
+    if (this.#cancel) {
+      this.#cancel();
+    }
+    if (cleanup) {
+      if (!this.#promise) {
+        this.#promise = this.initiateTask(cleanup);
+      } else {
+        this.#promise = this.#promise.then(() => this.initiateTask(cleanup));
+      }
+    }
+  }
+  /**
+   * Execute a task immediately if it is a function.
+   */
+  async initiateTask(task) {
+    if (typeof task === "function") {
+      task = task();
+    }
+    return Promise.resolve(task).catch((cause) => logger.error(`Error initializing ${this.#owner} worker:`, cause));
+  }
+}
+export {
+  Mutex
+};
+//# sourceMappingURL=Mutex.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/Mutex.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,cAAc;AAEvB,MAAM,SAAS,OAAO,IAAI,OAAO;AAK1B,MAAM,MAAsC;AAAA,EAC/C;AAAA,EACA;AAAA,EACA,YAAY;AAAA,EACZ;AAAA,EAEA,YAAY,OAAW,SAAgC;AACnD,SAAK,SAAS;AACd,QAAI,SAAS;AACT,WAAK,IAAI,MAAM,OAAO;AAAA,IAC1B;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,KACI,aACA,YACgC;AAChC,YAAQ,KAAK,YAAY,QAAQ,QAAQ,GAAG,KAAK,aAAa,UAAU;AAAA,EAC5E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,MAA2D,QAAqB;AAChF,QAAI,KAAK,WAAW;AAChB,eAAS;AACT;AAAA,IACJ;AAEA,QAAI,CAAC,KAAK,UAAU;AAChB,WAAK,WAAW,KAAK,aAAa,IAAI;AAAA,IAC1C,OAAO;AACH,WAAK,WAAW,KAAK,SAAS,KAAK,MAAM;AACrC,YAAI,KAAK,WAAW;AAChB,mBAAS;AACT;AAAA,QACJ;AAEA,aAAK,UAAU;AACf,eAAO,KAAK,aAAa,IAAI,EAAE,QAAQ,MAAM;AACzC,eAAK,UAAU;AAAA,QACnB,CAAC;AAAA,MACL,CAAC;AAAA,IACL;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU,SAAmC;AACzC,QAAI,KAAK,WAAW;AAChB;AAAA,IACJ;AAEA,SAAK,YAAY;AAEjB,QAAI,KAAK,SAAS;AACd,WAAK,QAAQ;AAAA,IACjB;AAEA,QAAI,SAAS;AACT,UAAI,CAAC,KAAK,UAAU;AAChB,aAAK,WAAW,KAAK,aAAa,OAAO;AAAA,MAC7C,OAAO;AACH,aAAK,WAAW,KAAK,SAAS,KAAK,MAAM,KAAK,aAAa,OAAO,CAAC;AAAA,MACvE;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,MAAgB,aAAa,MAA2D;AACpF,QAAI,OAAO,SAAS,YAAY;AAC5B,aAAO,KAAK;AAAA,IAChB;AACA,WAAO,QAAQ,QAAQ,IAAI,EAAE,MAAM,WAAS,OAAO,MAAM,sBAAsB,KAAK,MAAM,YAAY,KAAK,CAAC;AAAA,EAChH;AACJ;",
+  "names": []
+}

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

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export type HandlerFunction = (...args: any[]) => any;
+export declare class NamedHandler<H extends Record<keyof H, HandlerFunction>> {
+    private handler;
+    hasHandler<K extends keyof H>(action: K): boolean;
+    addHandler<K extends keyof H>(action: K, handler: H[K]): void;
+    executeHandler<K extends keyof H>(action: K, ...args: Parameters<H[K]>): Promise<any>;
+    removeHandler<K extends keyof H>(action: K, handler: H[K]): void;
+}
+type ExtendPublicHandlerMethods<ParentClass extends new (...args: any[]) => any, H extends Record<keyof H, HandlerFunction>> = ParentClass extends new (...args: infer TArgs) => infer T ? new (...args: TArgs) => T & {
+    addCommandHandler<K extends keyof H>(action: K, handler: H[K]): void;
+    removeCommandHandler<K extends keyof H>(action: K, handler: H[K]): void;
+    _executeHandler<K extends keyof H>(action: K, ...args: Parameters<H[K]>): Promise<void>;
+} : never;
+export declare function extendPublicHandlerMethods<ParentClass extends new (...args: any[]) => any, H extends Record<keyof H, HandlerFunction>>(parentClass: ParentClass): ExtendPublicHandlerMethods<ParentClass, H>;
+export {};
+//# sourceMappingURL=NamedHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NamedHandler.d.ts","sourceRoot":"","sources":["../../../src/util/NamedHandler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAEtD,qBAAa,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAChE,OAAO,CAAC,OAAO,CAAkD;IAEjE,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAIvC,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAIhD,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAQ5E,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;CAK5D;AAED,KAAK,0BAA0B,CAC3B,WAAW,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC/C,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC,IAC1C,WAAW,SAAS,KAAK,GAAG,IAAI,EAAE,MAAM,KAAK,KAAK,MAAM,CAAC,GACvD,KAAK,GAAG,IAAI,EAAE,KAAK,KAAK,CAAC,GAAG;IACxB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACrE,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACxE,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3F,GACD,KAAK,CAAC;AAEZ,wBAAgB,0BAA0B,CACtC,WAAW,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC/C,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC,EAC5C,WAAW,EAAE,WAAW,GAAG,0BAA0B,CAAC,WAAW,EAAE,CAAC,CAAC,CAGtE"}

package/dist/esm/util/NamedHandler.js

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class NamedHandler {
+  handler = [];
+  hasHandler(action) {
+    return this.handler.some(({ action: a }) => a === action);
+  }
+  addHandler(action, handler) {
+    this.handler.push({ action, handler });
+  }
+  async executeHandler(action, ...args) {
+    for (const { action: a, handler } of this.handler) {
+      if (a === action) {
+        return await handler(...args);
+      }
+    }
+  }
+  removeHandler(action, handler) {
+    this.handler = this.handler.filter(({ action: a, handler: h }) => {
+      return a !== action && h !== handler;
+    });
+  }
+}
+function extendPublicHandlerMethods(parentClass) {
+  return parentClass;
+}
+export {
+  NamedHandler,
+  extendPublicHandlerMethods
+};
+//# sourceMappingURL=NamedHandler.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/NamedHandler.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAQO,MAAM,aAAyD;AAAA,EAC1D,UAAsD,CAAC;AAAA,EAE/D,WAA8B,QAAW;AACrC,WAAO,KAAK,QAAQ,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,MAAM,MAAM;AAAA,EAC5D;AAAA,EAEA,WAA8B,QAAW,SAAe;AACpD,SAAK,QAAQ,KAAK,EAAE,QAAQ,QAAQ,CAAC;AAAA,EACzC;AAAA,EAEA,MAAM,eAAkC,WAAc,MAAwB;AAC1E,eAAW,EAAE,QAAQ,GAAG,QAAQ,KAAK,KAAK,SAAS;AAC/C,UAAI,MAAM,QAAQ;AACd,eAAO,MAAM,QAAQ,GAAG,IAAI;AAAA,MAChC;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,cAAiC,QAAW,SAAe;AACvD,SAAK,UAAU,KAAK,QAAQ,OAAO,CAAC,EAAE,QAAQ,GAAG,SAAS,EAAE,MAAM;AAC9D,aAAO,MAAM,UAAU,MAAM;AAAA,IACjC,CAAC;AAAA,EACL;AACJ;AAaO,SAAS,2BAGd,aAAsE;AAEpE,SAAO;AACX;",
+  "names": []
+}

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

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const UINT8_MAX = 255;
+export declare const UINT16_MAX = 65535;
+export declare const UINT24_MAX = 16777215;
+export declare const UINT32_MAX = 4294967295;
+export declare const UINT64_MAX: bigint;
+export declare const INT8_MIN = -128;
+export declare const INT16_MIN = -32768;
+export declare const INT32_MIN = -2147483648;
+export declare const INT64_MIN: bigint;
+export declare const INT8_MAX = 127;
+export declare const INT16_MAX = 32767;
+export declare const INT32_MAX = 2147483647;
+export declare const INT64_MAX: bigint;
+export declare const FLOAT32_MIN = -3.4028234663852886e+38;
+export declare const FLOAT32_MAX = 3.4028234663852886e+38;
+export declare function toNumber(value: bigint | number): number;
+export declare function toBigInt(value: bigint | number): bigint;
+export declare function minValue<T extends bigint | number>(a: T | undefined, b: T | undefined): T | undefined;
+export declare function maxValue<T extends bigint | number>(a: T | undefined, b: T | undefined): T | undefined;
+/**
+ * Convert a number or bigint to a hex string of a valid "even" hex length
+ */
+export declare function toHex(value: number | bigint): string;
+/**
+ * Makes sure a value is within min and max. It sets the value to min or max in case it is below or above the range.
+ */
+export declare function cropValueRange(value: number, min: number, max: number): number;
+/**
+ * Adds a value to another value and wraps around on the min and max values.
+ */
+export declare function addValueWithOverflow(value: number, add: number, min: number, max: number): number;
+//# sourceMappingURL=Number.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Number.d.ts","sourceRoot":"","sources":["../../../src/util/Number.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,SAAS,MAAO,CAAC;AAC9B,eAAO,MAAM,UAAU,QAAS,CAAC;AACjC,eAAO,MAAM,UAAU,WAAW,CAAC;AACnC,eAAO,MAAM,UAAU,aAAa,CAAC;AACrC,eAAO,MAAM,UAAU,QAAiC,CAAC;AAEzD,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,SAAS,SAAS,CAAC;AAChC,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,SAAS,QAAiC,CAAC;AACxD,eAAO,MAAM,QAAQ,MAAM,CAAC;AAC5B,eAAO,MAAM,SAAS,QAAQ,CAAC;AAC/B,eAAO,MAAM,SAAS,aAAa,CAAC;AACpC,eAAO,MAAM,SAAS,QAAgC,CAAC;AAEvD,eAAO,MAAM,WAAW,0BAA6C,CAAC;AACtE,eAAO,MAAM,WAAW,yBAA4C,CAAC;AAErE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,CAAC,GAAG,SAAS,iBAIrF;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,CAAC,GAAG,SAAS,iBAIrF;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,UAG3C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQjG"}

package/dist/esm/util/Number.js

@@ -0,0 +1,77 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const UINT8_MAX = 255;
+const UINT16_MAX = 65535;
+const UINT24_MAX = 16777215;
+const UINT32_MAX = 4294967295;
+const UINT64_MAX = BigInt("18446744073709551615");
+const INT8_MIN = -128;
+const INT16_MIN = -32768;
+const INT32_MIN = -2147483648;
+const INT64_MIN = BigInt("-9223372036854775808");
+const INT8_MAX = 127;
+const INT16_MAX = 32767;
+const INT32_MAX = 2147483647;
+const INT64_MAX = BigInt("9223372036854775807");
+const FLOAT32_MIN = -34028234663852886e22;
+const FLOAT32_MAX = 34028234663852886e22;
+function toNumber(value) {
+  return typeof value === "bigint" ? Number(value) : value;
+}
+function toBigInt(value) {
+  return typeof value === "number" ? BigInt(value) : value;
+}
+function minValue(a, b) {
+  if (a === void 0) return b;
+  if (b === void 0) return a;
+  return a < b ? a : b;
+}
+function maxValue(a, b) {
+  if (a === void 0) return b;
+  if (b === void 0) return a;
+  return a > b ? a : b;
+}
+function toHex(value) {
+  const hex = value.toString(16);
+  return hex.length % 2 === 0 ? hex : `0${hex}`;
+}
+function cropValueRange(value, min, max) {
+  return Math.min(Math.max(value, min), max);
+}
+function addValueWithOverflow(value, add, min, max) {
+  const newValue = value + add;
+  if (newValue < min) {
+    return newValue + max + 1;
+  } else if (newValue > max) {
+    return newValue - max - 1;
+  }
+  return newValue;
+}
+export {
+  FLOAT32_MAX,
+  FLOAT32_MIN,
+  INT16_MAX,
+  INT16_MIN,
+  INT32_MAX,
+  INT32_MIN,
+  INT64_MAX,
+  INT64_MIN,
+  INT8_MAX,
+  INT8_MIN,
+  UINT16_MAX,
+  UINT24_MAX,
+  UINT32_MAX,
+  UINT64_MAX,
+  UINT8_MAX,
+  addValueWithOverflow,
+  cropValueRange,
+  maxValue,
+  minValue,
+  toBigInt,
+  toHex,
+  toNumber
+};
+//# sourceMappingURL=Number.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/util/Number.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMO,MAAM,YAAY;AAClB,MAAM,aAAa;AACnB,MAAM,aAAa;AACnB,MAAM,aAAa;AACnB,MAAM,aAAa,OAAO,sBAAsB;AAEhD,MAAM,WAAW;AACjB,MAAM,YAAY;AAClB,MAAM,YAAY;AAClB,MAAM,YAAY,OAAO,sBAAsB;AAC/C,MAAM,WAAW;AACjB,MAAM,YAAY;AAClB,MAAM,YAAY;AAClB,MAAM,YAAY,OAAO,qBAAqB;AAE9C,MAAM,cAAc;AACpB,MAAM,cAAc;AAEpB,SAAS,SAAS,OAAgC;AACrD,SAAO,OAAO,UAAU,WAAW,OAAO,KAAK,IAAI;AACvD;AAEO,SAAS,SAAS,OAAgC;AACrD,SAAO,OAAO,UAAU,WAAW,OAAO,KAAK,IAAI;AACvD;AAEO,SAAS,SAAoC,GAAkB,GAAkB;AACpF,MAAI,MAAM,OAAW,QAAO;AAC5B,MAAI,MAAM,OAAW,QAAO;AAC5B,SAAO,IAAI,IAAI,IAAI;AACvB;AAEO,SAAS,SAAoC,GAAkB,GAAkB;AACpF,MAAI,MAAM,OAAW,QAAO;AAC5B,MAAI,MAAM,OAAW,QAAO;AAC5B,SAAO,IAAI,IAAI,IAAI;AACvB;AAKO,SAAS,MAAM,OAAwB;AAC1C,QAAM,MAAM,MAAM,SAAS,EAAE;AAC7B,SAAO,IAAI,SAAS,MAAM,IAAI,MAAM,IAAI,GAAG;AAC/C;AAKO,SAAS,eAAe,OAAe,KAAa,KAAqB;AAC5E,SAAO,KAAK,IAAI,KAAK,IAAI,OAAO,GAAG,GAAG,GAAG;AAC7C;AAKO,SAAS,qBAAqB,OAAe,KAAa,KAAa,KAAqB;AAC/F,QAAM,WAAW,QAAQ;AACzB,MAAI,WAAW,KAAK;AAChB,WAAO,WAAW,MAAM;AAAA,EAC5B,WAAW,WAAW,KAAK;AACvB,WAAO,WAAW,MAAM;AAAA,EAC5B;AACA,SAAO;AACX;",
+  "names": []
+}