@barchart/common-js/dist/cjs/messaging/Event.js

Library of common JavaScript utilities

var __create = Object.create;
var __defProp = Object.defineProperty;
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
var __getOwnPropNames = Object.getOwnPropertyNames;
var __getProtoOf = Object.getPrototypeOf;
var __hasOwnProp = Object.prototype.hasOwnProperty;
var __export = (target, all) => {
  for (var name in all)
    __defProp(target, name, { get: all[name], enumerable: true });
};
var __copyProps = (to, from, except, desc) => {
  if (from && typeof from === "object" || typeof from === "function") {
    for (let key of __getOwnPropNames(from))
      if (!__hasOwnProp.call(to, key) && key !== except)
        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
  }
  return to;
};
var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
  // If the importer is in node compatibility mode or this is not an ESM
  // file that has been converted to a CommonJS file using a Babel-
  // compatible transform (i.e. "__esModule" has not been set), then set
  // "default" to the CommonJS "module.exports" for node compatibility.
  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
  mod
));
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
var Event_exports = {};
__export(Event_exports, {
  default: () => Event
});
module.exports = __toCommonJS(Event_exports);
var assert = __toESM(require("./../lang/assert.js"));
var import_Disposable = __toESM(require("./../lang/Disposable.js"));
class Event extends import_Disposable.default {
  #sender;
  #observers;
  /**
   * @param {*} sender - The object which owns the event.
   */
  constructor(sender) {
    super();
    this.#sender = sender || null;
    this.#observers = [];
  }
  /**
   * Registers an event handler which will receive a notification when
   * {@link Event#fire} is called.
   *
   * @public
   * @param {Function} handler - The function which will be called each time the event fires. The first argument will be the event data. The second argument will be the event owner (i.e. sender).
   * @returns {Disposable}
   */
  register(handler) {
    assert.argumentIsRequired(handler, "handler", Function);
    this.#addRegistration(handler);
    return import_Disposable.default.fromAction(() => {
      if (this.disposed) {
        return;
      }
      this.#removeRegistration(handler);
    });
  }
  /**
   * Removes registration for an event handler. That is, the handler will
   * no longer be called if the event fires.
   *
   * @public
   * @param {Function} handler
   */
  unregister(handler) {
    assert.argumentIsRequired(handler, "handler", Function);
    this.#removeRegistration(handler);
  }
  /**
   * Removes all handlers from the event.
   *
   * @public
   */
  clear() {
    this.#observers = [];
  }
  /**
   * Triggers the event, calling all previously registered handlers.
   *
   * @public
   * @param {*} data - The data to pass each handler.
   */
  fire(data) {
    let observers = this.#observers;
    for (let i = 0; i < observers.length; i++) {
      let observer = observers[i];
      observer(data, this.#sender);
    }
  }
  /**
   * Returns true if no handlers are currently registered.
   *
   * @public
   * @returns {boolean}
   */
  getIsEmpty() {
    return this.#observers.length === 0;
  }
  /**
   * @protected
   * @override
   */
  _onDispose() {
    this.#observers = null;
  }
  #addRegistration(handler) {
    let copiedObservers = this.#observers.slice();
    copiedObservers.push(handler);
    this.#observers = copiedObservers;
  }
  #removeRegistration(handler) {
    const indicesToRemove = [];
    for (let i = 0; i < this.#observers.length; i++) {
      let candidate = this.#observers[i];
      if (candidate === handler) {
        indicesToRemove.push(i);
      }
    }
    if (indicesToRemove.length > 0) {
      const copiedObservers = this.#observers.slice();
      for (let j = indicesToRemove.length - 1; !(j < 0); j--) {
        copiedObservers.splice(indicesToRemove[j], 1);
      }
      this.#observers = copiedObservers;
    }
  }
  /**
   * Returns a string representation.
   *
   * @public
   * @returns {string}
   */
  toString() {
    return "[Event]";
  }
}

{
	const cjsExports = module.exports;
	const cjsDefaultExport = cjsExports && cjsExports.__esModule ? cjsExports.default : cjsExports;

	if (cjsDefaultExport && (typeof cjsDefaultExport === 'function' || typeof cjsDefaultExport === 'object')) {
		Object.keys(cjsExports).forEach((key) => {
			if (key !== 'default' && key !== '__esModule') {
				cjsDefaultExport[key] = cjsExports[key];
			}
		});
	}

	module.exports = cjsDefaultExport;
}