grainjs 1.0.2 → 1.1.0

package/dist/cjs/lib/domevent.js

@@ -1,44 +1,4 @@
 "use strict";
-/**
- * domevent provides a way to listen to DOM events, similar to JQuery's `on()` function. Its
- * methods are also exposed via the dom.js module, as `dom.on()`, etc.
- *
- * It is typically used as an argument to the dom() function:
- *
- *    dom('div', dom.on('click', (event, elem) => { ... }));
- *
- * When the div is disposed, the listener is automatically removed.
- *
- * The underlying interface to listen to an event is this:
- *
- *    let listener = dom.onElem(elem, 'click', (event, elem) => { ... });
- *
- * The callback is called with the event and the element to which it was attached. Unlike in
- * JQuery, the callback's return value is ignored. Use event.stopPropagation() and
- * event.preventDefault() explicitly if needed.
- *
- * To stop listening:
- *
- *    listener.dispose();
- *
- * Disposing the listener returned by .onElem() is the only way to stop listening to an event. You
- * can use autoDispose to stop listening automatically when subscribing in a Disposable object:
- *
- *    this.autoDispose(domevent.onElem(document, 'mouseup', callback));
- *
- * To listen to descendants of an element matching the given selector (what JQuery calls
- * "delegated events", see http://api.jquery.com/on/):
- *
- *    dom('div', dom.onMatch('.selector', 'click', (event, elem) => { ... }));
- * or
- *    let lis = domevent.onMatchElem(elem, '.selector', 'click', (event, el) => { ... });
- *
- * In this usage, the element passed to the callback will be a DOM element matching the given
- * selector. If there are multiple matches, the callback is only called for the innermost one.
- *
- * If you need to remove the callback on first call, here's a useful pattern:
- *    let lis = domevent.onElem(elem, 'mouseup', e => { lis.dispose(); other_work(); });
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.onKeyDown = exports.onKeyPress = exports.onKeyElem = exports.onMatch = exports.onMatchElem = exports.on = exports.onElem = void 0;
 function _findMatch(inner, outer, selector) {
@@ -76,43 +36,103 @@ class DomEventMatchListener extends DomEventListener {
     }
 }
 /**
- * Listen to a DOM event. The `on()` variant takes no `elem` argument, and may be used as an
- * argument to dom() function.
- * @param {DOMElement} elem: DOM Element to listen to.
- * @param {String} eventType: Event type to listen for (e.g. 'click').
- * @param {Function} callback: Callback to call as `callback(event, elem)`, where elem is `elem`.
- * @param [Boolean] options.useCapture: Add the listener in the capture phase. This should very
+ * Listen to a DOM event, returning the listener object.
+ * ```ts
+ * const listener = dom.onElem(elem, 'click', (event, elem) => { ... });
+ * ```
+ *
+ * To stop listening:
+ * ```ts
+ * listener.dispose();
+ * ```
+ *
+ * Disposing the listener returned by `onElem()` is the only way to stop listening to an event. You
+ * can use `autoDispose` to stop listening automatically when subscribing in a `Disposable` object:
+ * ```ts
+ * this.autoDispose(domevent.onElem(document, 'mouseup', callback));
+ * ```
+ *
+ * If you need "once" semantics, i.e. to remove the callback on first call, here's a useful pattern:
+ * ```ts
+ * const lis = domevent.onElem(elem, 'mouseup', e => { lis.dispose(); other_work(); });
+ * ```
+ *
+ * @param elem - DOM Element to listen to.
+ * @param eventType - Event type to listen for (e.g. `'click'`).
+ * @param callback - Callback to call as `callback(event, elem)`, where elem is `elem`.
+ * @param options - `useCapture: boolean`: Add the listener in the capture phase. This should very
  *    rarely be useful (e.g. JQuery doesn't even offer it as an option).
- * @returns {Object} Listener object whose .dispose() method will remove the event listener.
+ * @returns Listener object whose `.dispose()` method will remove the event listener.
  */
 function onElem(elem, eventType, callback, { useCapture = false } = {}) {
     return new DomEventListener(elem, eventType, callback, useCapture);
 }
 exports.onElem = onElem;
+/**
+ * Listen to a DOM event. It is typically used as an argument to the `dom()` function:
+ * ```ts
+ * dom('div', dom.on('click', (event, elem) => { ... }));
+ * ```
+ *
+ * When the div is disposed, the listener is automatically removed.
+ *
+ * The callback is called with the event and the element to which it was attached. Unlike in, say,
+ * JQuery, the callback's return value is ignored. Use `event.stopPropagation()` and
+ * `event.preventDefault()` explicitly if needed.
+ *
+ * To listen to descendants of an element matching the given selector (what JQuery calls
+ * "delegated events", see http://api.jquery.com/on/), see [`onMatch`](#onMatch).
+ *
+ * @param eventType - Event type to listen for (e.g. `'click'`).
+ * @param callback - Callback to call as `callback(event, elem)`, where `elem` is the element this
+ *    listener is attached to.
+ * @param options - `useCapture?: boolean`: Add the listener in the capture phase.
+ */
 function on(eventType, callback, { useCapture = false } = {}) {
     // tslint:disable-next-line:no-unused-expression
     return (elem) => { new DomEventListener(elem, eventType, callback, useCapture); };
 }
 exports.on = on;
 /**
- * Listen to a DOM event on descendants of the given elem matching the given selector. The
- * `onMatch()` variant takes no `elem` argument, and may be used as an argument to dom().
- * @param {DOMElement} elem: DOM Element to whose descendants to listen.
- * @param {String} selector: CSS selector string to filter elements that trigger this event.
+ * Listen to a DOM event on descendants of the given elem matching the given selector.
+ *
+ * ```ts
+ * const let lis = domevent.onMatchElem(elem, '.selector', 'click', (event, el) => { ... });
+ * ```
+ *
+ * @param elem - DOM Element to whose descendants to listen.
+ * @param selector - CSS selector string to filter elements that trigger this event.
  *    JQuery calls it "delegated events" (http://api.jquery.com/on/). The callback will only be
  *    called when the event occurs for an element matching the given selector. If there are
  *    multiple elements matching the selector, the callback is only called for the innermost one.
- * @param {String} eventType: Event type to listen for (e.g. 'click').
- * @param {Function} callback: Callback to call as `callback(event, elem)`, where elem is a
+ * @param eventType - Event type to listen for (e.g. 'click').
+ * @param callback - Callback to call as `callback(event, elem)`, where elem is a
  *    descendent of `elem` which matches `selector`.
- * @param [Boolean] options.useCapture: Add the listener in the capture phase. This should very
- *    rarely be useful (e.g. JQuery doesn't even offer it as an option).
- * @returns {Object} Listener object whose .dispose() method will remove the event listener.
+ * @param options - `useCapture?: boolean`: Add the listener in the capture phase.
+ * @returns Listener object whose `.dispose()` method will remove the event listener.
  */
 function onMatchElem(elem, selector, eventType, callback, { useCapture = false } = {}) {
     return new DomEventMatchListener(elem, eventType, callback, useCapture, selector);
 }
 exports.onMatchElem = onMatchElem;
+/**
+ * Listen to a DOM event on descendants of the given element matching the given selector.
+ *
+ * This is similar to JQuery's [delegated events](https://api.jquery.com/on/#direct-and-delegated-events)
+ *
+ * ```ts
+ * dom('div', dom.onMatch('.selector', 'click', (event, elem) => { ... }));
+ * ```
+ *
+ * In this usage, the element passed to the callback will be a DOM element matching the given
+ * selector. If there are multiple matches, the callback is only called for the innermost one.
+ *
+ * @param selector - CSS selector string to filter elements that trigger this event.
+ * @param eventType - Event type to listen for (e.g. `'click'`).
+ * @param callback - Callback to call as `callback(event, elem)`, where `elem` is an element
+ *    matching `selector`.
+ * @param options - `useCapture?: boolean`: Add the listener in the capture phase.
+ */
 function onMatch(selector, eventType, callback, { useCapture = false } = {}) {
     // tslint:disable-next-line:no-unused-expression
     return (elem) => { new DomEventMatchListener(elem, eventType, callback, useCapture, selector); };
@@ -122,8 +142,6 @@ exports.onMatch = onMatch;
  * Listen to key events (typically 'keydown' or 'keypress'), with specified per-key callbacks.
  * Key names are listed at https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values
  *
- * Methods onKeyPress() and onKeyDown() are intended to be used as arguments to dom().
- *
  * By default, handled events are stopped from bubbling with stopPropagation() and
  * preventDefault(). If, however, you register a key with a "$" suffix (i.e. "Enter$" instead of
  * "Enter"), then the event is allowed to bubble normally.
@@ -132,7 +150,7 @@ exports.onMatch = onMatch;
  * to allow this element to receive keyboard events.
  *
  * For example:
- *
+ * ```
  *    dom('input', ...
  *      dom.onKeyDown({
  *        Enter: (e, elem) => console.log("Enter pressed"),
@@ -140,6 +158,7 @@ exports.onMatch = onMatch;
  *        Delete$: (e, elem) => console.log("Delete pressed, will bubble"),
  *      })
  *    )
+ * ```
  */
 function onKeyElem(elem, evType, keyHandlers) {
     if (!(elem.tabIndex >= 0)) { // If tabIndex property is undefined or -1,
@@ -158,10 +177,16 @@ function onKeyElem(elem, evType, keyHandlers) {
     });
 }
 exports.onKeyElem = onKeyElem;
+/**
+ * Add listeners to `"keypress"` events. See [`onKeyElem`](#onKeyElem) for details.
+ */
 function onKeyPress(keyHandlers) {
     return (elem) => { onKeyElem(elem, 'keypress', keyHandlers); };
 }
 exports.onKeyPress = onKeyPress;
+/**
+ * Add listeners to `"keydown"` events. See [`onKeyElem`](#onKeyElem) for details.
+ */
 function onKeyDown(keyHandlers) {
     return (elem) => { onKeyElem(elem, 'keydown', keyHandlers); };
 }

package/dist/cjs/lib/domevent.js.map

@@ -1 +1 @@
-{"version":3,"file":"domevent.js","sourceRoot":"","sources":["../../../lib/domevent.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;;;AAWH,SAAS,UAAU,CAAC,KAAc,EAAE,KAAc,EAAE,QAAgB;IAClE,KAAK,IAAI,EAAE,GAAiB,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE;QAC5E,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;YACxB,OAAO,EAAE,CAAC;SACX;KACF;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,gBAAgB;IACpB,YAAsB,IAAO,EACP,SAAiB,EACjB,QAAuB,EACvB,UAAmB,EACnB,QAAiB;QAJjB,SAAI,GAAJ,IAAI,CAAG;QACP,cAAS,GAAT,SAAS,CAAQ;QACjB,aAAQ,GAAR,QAAQ,CAAe;QACvB,eAAU,GAAV,UAAU,CAAS;QACnB,aAAQ,GAAR,QAAQ,CAAS;QACrC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACpE,CAAC;IAEM,WAAW,CAAC,KAAQ;QACzB,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QACzB,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAEM,OAAO;QACZ,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACvE,CAAC;CACF;AAED,MAAM,qBAAuC,SAAQ,gBAAgC;IAC5E,WAAW,CAAC,KAAQ;QACzB,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,MAAiB,EAAE,IAAI,CAAC,IAAe,EAAE,IAAI,CAAC,QAAS,CAAC,CAAC;QACvF,IAAI,IAAI,EAAE;YACR,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;YACzB,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;SACjB;IACH,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,SAAgB,MAAM,CACpB,IAAO,EAAE,SAAY,EAAE,QAAkC,EAAE,EAAC,UAAU,GAAG,KAAK,EAAC,GAAG,EAAE;IACpF,OAAO,IAAI,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;AACrE,CAAC;AAHD,wBAGC;AAED,SAAgB,EAAE,CAChB,SAAY,EAAE,QAAkC,EAAE,EAAC,UAAU,GAAG,KAAK,EAAC,GAAG,EAAE;IAC3E,gDAAgD;IAChD,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AACpF,CAAC;AAJD,gBAIC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,WAAW,CAAC,IAAiB,EAAE,QAAgB,EAAE,SAAiB,EACtD,QAAiB,EAAE,EAAC,UAAU,GAAG,KAAK,EAAC,GAAG,EAAE;IACtE,OAAO,IAAI,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AACpF,CAAC;AAHD,kCAGC;AACD,SAAgB,OAAO,CAAC,QAAgB,EAAE,SAAiB,EAAE,QAAiB,EACtD,EAAC,UAAU,GAAG,KAAK,EAAC,GAAG,EAAE;IAC/C,gDAAgD;IAChD,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACnG,CAAC;AAJD,0BAIC;AAQD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,SAAS,CACvB,IAAO,EAAE,MAAoB,EAAE,WAA4B;IAE3D,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,EAAqB,2CAA2C;QACzF,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAU,wDAAwD;KACvG;IACD,OAAO,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE;QACxC,MAAM,YAAY,GAAG,WAAW,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,YAAY,IAAI,WAAW,CAAC,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;QAC1D,IAAI,OAAO,EAAE;YACX,IAAI,YAAa,EAAE;gBACjB,EAAE,CAAC,eAAe,EAAE,CAAC;gBACrB,EAAE,CAAC,cAAc,EAAE,CAAC;aACrB;YACD,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;SACpB;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAjBD,8BAiBC;AAED,SAAgB,UAAU,CAAwB,WAA4B;IAC5E,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC;AAFD,gCAEC;AAED,SAAgB,SAAS,CAAwB,WAA4B;IAC3E,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAFD,8BAEC"}
+{"version":3,"file":"domevent.js","sourceRoot":"","sources":["../../../lib/domevent.ts"],"names":[],"mappings":"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"}

package/dist/cjs/lib/emit.d.ts

@@ -1,29 +1,12 @@
+export type ListenerCB<T> = (this: T, ...args: any[]) => void;
 /**
- * emit.js implements an Emitter class which emits events to a list of listeners. Listeners are
- * simply functions to call, and "emitting an event" just calls those functions.
- *
- * This is similar to Backbone events, with more focus on efficiency. Both inserting and removing
- * listeners is constant time.
- *
- * To create an emitter:
- *    let emitter = new Emitter();
- *
- * To add a listener:
- *    let listener = fooEmitter.addListener(callback);
- * To remove a listener:
- *    listener.dispose();
- *
- * The only way to remove a listener is to dispose the Listener object returned by addListener().
- * You can often use autoDispose to do this automatically when subscribing in a constructor:
- *    this.autoDispose(fooEmitter.addListener(this.onFoo, this));
- *
- * To emit an event, call emit() with any number of arguments:
- *    emitter.emit("hello", "world");
+ * A callback that listens to _changes_ in the Emitter listeners. This is mainly used for
+ * internal purposes.
  */
-export declare type ListenerCB<T> = (this: T, ...args: any[]) => void;
-export declare type ChangeCB = (hasListeners: boolean) => void;
+export type ChangeCB = (hasListeners: boolean) => void;
 /**
  * This is an implementation of a doubly-linked list, with just the minimal functionality we need.
+ * @internal
  */
 export declare class LLink {
     protected _next: LLink | null;
@@ -34,18 +17,62 @@ export declare class LLink {
     protected _removeNode(node: LLink): void;
     protected _disposeList(): void;
 }
+/**
+ * An `Emitter` emits events to a list of listeners. Listeners are
+ * simply functions to call, and "emitting an event" just calls those functions.
+ *
+ * This is similar to Backbone events, with more focus on efficiency. Both inserting and removing
+ * listeners is constant time.
+ *
+ * To create an emitter:
+ * ```ts
+ * const emitter = new Emitter();
+ * ```
+ *
+ * To add a listener:
+ * ```ts
+ * const listener = fooEmitter.addListener(callback);
+ * ```
+ *
+ * To remove a listener:
+ * ```ts
+ * listener.dispose();
+ * ```
+ *
+ * The only way to remove a listener is to dispose the `Listener` object returned by `addListener()`.
+ * You can often use autoDispose to do this automatically when subscribing in a constructor:
+ * ```ts
+ * this.autoDispose(fooEmitter.addListener(this.onFoo, this));
+ * ```
+ *
+ * To emit an event, call `emit()` with any number of arguments:
+ * ```ts
+ * emitter.emit("hello", "world");
+ * ```
+ *
+ * @privateRemarks
+ *
+ * Note about a possible alternative implementation.
+ *
+ * We could implement the same interface using an array of listeners. Certain issues apply, in
+ * particular with removing listeners from inside emit(), and in ensuring that removals are
+ * constant time on average. Such an implementation was attempted and timed. The result is that
+ * compared to the linked-list implementation here, add/remove combination could be made nearly
+ * twice faster (on average), while emit and add/remove/emit are consistently slightly slower.
+ *
+ * The implementation here was chosen based on those timings, and as the simpler one. For example,
+ * on one setup (macbook, node4, 5-listener queue), add+remove take 0.1us, while add+remove+emit
+ * take 3.82us. (In array-based implementation with same set up, add+remove is 0.06us, while
+ * add+remove+emit is 4.80us.)
+ */
 export declare class Emitter extends LLink {
     private _changeCB;
     private _changeCBContext;
-    /**
-     * Constructs an Emitter object.
-     */
-    constructor();
     /**
      * Adds a listening callback to the list of functions to call on emit().
-     * @param {Function} callback: Function to call.
-     * @param {Object} optContext: Context for the function.
-     * @returns {Listener} Listener object. Its dispose() method removes the callback from the list.
+     * @param callback - Function to call.
+     * @param optContext - Context for the function.
+     * @returns Listener object. Its dispose() method removes the callback from the list.
      */
     addListener<T>(callback: ListenerCB<T>, optContext?: T): Listener;
     /**
@@ -54,7 +81,7 @@ export declare class Emitter extends LLink {
     emit(...args: any[]): void;
     /**
      * Sets the single callback that would get called when a listener is added or removed.
-     * @param {Function} changeCB(hasListeners): Function to call after a listener is added or
+     * @param changeCB - Function to call after a listener is added or
      *    removed. It's called with a boolean indicating whether this Emitter has any listeners.
      *    Pass in `null` to unset the callback. Note that it can be called multiple times in a row
      *    with hasListeners `true`.
@@ -62,6 +89,7 @@ export declare class Emitter extends LLink {
     setChangeCB(changeCB: ChangeCB, optContext?: any): void;
     /**
      * Helper used by Listener class, but not intended for public usage.
+     * @internal
      */
     _triggerChangeCB(): void;
     /**
@@ -75,14 +103,16 @@ export declare class Emitter extends LLink {
     dispose(): void;
 }
 /**
- * Listener object wraps a callback added to an Emitter, allowing for O(1) removal when the
- * listener is disposed.
+ * The `Listener` object wraps a callback added to an Emitter, allowing for O(1) removal when the
+ * listener is disposed. It implements `IDisposable`.
  */
 export declare class Listener extends LLink {
     private emitter;
     private callback;
     private context?;
+    /** @internal */
     static callAll(begin: LLink, end: LLink, args: any[]): void;
     constructor(emitter: Emitter, callback: ListenerCB<any>, context?: any);
+    /** @internal */
     dispose(): void;
 }

package/dist/cjs/lib/emit.js

@@ -1,44 +1,10 @@
 "use strict";
-/**
- * emit.js implements an Emitter class which emits events to a list of listeners. Listeners are
- * simply functions to call, and "emitting an event" just calls those functions.
- *
- * This is similar to Backbone events, with more focus on efficiency. Both inserting and removing
- * listeners is constant time.
- *
- * To create an emitter:
- *    let emitter = new Emitter();
- *
- * To add a listener:
- *    let listener = fooEmitter.addListener(callback);
- * To remove a listener:
- *    listener.dispose();
- *
- * The only way to remove a listener is to dispose the Listener object returned by addListener().
- * You can often use autoDispose to do this automatically when subscribing in a constructor:
- *    this.autoDispose(fooEmitter.addListener(this.onFoo, this));
- *
- * To emit an event, call emit() with any number of arguments:
- *    emitter.emit("hello", "world");
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Listener = exports.Emitter = exports.LLink = void 0;
-// Note about a possible alternative implementation.
-//
-// We could implement the same interface using an array of listeners. Certain issues apply, in
-// particular with removing listeners from inside emit(), and in ensuring that removals are
-// constant time on average. Such an implementation was attempted and timed. The result is that
-// compared to the linked-list implementation here, add/remove combination could be made nearly
-// twice faster (on average), while emit and add/remove/emit are consistently slightly slower.
-//
-// The implementation here was chosen based on those timings, and as the simpler one. For example,
-// on one setup (macbook, node4, 5-listener queue), add+remove take 0.1us, while add+remove+emit
-// take 3.82us. (In array-based implementation with same set up, add+remove is 0.06us, while
-// add+remove+emit is 4.80us.)
-// The private property name to hold next/prev pointers.
 function _noop() { }
 /**
  * This is an implementation of a doubly-linked list, with just the minimal functionality we need.
+ * @internal
  */
 class LLink {
     constructor() {
@@ -67,7 +33,7 @@ class LLink {
         node._prev = node._next = null;
     }
     _disposeList() {
-        let node = this;
+        let node = this; // eslint-disable-line @typescript-eslint/no-this-alias
         let next = node._next;
         while (next !== null) {
             node._next = node._prev = null;
@@ -77,20 +43,65 @@ class LLink {
     }
 }
 exports.LLink = LLink;
+/**
+ * An `Emitter` emits events to a list of listeners. Listeners are
+ * simply functions to call, and "emitting an event" just calls those functions.
+ *
+ * This is similar to Backbone events, with more focus on efficiency. Both inserting and removing
+ * listeners is constant time.
+ *
+ * To create an emitter:
+ * ```ts
+ * const emitter = new Emitter();
+ * ```
+ *
+ * To add a listener:
+ * ```ts
+ * const listener = fooEmitter.addListener(callback);
+ * ```
+ *
+ * To remove a listener:
+ * ```ts
+ * listener.dispose();
+ * ```
+ *
+ * The only way to remove a listener is to dispose the `Listener` object returned by `addListener()`.
+ * You can often use autoDispose to do this automatically when subscribing in a constructor:
+ * ```ts
+ * this.autoDispose(fooEmitter.addListener(this.onFoo, this));
+ * ```
+ *
+ * To emit an event, call `emit()` with any number of arguments:
+ * ```ts
+ * emitter.emit("hello", "world");
+ * ```
+ *
+ * @privateRemarks
+ *
+ * Note about a possible alternative implementation.
+ *
+ * We could implement the same interface using an array of listeners. Certain issues apply, in
+ * particular with removing listeners from inside emit(), and in ensuring that removals are
+ * constant time on average. Such an implementation was attempted and timed. The result is that
+ * compared to the linked-list implementation here, add/remove combination could be made nearly
+ * twice faster (on average), while emit and add/remove/emit are consistently slightly slower.
+ *
+ * The implementation here was chosen based on those timings, and as the simpler one. For example,
+ * on one setup (macbook, node4, 5-listener queue), add+remove take 0.1us, while add+remove+emit
+ * take 3.82us. (In array-based implementation with same set up, add+remove is 0.06us, while
+ * add+remove+emit is 4.80us.)
+ */
 class Emitter extends LLink {
-    /**
-     * Constructs an Emitter object.
-     */
     constructor() {
-        super();
+        super(...arguments);
         this._changeCB = _noop;
         this._changeCBContext = undefined;
     }
     /**
      * Adds a listening callback to the list of functions to call on emit().
-     * @param {Function} callback: Function to call.
-     * @param {Object} optContext: Context for the function.
-     * @returns {Listener} Listener object. Its dispose() method removes the callback from the list.
+     * @param callback - Function to call.
+     * @param optContext - Context for the function.
+     * @returns Listener object. Its dispose() method removes the callback from the list.
      */
     addListener(callback, optContext) {
         return new Listener(this, callback, optContext);
@@ -103,7 +114,7 @@ class Emitter extends LLink {
     }
     /**
      * Sets the single callback that would get called when a listener is added or removed.
-     * @param {Function} changeCB(hasListeners): Function to call after a listener is added or
+     * @param changeCB - Function to call after a listener is added or
      *    removed. It's called with a boolean indicating whether this Emitter has any listeners.
      *    Pass in `null` to unset the callback. Note that it can be called multiple times in a row
      *    with hasListeners `true`.
@@ -114,6 +125,7 @@ class Emitter extends LLink {
     }
     /**
      * Helper used by Listener class, but not intended for public usage.
+     * @internal
      */
     _triggerChangeCB() {
         this._changeCB.call(this._changeCBContext, this.hasListeners());
@@ -136,10 +148,18 @@ class Emitter extends LLink {
 }
 exports.Emitter = Emitter;
 /**
- * Listener object wraps a callback added to an Emitter, allowing for O(1) removal when the
- * listener is disposed.
+ * The `Listener` object wraps a callback added to an Emitter, allowing for O(1) removal when the
+ * listener is disposed. It implements `IDisposable`.
  */
 class Listener extends LLink {
+    /** @internal */
+    static callAll(begin, end, args) {
+        while (begin !== end) {
+            const lis = begin;
+            lis.callback.call(lis.context, ...args);
+            begin = lis._next;
+        }
+    }
     constructor(emitter, callback, context) {
         super();
         this.emitter = emitter;
@@ -148,13 +168,7 @@ class Listener extends LLink {
         this._insertBefore(emitter, this);
         emitter._triggerChangeCB();
     }
-    static callAll(begin, end, args) {
-        while (begin !== end) {
-            const lis = begin;
-            lis.callback.call(lis.context, ...args);
-            begin = lis._next;
-        }
-    }
+    /** @internal */
     dispose() {
         if (this.isDisposed()) {
             return;

package/dist/cjs/lib/emit.js.map

@@ -1 +1 @@
-{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../../lib/emit.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../../lib/emit.ts"],"names":[],"mappings":";;;AAAA,SAAS,KAAK,KAAe,CAAC;AAU9B;;;GAGG;AACH,MAAa,KAAK;IAIhB;QAHU,UAAK,GAAe,IAAI,CAAC;QACzB,UAAK,GAAe,IAAI,CAAC;QAGjC,2FAA2F;QAC3F,2DAA2D;QAC3D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAEM,UAAU;QACf,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;IACrB,CAAC;IAES,aAAa,CAAC,IAAW,EAAE,IAAW;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAM,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAES,WAAW,CAAC,IAAW;QAC/B,IAAI,IAAI,CAAC,KAAK,EAAE;YACd,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YAC9B,IAAI,CAAC,KAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;SAChC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACjC,CAAC;IAES,YAAY;QACpB,IAAI,IAAI,GAAU,IAAI,CAAC,CAAK,uDAAuD;QACnF,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;QACtB,OAAO,IAAI,KAAK,IAAI,EAAE;YACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAC/B,IAAI,GAAG,IAAI,CAAC;YACZ,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;SACnB;IACH,CAAC;CACF;AAxCD,sBAwCC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAa,OAAQ,SAAQ,KAAK;IAAlC;;QACU,cAAS,GAAa,KAAK,CAAC;QAC5B,qBAAgB,GAAQ,SAAS,CAAC;IAuD5C,CAAC;IArDC;;;;;OAKG;IACI,WAAW,CAAI,QAAuB,EAAE,UAAc;QAC3D,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACI,IAAI,CAAC,GAAG,IAAW;QACxB,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;OAMG;IACI,WAAW,CAAC,QAAkB,EAAE,UAAgB;QACrD,IAAI,CAAC,SAAS,GAAG,QAAQ,IAAI,KAAK,CAAC;QACnC,IAAI,CAAC,gBAAgB,GAAG,UAAU,CAAC;IACrC,CAAC;IAED;;;OAGG;IACI,gBAAgB;QACrB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACI,YAAY;QACjB,OAAO,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACI,OAAO;QACZ,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;IACpC,CAAC;CACF;AAzDD,0BAyDC;AAED;;;GAGG;AACH,MAAa,QAAS,SAAQ,KAAK;IACjC,gBAAgB;IACT,MAAM,CAAC,OAAO,CAAC,KAAY,EAAE,GAAU,EAAE,IAAW;QACzD,OAAO,KAAK,KAAK,GAAG,EAAE;YACpB,MAAM,GAAG,GAAG,KAAiB,CAAC;YAC9B,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;YACxC,KAAK,GAAG,GAAG,CAAC,KAAM,CAAC;SACpB;IACH,CAAC;IAED,YAAoB,OAAgB,EAChB,QAAyB,EACzB,OAAa;QAC/B,KAAK,EAAE,CAAC;QAHU,YAAO,GAAP,OAAO,CAAS;QAChB,aAAQ,GAAR,QAAQ,CAAiB;QACzB,YAAO,GAAP,OAAO,CAAM;QAE/B,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAClC,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAC7B,CAAC;IAED,gBAAgB;IACT,OAAO;QACZ,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE;YAAE,OAAO;SAAE;QAClC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAClC,CAAC;CACF;AAxBD,4BAwBC"}

package/dist/cjs/lib/kowrap.d.ts

@@ -32,7 +32,7 @@ export interface IKnockoutReadObservable<T> {
     subscribe(callback: (newValue: T) => void, target?: any, event?: "change"): any;
     getSubscriptionsCount(): number;
 }
-export declare type InferKoType<KObs extends IKnockoutReadObservable<any>> = KObs extends {
+export type InferKoType<KObs extends IKnockoutReadObservable<any>> = KObs extends {
     peek(): infer T;
 } ? T : never;
 /**
@@ -44,18 +44,21 @@ export declare type InferKoType<KObs extends IKnockoutReadObservable<any>> = KOb
  */
 export declare function fromKo<KObs extends IKnockoutObservable<any>>(koObs: KObs): Observable<InferKoType<KObs>>;
 /**
- * An Observable that wraps a Knockout observable, created via fromKo(). It keeps minimal overhead
+ * An Observable that wraps a Knockout observable, created via `fromKo()`. It keeps minimal overhead
  * when unused by only subscribing to the wrapped observable while it itself has subscriptions.
  *
- * This way, when unused, the only reference is from the wrapper to the wrapped object. KoWrapObs
+ * This way, when unused, the only reference is from the wrapper to the wrapped object. `KoWrapObs`
  * should not be disposed; its lifetime is tied to that of the wrapped object.
  */
 export declare class KoWrapObs<T> extends Observable<T> {
     private _koObs;
     private _koSub;
     constructor(_koObs: IKnockoutObservable<T>);
+    /** @override */
     get(): T;
+    /** @override */
     set(value: T): void;
+    /** @override */
     dispose(): void;
 }
 export interface IKnockoutModule {

package/dist/cjs/lib/kowrap.js

@@ -41,10 +41,10 @@ function fromKo(koObs) {
 }
 exports.fromKo = fromKo;
 /**
- * An Observable that wraps a Knockout observable, created via fromKo(). It keeps minimal overhead
+ * An Observable that wraps a Knockout observable, created via `fromKo()`. It keeps minimal overhead
  * when unused by only subscribing to the wrapped observable while it itself has subscriptions.
  *
- * This way, when unused, the only reference is from the wrapper to the wrapped object. KoWrapObs
+ * This way, when unused, the only reference is from the wrapper to the wrapped object. `KoWrapObs`
  * should not be disposed; its lifetime is tied to that of the wrapped object.
  */
 class KoWrapObs extends observable_1.Observable {
@@ -65,8 +65,11 @@ class KoWrapObs extends observable_1.Observable {
             }
         });
     }
+    /** @override */
     get() { return this._koObs.peek(); }
-    set(value) { observable_1.bundleChanges(() => this._koObs(value)); }
+    /** @override */
+    set(value) { (0, observable_1.bundleChanges)(() => this._koObs(value)); }
+    /** @override */
     dispose() { throw new Error("KoWrapObs should not be disposed"); }
 }
 exports.KoWrapObs = KoWrapObs;

package/dist/cjs/lib/kowrap.js.map

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