@matter/general 0.13.0-alpha.0-20250318-c1aa38b08 → 0.13.0-alpha.0-20250323-770919c6a

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

@@ -55,11 +55,36 @@ export interface Observable<T extends any[] = any[], R = void> extends AsyncIter
      */
     isObservedBy(observer: Observer<T, R>): boolean;
     /**
-     * This flag indicates whether the observable is asynchronous.  Any observable that accepts promise returns may
-     * be asynchronous but this information is not available at runtime unless you specify here, typically via
-     * {@link AsyncObservable}.
+     * Errors throw by observers will interrupt emitters unless an error handler is installed here and the handler does
+     * not rethrow.
+     *
+     * The only exception to this is if {@link handlePromise} is false and an observer is asynchronous.  In this case
+     * the emitter cannot be made aware of the exception.
+     */
+    handleError: ObserverErrorHandler;
+    /**
+     * We allow emitters to be async, but we do not want to overburden either the emitter or the observer with promise
+     * tracking if the lifetime of the observer is not relevant to the emitter.
+     *
+     * To facilitate this we allow observables to be configured in one of three promise handling modes:
+     *
+     * * If you set handlePromise, isAsync is true; the handler is invoked for any observer promise
+     *
+     * * If isAsync is true but you do not set handlePromise, any observer promise is returned to the emitter which must
+     *   handle the promise
+     *
+     * * If isAsync is false, we log observer promise errors but the promise is otherwise untracked
+     *
+     * If the promiseHandler returns a promise or is true and the emitter returns a promise, the observable will emit to
+     * successive observers only after the promise resolves.
+     */
+    isAsync: boolean;
+    /**
+     * A promise handler.
+     *
+     * If you set {@link isAsync} (either true or false) the promise handler is set by the Observable.
      */
-    isAsync?: boolean;
+    handlePromise: ObserverPromiseHandler | boolean;
     /**
      * Observable supports standard "for await (const value of observable").
      *
@@ -81,18 +106,22 @@ export declare const observant: unique symbol;
  * An {@link Observable} that explicitly supports asynchronous observers.
  */
 export interface AsyncObservable<T extends any[] = any[], R = void> extends Observable<T, MaybePromise<R>> {
-    isAsync: true;
 }
 export type ObserverErrorHandler = (error: Error, observer: Observer<any[], any>) => void;
+export type ObserverPromiseHandler = (promise: Promise<unknown>, observer: Observer<any[], any>) => unknown;
 /**
  * A concrete {@link Observable} implementation.
  */
 export declare class BasicObservable<T extends any[] = any[], R = void> implements Observable<T, R> {
     #private;
-    constructor(errorHandler?: ObserverErrorHandler, isAsync?: boolean);
+    constructor(handleError?: ObserverErrorHandler, asyncConfig?: ObserverPromiseHandler | boolean);
     [Symbol.dispose](): void;
-    get isAsync(): boolean | undefined;
-    set isAsync(isAsync: boolean | undefined);
+    set handleError(handleError: ObserverErrorHandler);
+    get handleError(): ObserverErrorHandler;
+    set isAsync(isAsync: boolean);
+    get isAsync(): boolean;
+    set handlePromise(handlePromise: ObserverPromiseHandler);
+    get handlePromise(): ObserverPromiseHandler;
     get isObserved(): boolean;
     isObservedBy(observer: Observer<T, R>): boolean;
     emit(...payload: T): R | undefined;
@@ -113,8 +142,8 @@ export declare const Observable: {
  * Create an {@link AsyncObservable} that explicitly supports asynchronous results
  */
 export declare const AsyncObservable: {
-    new <T extends any[], R = void>(errorHandler?: ObserverErrorHandler): AsyncObservable<T, R>;
-    <T extends any[], R = void>(errorHandler?: ObserverErrorHandler): AsyncObservable<T, R>;
+    new <T extends any[], R = void>(handleError?: ObserverErrorHandler): AsyncObservable<T, R>;
+    <T extends any[], R = void>(handleError?: ObserverErrorHandler): AsyncObservable<T, R>;
 };
 /**
  * A set of observables.  You can bind events using individual observables or the methods emulating a subset Node's
@@ -123,9 +152,13 @@ export declare const AsyncObservable: {
  * To maintain type safety, implementers define events as observable child properties.
  */
 export declare class EventEmitter {
+    private events?;
     emit<This, N extends EventEmitter.NamesOf<This>>(this: This, name: N, ...payload: EventEmitter.PayloadOf<This, N>): void;
     addListener<This, N extends EventEmitter.NamesOf<This>>(this: This, name: N, handler: EventEmitter.ObserverOf<This, N>): void;
     removeListener<This, N extends EventEmitter.NamesOf<This>>(this: This, name: N, handler: EventEmitter.ObserverOf<This, N>): void;
+    addEvent(name: string, event?: Observable): void;
+    getEvent(name: string): Observable<any[], void>;
+    hasEvent(name: string, onlyIfInitialized?: boolean): boolean | Observable<any[], void> | undefined;
     get eventNames(): string[];
     [Symbol.dispose](): void;
 }
@@ -151,7 +184,7 @@ export declare namespace EventEmitter {
 /**
  * An {@link Observable} that proxies to another {@link Observable}.
  *
- * Emits emitted here instead emit on the target {@link Observable}.  Events emitted on the target emit locally via
+ * Events emitted here instead emit on the target {@link Observable}.  Events emitted on the target emit locally via
  * a listener installed by the proxy.
  *
  * This is useful for managing a subset of {@link Observer}s for an {@link Observable}.
@@ -162,9 +195,9 @@ export declare class ObservableProxy extends BasicObservable {
     #private;
     constructor(target: Observable);
     [Symbol.dispose](): void;
-    get isAsync(): boolean | undefined;
     get isObserved(): boolean;
     emit: (...payload: any) => any | undefined;
+    protected get target(): Observable<any[], void>;
 }
 /**
  * A collection of observers managed as a unit.  This makes it convenient to deregister multiple observers when an
@@ -201,4 +234,96 @@ export declare namespace ObserverGroup {
      */
     type VarArgs<T extends any[]> = T extends [...infer R, infer A] ? [...R, A] : T extends [infer A] ? A : [];
 }
+/**
+ * An {@link Observable} that emits an algorithmically-reduced number of events.
+ */
+export declare class QuietObservable<T extends any[] = any[]> extends BasicObservable<T> implements QuietObservable.State<T> {
+    #private;
+    constructor(config?: QuietObservable.Configuration<T>);
+    get config(): QuietObservable.Configuration<T>;
+    set config(config: QuietObservable.Configuration<T>);
+    get emitAutomatically(): boolean;
+    set emitAutomatically(value: boolean);
+    get suppressionEnabled(): boolean;
+    set suppressionEnabled(value: boolean);
+    get minimumEmitIntervalMs(): number;
+    set minimumEmitIntervalMs(value: number);
+    get source(): Observable<T> | undefined;
+    set source(source: Observable<T> | undefined);
+    get sink(): Observable<T> | undefined;
+    set sink(sink: Observable<T> | undefined);
+    get shouldEmit(): QuietObservable.EmitPredicate<T> | undefined;
+    set shouldEmit(shouldEmit: QuietObservable.EmitPredicate<T> | undefined);
+    get isObserved(): boolean;
+    isObservedBy(observer: Observer<T>): boolean;
+    emit(...payload: T): void;
+    /**
+     * Emit immediately, regardless of suppression configuration.
+     */
+    emitNow(): void;
+    /**
+     * Emit as soon as allowed by suppression.
+     */
+    emitSoon(): void;
+    [Symbol.dispose](): void;
+}
+export declare namespace QuietObservable {
+    interface State<T extends any[] = any[]> {
+        /**
+         * If true this observable will emit within the suppression constraints.  If false it will only emit after calls
+         * to {@link emitSoon} or {@link emitNow}.
+         */
+        emitAutomatically: boolean;
+        /**
+         * If true then emit rate is constrained.  If false emits will occur immediately.
+         */
+        suppressionEnabled: boolean;
+        /**
+         * The minimum time between emits in milliseconds.
+         */
+        minimumEmitIntervalMs: number;
+        /**
+         * An input observable this observable will automatically observe to produce events.
+         */
+        source?: Observable<T>;
+        /**
+         * An output observable this observable will automatically emit to whenever it emits.
+         */
+        sink?: Observable<T>;
+        /**
+         * A predicate that determine whether a payload should emit.
+         */
+        shouldEmit?: EmitPredicate<T>;
+        /**
+         * Handler for errors returned by observers.
+         */
+        handleError?: ObserverErrorHandler;
+        /**
+         * Designates async support (overridden if you supply {@link handlePromise}).
+         */
+        isAsync?: boolean;
+        /**
+         * Handler for promises returned by observers.
+         */
+        handlePromise?: ObserverPromiseHandler;
+    }
+    /**
+     * An emit predicate may emit this value to force immediate emit.
+     */
+    const now = "now";
+    /**
+     * The return value of an emit predicate.  "true" allows the event to emit as normal, "false" prevents the event
+     * from emitting, and {@link now} forces immediate emit regardless of interval configuration.
+     */
+    type EmitDirective = true | false | typeof now;
+    /**
+     * A predicate that may filter emits manually.
+     */
+    interface EmitPredicate<T extends any[] = any[]> {
+        (...payload: T): EmitDirective;
+    }
+    interface Configuration<T extends any[] = any[]> extends Partial<State<T>> {
+    }
+    const defaults: State;
+}
 //# sourceMappingURL=Observable.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Observable.d.ts","sourceRoot":"","sources":["../../../src/util/Observable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,4BAA4B,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAI7C;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI;IACvD,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC7C,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;IACnG;;OAEG;IACH,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAEhC;;OAEG;IACH,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IAEnC;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IAErC;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC;IAEhD;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9C;;OAEG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC5B;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,eAA8B,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAE,SAAQ,UAAU,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACtG,OAAO,EAAE,IAAI,CAAC;CACjB;AAMD,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;AAE1F;;GAEG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAE,YAAW,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC;;gBAU3E,YAAY,CAAC,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,OAAO;IAKlE,CAAC,MAAM,CAAC,OAAO,CAAC;IAMhB,IAAI,OAAO,IAIU,OAAO,GAAG,SAAS,CAFvC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAEvC;IAED,IAAI,UAAU,YAkBb;IAED,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAIrC,IAAI,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAgElC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAO3B,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAI5B,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAQ7B,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,KAAK,EAC/B,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,EACrE,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GACxE,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAQ5B,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAwDvD;AAQD;;GAEG;AACH,eAAO,MAAM,UAAU,EAAqC;IACxD,KAAK,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC,EAAE,oBAAoB,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvF,CAAC,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC,EAAE,oBAAoB,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACtF,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,eAAe,EAA0C;IAClE,KAAK,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC,EAAE,oBAAoB,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5F,CAAC,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC,EAAE,oBAAoB,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAC3F,CAAC;AAUF;;;;;GAKG;AACH,qBAAa,YAAY;IACrB,IAAI,CAAC,IAAI,EAAE,CAAC,SAAS,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAIjH,WAAW,CAAC,IAAI,EAAE,CAAC,SAAS,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,EAClD,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAK7C,cAAc,CAAC,IAAI,EAAE,CAAC,SAAS,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,EACrD,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAK7C,IAAI,UAAU,aAEb;IAED,CAAC,MAAM,CAAC,OAAO,CAAC;CAKnB;AAED,yBAAiB,YAAY,CAAC;IAC1B;;;OAGG;IACH,KAAY,OAAO,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAE3F,KAAY,UAAU,CAAC,IAAI,IAAI,MAAM,GACjC,MAAM;SACD,CAAC,IAAI,MAAM,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,UAAU,GAAG,CAAC,GAAG,KAAK,GAAG,IAAI;KACpE,CAAC;IAEN;;;OAGG;IACH,KAAY,SAAS,CAAC,IAAI,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GACjF,GAAG,EAAE,GACL,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAE5B,KAAY,YAAY,CAAC,IAAI,EAAE,CAAC,SAAS,MAAM,IAAI,IAAI,SAAS;SAAG,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,GAAG,EAAE,CAAC;KAAE,GACzG,CAAC,GACD,KAAK,CAAC;IAEZ,KAAY,UAAU,CAAC,IAAI,EAAE,CAAC,SAAS,MAAM,IAAI,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;CACnF;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAgB,SAAQ,eAAe;;gBAIpC,MAAM,EAAE,UAAU;IAcrB,CAAC,MAAM,CAAC,OAAO,CAAC;IAKzB,IAAa,OAAO,wBAEnB;IAED,IAAa,UAAU,IAAI,OAAO,CAEjC;IAEQ,IAAI,EAAE,CAAC,GAAG,OAAO,EAAE,GAAG,KAAK,GAAG,GAAG,SAAS,CAAC;CACvD;AAED;;;GAGG;AACH,qBAAa,aAAa;;gBAKV,MAAM,CAAC,EAAE,EAAE;IAIvB;;;;;;OAMG;IACH,EAAE,CAAC,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC,EACjB,UAAU,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EACpD,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EACjE,MAAM,iBAAsB;IAchC;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,SAAS,GAAG,EAAE,EACf,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,EAC9C,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAC9B,MAAM,iBAAsB;IA0BhC;;OAEG;IACH,KAAK;CASR;AAED,yBAAiB,aAAa,CAAC;IAC3B;;;OAGG;IACH,KAAY,OAAO,CAAC,CAAC,SAAS,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;CACrH"}
+{"version":3,"file":"Observable.d.ts","sourceRoot":"","sources":["../../../src/util/Observable.ts"],"names":[],"mappings":"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"}

package/dist/esm/util/Observable.js

@@ -3,6 +3,7 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
+import { Time } from "#time/Time.js";
 import { ImplementationError } from "../MatterError.js";
 import { Logger } from "../log/Logger.js";
 import "../polyfills/disposable.js";
@@ -14,26 +15,63 @@ function defaultErrorHandler(error) {
   throw error;
 }
 class BasicObservable {
-  #errorHandler;
+  #handleError;
+  #isAsync;
+  #handlePromise;
   #observers;
   #once;
-  #isAsync;
   #joinIteration;
   #removeIterator;
   #stopIteration;
-  constructor(errorHandler, isAsync) {
-    this.#errorHandler = errorHandler ?? defaultErrorHandler;
-    this.#isAsync = isAsync;
+  constructor(handleError, asyncConfig) {
+    this.handleError = handleError ?? defaultErrorHandler;
+    if (typeof asyncConfig === "function") {
+      this.handlePromise = asyncConfig;
+    } else {
+      this.isAsync = asyncConfig ?? false;
+    }
   }
   [Symbol.dispose]() {
     this.#observers = this.#once = void 0;
     this.#stopIteration?.();
   }
-  get isAsync() {
-    return this.#isAsync;
+  set handleError(handleError) {
+    this.#handleError = handleError;
+  }
+  get handleError() {
+    return this.#handleError;
   }
   set isAsync(isAsync) {
     this.#isAsync = isAsync;
+    if (isAsync) {
+      this.#handlePromise = (promise) => promise;
+    } else {
+      this.#handlePromise = (promise, observer) => {
+        promise.catch((error) => {
+          let identity;
+          if (observer.name) {
+            identity = ` "${observer.name}"`;
+          } else {
+            identity = "";
+          }
+          if (this.#handleError === defaultErrorHandler) {
+            logger.error(`Unhandled error in async observer${identity}:`, error);
+          } else {
+            this.#handleError(error, observer);
+          }
+        });
+      };
+    }
+  }
+  get isAsync() {
+    return this.#isAsync;
+  }
+  set handlePromise(handlePromise) {
+    this.isAsync = true;
+    this.#handlePromise = handlePromise;
+  }
+  get handlePromise() {
+    return this.#handlePromise;
   }
   get isObserved() {
     if (this.#observers) {
@@ -70,7 +108,7 @@ class BasicObservable {
         try {
           result = observer(...payload);
         } catch (e) {
-          this.#errorHandler(asError(e), observer);
+          this.#handleError(asError(e), observer);
         }
         if (this.#once?.has(observer)) {
           this.#once.delete(observer);
@@ -80,25 +118,18 @@ class BasicObservable {
           continue;
         }
         if (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)
-            );
+          result = this.#handlePromise(Promise.resolve(result), observer);
+          if (MaybePromise.is(result)) {
+            return result.then((result2) => {
+              if (result2 === void 0) {
+                return emitNext();
+              }
+              return result2;
+            });
+          }
+          if (result === void 0) {
             continue;
           }
-          return result.then((result2) => {
-            if (result2 === void 0) {
-              return emitNext();
-            }
-            return result2;
-          });
         }
         return result;
       }
@@ -175,12 +206,12 @@ class BasicObservable {
     };
   }
 }
-function constructObservable(errorHandler) {
-  return new BasicObservable(errorHandler);
+function constructObservable(handleError) {
+  return new BasicObservable(handleError);
 }
 const Observable = constructObservable;
-function constructAsyncObservable(errorHandler) {
-  return new BasicObservable(errorHandler, true);
+function constructAsyncObservable(handleError) {
+  return new BasicObservable(handleError, true);
 }
 const AsyncObservable = constructAsyncObservable;
 function event(emitter, name) {
@@ -191,6 +222,8 @@ function event(emitter, name) {
   return observer;
 }
 class EventEmitter {
+  // True private screws up TS types
+  events;
   emit(name, ...payload) {
     event(this, name).emit(...payload);
   }
@@ -200,13 +233,32 @@ class EventEmitter {
   removeListener(name, handler) {
     event(this, name).off(handler);
   }
+  addEvent(name, event2) {
+    if (!this.events) {
+      this.events = {};
+    }
+    this.events[name] = event2;
+  }
+  getEvent(name) {
+    if (!this.events || !(name in this.events)) {
+      throw new ImplementationError(`No such event ${name}`);
+    }
+    return this.events[name] ?? (this.events[name] = Observable());
+  }
+  hasEvent(name, onlyIfInitialized = false) {
+    return this.events && (onlyIfInitialized ? this.events[name] : name in this.events);
+  }
   get eventNames() {
-    return Object.keys(this).filter((k) => typeof this[k]?.on === "function");
+    return this.events ? Object.keys(this.events) : [];
   }
   [Symbol.dispose]() {
-    for (const name of this.eventNames) {
-      this[name][Symbol.dispose]?.();
+    if (!this.events) {
+      return;
+    }
+    for (const event2 of Object.values(this.events)) {
+      event2?.[Symbol.dispose]?.();
     }
+    this.events = void 0;
   }
 }
 class ObservableProxy extends BasicObservable {
@@ -227,13 +279,13 @@ class ObservableProxy extends BasicObservable {
     this.#target.off(this.#emitter);
     super[Symbol.dispose]();
   }
-  get isAsync() {
-    return this.#target.isAsync;
-  }
   get isObserved() {
     return this.#target.isObserved;
   }
   emit;
+  get target() {
+    return this.#target;
+  }
 }
 class ObserverGroup {
   #defaultTarget;
@@ -305,6 +357,215 @@ class ObserverGroup {
     this.#boundObservers.clear();
   }
 }
+class QuietObservable extends BasicObservable {
+  #emitAutomatically = QuietObservable.defaults.emitAutomatically;
+  #suppressionEnabled = QuietObservable.defaults.suppressionEnabled;
+  #minimumEmitIntervalMs = QuietObservable.defaults.minimumEmitIntervalMs;
+  #shouldEmit;
+  #source;
+  #sink;
+  #sourceObserver;
+  #sinkObserver;
+  #deferredPayload;
+  #lastEmitAt;
+  #emitTimer;
+  constructor(config) {
+    super();
+    if (config) {
+      this.config = config;
+    }
+  }
+  get config() {
+    return this;
+  }
+  set config(config) {
+    const { suppressionEnabled, minimumEmitIntervalMs, emitAutomatically } = config;
+    if (emitAutomatically !== void 0) {
+      this.emitAutomatically = emitAutomatically;
+    }
+    if (suppressionEnabled !== void 0) {
+      this.suppressionEnabled = suppressionEnabled;
+    }
+    if (minimumEmitIntervalMs !== void 0) {
+      this.minimumEmitIntervalMs = minimumEmitIntervalMs;
+    }
+    if ("shouldEmit" in config) {
+      this.shouldEmit = config.shouldEmit;
+    }
+    if ("source" in config) {
+      this.source = config.source;
+    }
+    if ("sink" in config) {
+      this.sink = config.sink;
+    }
+    if ("handleError" in config) {
+      this.handleError = config.handleError ?? defaultErrorHandler;
+    }
+    if ("handlePromise" in config && config.handlePromise) {
+      this.handlePromise = config.handlePromise;
+    } else {
+      this.isAsync = config.isAsync ?? false;
+    }
+  }
+  get emitAutomatically() {
+    return this.#emitAutomatically;
+  }
+  set emitAutomatically(value) {
+    this.#emitAutomatically = value;
+    if (value) {
+      this.emitSoon();
+    } else if (this.#emitTimer) {
+      this.#stop();
+    }
+  }
+  get suppressionEnabled() {
+    return this.#suppressionEnabled;
+  }
+  set suppressionEnabled(value) {
+    this.#suppressionEnabled = value;
+  }
+  get minimumEmitIntervalMs() {
+    return this.#minimumEmitIntervalMs;
+  }
+  set minimumEmitIntervalMs(value) {
+    if (this.#minimumEmitIntervalMs === value) {
+      return;
+    }
+    const needStart = this.#emitTimer !== void 0;
+    if (needStart) {
+      this.#stop();
+    }
+    this.#minimumEmitIntervalMs = value;
+    if (needStart) {
+      this.#start();
+    }
+  }
+  get source() {
+    return this.#source;
+  }
+  set source(source) {
+    if (this.#source === source) {
+      return;
+    }
+    if (this.#source && this.#sourceObserver) {
+      this.#source.off(this.#sourceObserver);
+    } else if (this.#sourceObserver === void 0) {
+      this.#sourceObserver = (...payload) => this.emit(...payload);
+    }
+    this.#source = source;
+    if (source) {
+      source.on(this.#sourceObserver);
+    }
+  }
+  get sink() {
+    return this.#sink;
+  }
+  set sink(sink) {
+    if (this.#sink === sink) {
+      return;
+    }
+    if (this.#sink && this.#sinkObserver) {
+      this.off(this.#sinkObserver);
+    }
+    this.#sink = sink;
+    if (sink) {
+      this.#sinkObserver = (...payload) => sink.emit(...payload);
+      this.#sinkObserver[observant] = false;
+      this.on(this.#sinkObserver);
+    }
+  }
+  get shouldEmit() {
+    return this.#shouldEmit;
+  }
+  set shouldEmit(shouldEmit) {
+    this.#shouldEmit = shouldEmit;
+    if (this.#deferredPayload && shouldEmit?.(...this.#deferredPayload) === false) {
+      this.#deferredPayload = void 0;
+      this.#stop();
+    }
+  }
+  get isObserved() {
+    return super.isObserved || this.#sink?.isObserved || false;
+  }
+  isObservedBy(observer) {
+    return this.#sink?.isObservedBy(observer) || this.isObservedBy(observer) || false;
+  }
+  emit(...payload) {
+    const shouldEmit = this.#shouldEmit?.(...payload);
+    if (shouldEmit === false) {
+      return;
+    }
+    const immediate = shouldEmit === "now";
+    if (!immediate && !this.#emitAutomatically) {
+      this.#deferredPayload = payload;
+      return;
+    }
+    const now = Time.nowMs();
+    if (immediate || !this.#suppressionEnabled || this.#lastEmitAt === void 0 || this.#lastEmitAt + this.#minimumEmitIntervalMs < now) {
+      return this.#emit(payload, now);
+    }
+    this.#deferredPayload = payload;
+    this.#start(now);
+  }
+  /**
+   * Emit immediately, regardless of suppression configuration.
+   */
+  emitNow() {
+    this.#stop();
+    if (this.#deferredPayload) {
+      this.#emit(this.#deferredPayload);
+      this.#deferredPayload = void 0;
+    }
+  }
+  /**
+   * Emit as soon as allowed by suppression.
+   */
+  emitSoon() {
+    if (this.#deferredPayload && this.#emitTimer === void 0) {
+      this.#start();
+    }
+  }
+  [Symbol.dispose]() {
+    this.#stop();
+  }
+  #emit(payload, now) {
+    this.#deferredPayload = void 0;
+    this.#lastEmitAt = now ?? Time.nowMs();
+    this.#stop();
+    super.emit(...payload);
+  }
+  #start(now) {
+    if (this.#emitTimer || this.#deferredPayload === void 0) {
+      return;
+    }
+    let timeout;
+    if (this.#lastEmitAt === void 0) {
+      timeout = 0;
+    } else {
+      timeout = this.#minimumEmitIntervalMs - ((now ?? Time.nowMs()) - this.#lastEmitAt);
+    }
+    if (timeout <= 0) {
+      this.emitNow();
+    } else {
+      this.#emitTimer = Time.getTimer("delayed emit", timeout, this.emitNow.bind(this));
+      this.#emitTimer.start();
+    }
+  }
+  #stop() {
+    if (this.#emitTimer) {
+      this.#emitTimer.stop();
+      this.#emitTimer = void 0;
+    }
+  }
+}
+((QuietObservable2) => {
+  QuietObservable2.now = "now";
+  QuietObservable2.defaults = {
+    emitAutomatically: true,
+    suppressionEnabled: true,
+    minimumEmitIntervalMs: 1e3
+  };
+})(QuietObservable || (QuietObservable = {}));
 export {
   AsyncObservable,
   BasicObservable,
@@ -312,6 +573,7 @@ export {
   Observable,
   ObservableProxy,
   ObserverGroup,
+  QuietObservable,
   observant
 };
 //# sourceMappingURL=Observable.js.map