@typescript-package/event-emitter 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 typescript-package
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,220 @@
+
+<a href="https://www.typescriptlang.org/">
+  <img
+    src="https://raw.githubusercontent.com/typescript-package/core/refs/heads/main/ts-package-barcode-logo-512.png"
+    width="20%"
+    title="@typescript-package/event-emitter - A lightweight TypeScript package for event emitter."
+  />
+</a>
+
+## @typescript-package/event-emitter
+
+<!-- npm badge -->
+[![npm version][typescript-package-npm-badge-svg]][typescript-package-npm-badge]
+[![GitHub issues][typescript-package-badge-issues]][typescript-package-issues]
+[![GitHub license][typescript-package-badge-license]][typescript-package-license]
+
+A **lightweight** TypeScript package for event emitter.
+
+## Table of contents
+
+- [Installation](#installation)
+- [Api](#api)
+  - Abstract
+    - [`EventEmitterBase`](#eventemitterbase)
+    - [`NamedEventEmitterBase`](#namedeventemitterbase)
+  - Concrete
+    - [`EventEmitter`](#eventemitter)
+    - [`NamedEventEmitter`](#namedeventemitter)
+- [Contributing](#contributing)
+- [Code of Conduct](code-of-conduct)
+- [Git](#git)
+  - [Commit](#commit)
+  - [Versioning](#versioning)
+- [License](#license)
+
+## Installation
+
+```bash
+npm install @typescript-package/event-emitter --save-peer
+```
+
+## Api
+
+```typescript
+import {
+  // Abstract.
+  EventEmitterBase,
+  NamedEventEmitterBase,
+  // Concrete.
+  EventEmitter,
+  NamedEventEmitter,
+} from '@typescript-package/event-emitter';
+```
+
+## Abstract
+
+### `EventEmitterBase`
+
+The base abstraction class for an event emitter pattern.
+
+```typescript
+import { EventEmitter } from '@typescript-package/event-emitter';
+```
+
+[`EventEmitterBase`](https://github.com/typescript-package/hooks/blob/main/src/lib/event-emitter.base.ts)
+
+### `NamedEventEmitterBase`
+
+A base abstraction class that implements a named event emitter pattern.
+
+```typescript
+import { NamedEventEmitterBase } from '@typescript-package/event-emitter';
+```
+
+[`NamedEventEmitterBase`](https://github.com/typescript-package/hooks/blob/main/src/lib/named-event-emitter.base.ts)
+
+## Concrete
+
+### `EventEmitter`
+
+A concrete class that implements an event emitter pattern.
+
+```typescript
+import { EventEmitter } from '@typescript-package/event-emitter';
+
+const eventEmitter = new EventEmitter({
+  // adapter: ListenersSetAdapter,
+  async: false
+});
+
+eventEmitter.on((msg) => console.log(`Received: ${msg}`));
+eventEmitter.emit('Hello, World!');
+
+```
+
+[`EventEmitter`](https://github.com/typescript-package/hooks/blob/main/src/lib/event-emitter.class.ts)
+
+### `NamedEventEmitter`
+
+A concrete class that implements a named event emitter pattern.
+
+```typescript
+import { NamedEventEmitter } from '@typescript-package/event-emitter';
+
+const eventEmitter = new NamedEventEmitter({async: false}, {
+  'event1': [(msg: string) => {
+    console.log(`Listener 1: ${msg}`);
+  }],
+  'event2': [(num: number) => {
+    console.log(`Event 2 received number: ${num}`);
+  }]
+});
+
+eventEmitter.clear('event1')
+eventEmitter.on('event1', (msg: string) => {
+  console.log(`Listener 2: ${msg}`);
+});
+
+eventEmitter.on('event2', (num: number) => {
+  console.log(`Event 2 received number: ${num}`);
+});
+
+eventEmitter.emit('event1', 'Hello, World!');
+eventEmitter.listeners('event1')?.forEach(listener => {
+  listener('Hello, World!');
+});
+```
+
+[`NamedEventEmitter`](https://github.com/typescript-package/hooks/blob/main/src/lib/named-event-emitter.class.ts)
+
+## Contributing
+
+Your contributions are valued! If you'd like to contribute, please feel free to submit a pull request. Help is always appreciated.
+
+## Support
+
+If you find this package useful and would like to support its and general development, you can contribute through one of the following payment methods. Your support helps maintain the packages and continue adding new.
+
+Support via:
+
+- [Stripe](https://donate.stripe.com/dR614hfDZcJE3wAcMM)
+- [Revolut](https://checkout.revolut.com/pay/048b10a3-0e10-42c8-a917-e3e9cb4c8e29)
+- [GitHub](https://github.com/sponsors/angular-package/sponsorships?sponsor=sciborrudnicki&tier_id=83618)
+- [DonorBox](https://donorbox.org/become-a-sponsor-to-the-angular-package?default_interval=o)
+- [Patreon](https://www.patreon.com/checkout/angularpackage?rid=0&fan_landing=true&view_as=public)
+
+or via Trust Wallet
+
+- [XLM](https://link.trustwallet.com/send?coin=148&address=GAFFFB7H3LG42O6JA63FJDRK4PP4JCNEOPHLGLLFH625X2KFYQ4UYVM4)
+- [USDT (BEP20)](https://link.trustwallet.com/send?coin=20000714&address=0xA0c22A2bc7E37C1d5992dFDFFeD5E6f9298E1b94&token_id=0x55d398326f99059fF775485246999027B3197955)
+- [ETH](https://link.trustwallet.com/send?coin=60&address=0xA0c22A2bc7E37C1d5992dFDFFeD5E6f9298E1b94)
+- [BTC](https://link.trustwallet.com/send?coin=0&address=bc1qnf709336tfl57ta5mfkf4t9fndhx7agxvv9svn)
+- [BNB](https://link.trustwallet.com/send?coin=20000714&address=0xA0c22A2bc7E37C1d5992dFDFFeD5E6f9298E1b94)
+
+Thanks for your support!
+
+## Code of Conduct
+
+By participating in this project, you agree to follow **[Code of Conduct](https://www.contributor-covenant.org/version/2/1/code_of_conduct/)**.
+
+## GIT
+
+### Commit
+
+Please follow the following commit message conventions:
+
+- [AngularJS Git Commit Message Conventions][git-commit-angular]
+- [Karma Git Commit Msg][git-commit-karma]
+- [Conventional Commits][git-commit-conventional]
+
+### Versioning
+
+The package follows [Semantic Versioning 2.0.0][git-semver] for all releases. The versioning format is:
+
+**Given a version number MAJOR.MINOR.PATCH, increment the:**
+
+- MAJOR version when you make incompatible API changes,
+- MINOR version when you add functionality in a backwards-compatible manner, and
+- PATCH version when you make backwards-compatible bug fixes.
+
+Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.
+
+**FAQ**
+How should I deal with revisions in the 0.y.z initial development phase?
+
+> The simplest thing to do is start your initial development release at 0.1.0 and then increment the minor version for each subsequent release.
+
+How do I know when to release 1.0.0?
+
+> If your software is being used in production, it should probably already be 1.0.0. If you have a stable API on which users have come to depend, you should be 1.0.0. If you’re worrying a lot about backwards compatibility, you should probably already be 1.0.0.
+
+## License
+
+MIT © typescript-package ([license][typescript-package-license])
+
+<!-- This package: typescript-package  -->
+  <!-- GitHub: badges -->
+  [typescript-package-badge-issues]: https://img.shields.io/github/issues/typescript-package/event-emitter
+  [isscript-package-badge-forks]: https://img.shields.io/github/forks/typescript-package/event-emitter
+  [typescript-package-badge-stars]: https://img.shields.io/github/stars/typescript-package/event-emitter
+  [typescript-package-badge-license]: https://img.shields.io/github/license/typescript-package/event-emitter
+  <!-- GitHub: badges links -->
+  [typescript-package-issues]: https://github.com/typescript-package/event-emitter/issues
+  [typescript-package-forks]: https://github.com/typescript-package/event-emitter/network
+  [typescript-package-license]: https://github.com/typescript-package/event-emitter/blob/master/LICENSE
+  [typescript-package-stars]: https://github.com/typescript-package/event-emitter/stargazers
+<!-- This package -->
+
+<!-- Package: typescript-package -->
+  <!-- npm -->
+  [typescript-package-npm-badge-svg]: https://badge.fury.io/js/@typescript-package%2Fevent-emitter.svg
+  [typescript-package-npm-badge]: https://badge.fury.io/js/@typescript-package%2Fevent-emitter
+
+<!-- GIT -->
+[git-semver]: http://semver.org/
+
+<!-- GIT: commit -->
+[git-commit-angular]: https://gist.github.com/stephenparish/9941e89d80e2bc58a153
+[git-commit-karma]: http://karma-runner.github.io/0.10/dev/git-commit-msg.html
+[git-commit-conventional]: https://www.conventionalcommits.org/en/v1.0.0/

package/fesm2022/typescript-package-event-emitter.mjs

@@ -0,0 +1,433 @@
+import { Listeners } from '@typescript-package/listeners';
+import { SetAdapter } from '@typescript-package/collection-adapter';
+
+// Class.
+/**
+ * @description The base abstraction class for an event emitter pattern.
+ * @export
+ * @abstract
+ * @class EventEmitterBase
+ * @template {ListenerFunction<any[]>} E The listener function type.
+ * @template [T=any] The type of the listeners underlying data.
+ * @template {boolean} [R=false] The async flag for the listeners.
+ * @template {ListenersAdapter<Parameters<E>, E, T, R>} [A=any] The adapter type for the listeners.
+ */
+class EventEmitterBase {
+    /**
+     * @description The adapter class used to manage listeners.
+     * @type {new (...listeners: E[]) => A}
+     */
+    #adapter;
+    /**
+     * @description Indicates whether the emitter listeners operate asynchronously.
+     * @type {R}
+     */
+    #async;
+    /**
+     * @description The map of events to their listeners.
+     * @type {Listeners<Parameters<E>, E, T, R, A>}
+     */
+    #listeners;
+    /**
+     * @description The paused state of the event emitter.
+     * @type {boolean}
+     */
+    #paused = false;
+    /**
+     * Creates an instance of `EventEmitterBase`.
+     * @constructor
+     * @param {{async?: R, value?: T}} param0 The object with configuration options.
+     * @param {R} param0.async Whether the emitter listeners operate asynchronously.
+     * @param {T} param0.value The underlying data for the listeners for capture its type only.
+     * @param {new (...listeners: E[]) => A} adapter The adapter class to manage listeners.
+     * @param {?(E | E[])} [events] The initial listeners.
+     */
+    constructor({ async, value }, adapter, events) {
+        this.#listeners = new Listeners(async ?? false, adapter, ...(Array.isArray(events) ? events : events ? [events] : []));
+        this.#adapter = adapter;
+        this.#async = async ?? false;
+    }
+    /**
+     * @description Removes all listeners for a specific event type.
+     * @public
+     * @returns {this} The current instance.
+     */
+    clear() {
+        return this.#listeners?.clear(), this;
+    }
+    /**
+     * @description Gets the number of listeners for a specific event.
+     * @public
+     * @returns {number} The number of listeners for the event.
+     */
+    count() {
+        return this.#listeners.size;
+    }
+    /**
+     * @description Emits an event, calling all listeners for that event type.
+     * @public
+     * @param {...Parameters<E>} args The arguments for the event listeners.
+     */
+    emit(...args) {
+        return !this.isPaused() && this.#listeners.forEach(listener => listener(...args)),
+            this;
+    }
+    /**
+     * @description Checks if the event is paused.
+     * @public
+     * @returns {boolean} Whether the event is paused.
+     */
+    isPaused() {
+        return this.#paused === true;
+    }
+    /**
+     * @description Gets the listeners for a specific event type.
+     * @public
+     * @returns {(ListenersFor<Event, E, T, R> | undefined)} The listeners for the event.
+     */
+    listeners() {
+        return this.#listeners;
+    }
+    /**
+     * @description Emits an event asynchronously, calling all listeners for that event type.
+     * @public
+     * @async
+     * @param {...Parameters<E>} args The arguments for the event listeners.
+     * @returns {this} The current instance.
+     */
+    async emitAsync(...args) {
+        const listeners = this.listeners();
+        if (!listeners || this.isPaused()) {
+            return this;
+        }
+        const snapshot = await listeners.snapshot();
+        await Promise.all(snapshot.map(listener => Promise.resolve(listener(...args))));
+        return this;
+    }
+    /**
+     * @description Adds a listener for event.
+     * @public
+     * @param {E} listener The listener function.
+     * @returns {this} The current instance.
+     */
+    on(listener) {
+        return this.#listeners.add(listener),
+            this;
+    }
+    /**
+     * @description Adds a one-time listener for event.
+     * @public
+     * @param {E} listener The listener function.
+     * @returns {this} The current instance.
+     */
+    once(listener) {
+        return this.#listeners.once(listener),
+            this;
+    }
+    /**
+     * @description Removes a listener for event.
+     * @public
+     * @param {E} listener The listener function.
+     * @returns {this} The current instance.
+     */
+    off(listener) {
+        return this.#listeners.delete(listener), this;
+    }
+    /**
+     * @description Pauses the event, preventing it from being emitted.
+     * @public
+     * @returns {this} The current instance.
+     */
+    pause() {
+        return this.#paused = true, this;
+    }
+    /**
+     * @description Resumes the event if it was paused.
+     * @public
+     * @returns {this} The current instance.
+     */
+    resume() {
+        return this.#paused = false, this;
+    }
+}
+
+// Class.
+/**
+ * @description A base abstraction class that implements a named event emitter pattern.
+ * @export
+ * @abstract
+ * @class NamedEventEmitterBase
+ * @template {Record<string, ListenerFunction<any[]>>} E Object mapping event names to their listener function types.
+ * @template [T=any] The type of the underlying data for the listeners.
+ * @template {boolean} [R=false] The `boolean` type of the async flag for the listeners.
+ * @template {ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], T, R>} [A=any] The adapter type for the listeners.
+ */
+class NamedEventEmitterBase {
+    /**
+     * @description The adapter class used to manage listeners.
+     * @type {new (...listeners: E[keyof E][]) => A}
+     */
+    #adapter;
+    /**
+     * @description Indicates whether the emitter listeners operate asynchronously.
+     * @type {R}
+     */
+    #async;
+    /**
+     * @description The map of events to their listeners.
+     * @type {Map<keyof E, Listeners<Parameters<E[keyof E]>, E[keyof E], T, R, A>>}
+     */
+    #events = new Map();
+    /**
+     * @description The set of names of paused events.
+     * @type {Set<keyof E>}
+     */
+    #pausedEvents = new Set();
+    /**
+     * Creates an instance of `NamedEventEmitterBase`.
+     * @constructor
+     * @param {{async?: R, value?: T}} param0
+     * @param {R} param0.async Whether the emitter listeners operate asynchronously.
+     * @param {T} param0.value The value underlying data for the listeners for capture its type only.
+     * @param {new (...listeners: E[keyof E][]) => A} adapter The adapter class to manage listeners.
+     * @param {?Partial<{ [K in keyof E]: E[K][] }>} [events] The initial events and their listeners.
+     */
+    constructor({ async, value }, adapter, events) {
+        this.#adapter = adapter;
+        this.#async = async ?? false;
+        for (const [event, listeners] of Object.entries(events ?? {})) {
+            this.#events.set(event, new Listeners(this.#async, this.#adapter));
+            for (const listener of listeners) {
+                this.#events.get(event).add(listener);
+            }
+        }
+    }
+    /**
+     * @description Removes all listeners for a specific event type.
+     * @public
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @returns {this} The current instance.
+     */
+    clear(event) {
+        return this.#events.get(event)?.clear(), this;
+    }
+    /**
+     * @description Removes all listeners for all event types.
+     * @public
+     * @returns {this} The current instance.
+     */
+    clearAll() {
+        return this.#events.clear(), this;
+    }
+    /**
+     * @description Gets the number of listeners for a specific event.
+     * @public
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @returns {number} The number of listeners for the event.
+     */
+    count(event) {
+        return this.#events.get(event)?.size ?? 0;
+    }
+    /**
+     * @description Emits an event, calling all listeners for that event type.
+     * @public
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @param {...Parameters<E[Event]>} args The arguments for the event listeners.
+     */
+    emit(event, ...args) {
+        return !this.isPaused(event) && this.#events.get(event)?.forEach(listener => listener(...args)),
+            this;
+    }
+    /**
+     * @description Gets all event names with registered listeners.
+     * @public
+     * @returns {(keyof E)[]} Array of event names.
+     */
+    eventNames() {
+        return Array.from(this.#events.keys());
+    }
+    /**
+     * @description Checks if the event is paused.
+     * @public
+     * @param {keyof E} event The event name of key.
+     * @returns {boolean} Whether the event is paused.
+     */
+    isPaused(event) {
+        return this.#pausedEvents.has(event);
+    }
+    /**
+     * @description Gets the listeners for a specific event type.
+     * @public
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @returns {(ListenersFor<Event, E, T, R> | undefined)} The listeners for the event.
+     */
+    listeners(event) {
+        return this.#events.get(event);
+    }
+    /**
+     * @description Emits an event asynchronously, calling all listeners for that event type.
+     * @public
+     * @async
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @param {...Parameters<E[Event]>} args The arguments for the event listeners.
+     * @returns {this} The current instance.
+     */
+    async emitAsync(event, ...args) {
+        const listeners = this.listeners(event);
+        if (!listeners || this.isPaused(event)) {
+            return this;
+        }
+        const snapshot = await listeners.snapshot();
+        await Promise.all(snapshot.map(listener => Promise.resolve(listener(...args))));
+        return this;
+    }
+    /**
+     * @description Adds a listener for a specific event type.
+     * @public
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @param {E[Event]} listener The listener function.
+     * @returns {this} The current instance.
+     */
+    on(event, listener) {
+        return !this.#events.has(event) && this.#events.set(event, new Listeners(this.#async, this.#adapter)),
+            this.#events.get(event).add(listener),
+            this;
+    }
+    /**
+     * @description Adds a listener for a specific event type.
+     * @public
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @param {E[Event]} listener The listener function.
+     * @returns {this} The current instance.
+     */
+    once(event, listener) {
+        return !this.#events.has(event) && this.#events.set(event, new Listeners(this.#async, this.#adapter)),
+            this.#events.get(event).once(listener),
+            this;
+    }
+    /**
+     * @description Removes a listener for a specific event type.
+     * @public
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @param {E[Event]} listener The listener function.
+     * @returns {this} The current instance.
+     */
+    off(event, listener) {
+        return this.#events.get(event)?.delete(listener), this;
+    }
+    /**
+     * @description Pauses the event, preventing it from being emitted.
+     * @public
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @returns {this} The current instance.
+     */
+    pause(event) {
+        return this.#pausedEvents.add(event), this;
+    }
+    /**
+     * @description Resumes the event if it was paused.
+     * @public
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @returns {this} The current instance.
+     */
+    resume(event) {
+        return this.#pausedEvents.delete(event), this;
+    }
+}
+
+class ListenersSetAdapter extends SetAdapter {
+    version = '1.0.0';
+    once(...listeners) {
+        listeners.forEach(listener => {
+            if (this.has(listener)) {
+                throw new Error('Listener already exists in the collection.');
+            }
+            const onceListener = (...args) => (this.delete(onceListener),
+                listener(...args));
+            this.add(onceListener);
+        });
+        return this;
+    }
+    snapshot() {
+        return Array.from(this.value);
+    }
+}
+
+// Abstract.
+/**
+ * @description A concrete class that implements an event emitter pattern.
+ * @export
+ * @class EventEmitter
+ * @template {ListenerFunction<any[]>} E The object type of events.
+ * @template [T=any] The type of the listeners underlying data.
+ * @template {boolean} [R=false] The async flag for the listeners.
+ * @template {ListenersAdapter<Parameters<E>, E, any, R >} [A=R extends false ? ListenersSetAdapter<E> : any] The adapter type for the listeners.
+ * @extends {EventEmitterBase<E, any, R, A>}Base class abstracting common event emitter functionality.
+ */
+class EventEmitter extends EventEmitterBase {
+    /**
+     * Creates an instance of `EventEmitter`.
+     * @constructor
+     * @param {R} async
+     * @param {?(E | E[])} [events]
+     * @param {new (...listeners: E[]) => A} [adapter=ListenersSetAdapter as any]
+     */
+    /**
+     * Creates an instance of `EventEmitter`.
+     * @constructor
+     * @param {{adapter?: new (...listeners: E[]) => A, async?: R, value?: T}} param0
+     * @param {new (...listeners: {}) => A} param0.adapter The adapter class to manage listeners.
+     * @param {R} param0.async Whether the emitter listeners operate asynchronously.
+     * @param {T} param0.value The underlying data for the listeners for capture its type only.
+     * @param {?(E | E[])} [events] The initial listeners.
+     */
+    constructor({ adapter, async, value }, events) {
+        super({ async, value }, adapter ?? ListenersSetAdapter, events);
+    }
+}
+
+// Abstract.
+/**
+ * @description A concrete class that implements a named event emitter pattern.
+ * @export
+ * @class NamedEventEmitter
+ * @template {Record<string, ListenerFunction<any[]>>} E Object mapping event names to their listener function types.
+ * @template {boolean} [R=false] The `boolean` type of the async flag for the listeners.
+ * @template {ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, R>} [A=R extends false ?  ListenersSetAdapter<E[keyof E]> : any]
+ * @extends {NamedEventEmitterBase<E, any, R, A>}
+ */
+class NamedEventEmitter extends NamedEventEmitterBase {
+    /**
+     * Creates an instance of `NamedEventEmitter`.
+     * @constructor
+     * @param {R} async Whether the emitter listeners operate asynchronously.
+     * @param {?Partial<{ [K in keyof E]: E[K][] }>} [events] The initial listeners.
+     * @param {new (...listeners: E[keyof E][]) => A} [adapter=ListenersSetAdapter as any] The adapter class to manage listeners.
+     */
+    constructor({ adapter, async, value }, events) {
+        super({ async }, adapter ?? ListenersSetAdapter, events);
+    }
+}
+
+// Abstract.
+
+/*
+ * Public API Surface of event-emitter
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { EventEmitter, EventEmitterBase, NamedEventEmitter, NamedEventEmitterBase };
+//# sourceMappingURL=typescript-package-event-emitter.mjs.map

package/fesm2022/typescript-package-event-emitter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-package-event-emitter.mjs","sources":["../../../package/event-emitter/src/lib/event-emitter.base.ts","../../../package/event-emitter/src/lib/named-event-emitter.base.ts","../../../package/event-emitter/src/adapter/lib/listeners-set.adapter.ts","../../../package/event-emitter/src/lib/event-emitter.class.ts","../../../package/event-emitter/src/lib/named-event-emitter.class.ts","../../../package/event-emitter/src/lib/index.ts","../../../package/event-emitter/src/public-api.ts","../../../package/event-emitter/src/typescript-package-event-emitter.ts"],"sourcesContent":["// Class.\nimport { Listeners } from \"@typescript-package/listeners\";\n// Type & Interface.\nimport { ListenersAdapter, ListenerFunction } from \"@typedly/listeners\";\n/**\n * @description The base abstraction class for an event emitter pattern.\n * @export\n * @abstract\n * @class EventEmitterBase\n * @template {ListenerFunction<any[]>} E The listener function type.\n * @template [T=any] The type of the listeners underlying data.\n * @template {boolean} [R=false] The async flag for the listeners.\n * @template {ListenersAdapter<Parameters<E>, E, T, R>} [A=any] The adapter type for the listeners.\n */\nexport abstract class EventEmitterBase<\n  E extends ListenerFunction<any[]>,\n  T = any,\n  R extends boolean = false,\n  A extends ListenersAdapter<Parameters<E>, E, T, R> = any\n> {\n  /**\n   * @description The adapter class used to manage listeners.\n   * @type {new (...listeners: E[]) => A}\n   */\n  #adapter: new (...listeners: E[]) => A;\n\n  /**\n   * @description Indicates whether the emitter listeners operate asynchronously.\n   * @type {R}\n   */\n  #async: R;\n\n  /**\n   * @description The map of events to their listeners.\n   * @type {Listeners<Parameters<E>, E, T, R, A>}\n   */\n  #listeners: Listeners<Parameters<E>, E, T, R, A>;\n\n  /**\n   * @description The paused state of the event emitter.\n   * @type {boolean}\n   */\n  #paused: boolean = false;\n\n  /**\n   * Creates an instance of `EventEmitterBase`.\n   * @constructor\n   * @param {{async?: R, value?: T}} param0 The object with configuration options.\n   * @param {R} param0.async Whether the emitter listeners operate asynchronously.\n   * @param {T} param0.value The underlying data for the listeners for capture its type only.\n   * @param {new (...listeners: E[]) => A} adapter The adapter class to manage listeners.\n   * @param {?(E | E[])} [events] The initial listeners.\n   */\n  constructor(\n    {async, value}: {async?: R, value?: T},\n    adapter: new (...listeners: E[]) => A,\n    events?: E | E[]\n  ) {\n    this.#listeners = new Listeners(async ?? false, adapter, ...(Array.isArray(events) ? events : events ? [events] : []));\n    this.#adapter = adapter;\n    this.#async = async ?? false as R;\n  }\n\n  /**\n   * @description Removes all listeners for a specific event type.\n   * @public\n   * @returns {this} The current instance.\n   */\n  public clear(): this {\n    return this.#listeners?.clear(), this;\n  }\n\n  /**\n   * @description Gets the number of listeners for a specific event.\n   * @public\n   * @returns {number} The number of listeners for the event.\n   */\n  public count(): number {\n    return this.#listeners.size;\n  }\n\n  /**\n   * @description Emits an event, calling all listeners for that event type.\n   * @public\n   * @param {...Parameters<E>} args The arguments for the event listeners.\n   */\n  public emit(...args: Parameters<E>): this {\n    return !this.isPaused() && this.#listeners.forEach(listener => listener(...args)),\n      this\n  }\n\n  /**\n   * @description Checks if the event is paused.\n   * @public\n   * @returns {boolean} Whether the event is paused.\n   */\n  public isPaused(): boolean {\n    return this.#paused === true;\n  }\n\n  /**\n   * @description Gets the listeners for a specific event type.\n   * @public\n   * @returns {(ListenersFor<Event, E, T, R> | undefined)} The listeners for the event.\n   */\n  public listeners(): Listeners<Parameters<E>, E, T, R, A> {\n    return this.#listeners;\n  }\n\n  /**\n   * @description Emits an event asynchronously, calling all listeners for that event type.\n   * @public\n   * @async\n   * @param {...Parameters<E>} args The arguments for the event listeners.\n   * @returns {this} The current instance.\n   */\n  public async emitAsync(...args: Parameters<E>): Promise<this> {\n    const listeners = this.listeners();\n    if (!listeners || this.isPaused()) {\n      return this;\n    }\n    const snapshot = await listeners.snapshot();\n    await Promise.all(snapshot.map(listener => Promise.resolve(listener(...args))));\n    return this;\n  }\n\n  /**\n   * @description Adds a listener for event.\n   * @public\n   * @param {E} listener The listener function.\n   * @returns {this} The current instance.\n   */\n  public on(listener: E): this {\n    return this.#listeners.add(listener),\n      this;\n  }\n\n  /**\n   * @description Adds a one-time listener for event.\n   * @public\n   * @param {E} listener The listener function.\n   * @returns {this} The current instance.\n   */\n  public once(listener: E): this {\n    return this.#listeners.once(listener),\n      this;\n  }\n\n  /**\n   * @description Removes a listener for event.\n   * @public\n   * @param {E} listener The listener function.\n   * @returns {this} The current instance.\n   */\n  public off(listener: E): this {\n    return this.#listeners.delete(listener), this;\n  }\n\n  /**\n   * @description Pauses the event, preventing it from being emitted.\n   * @public\n   * @returns {this} The current instance.\n   */\n  public pause(): this {\n    return this.#paused = true, this;\n  }\n\n  /**\n   * @description Resumes the event if it was paused.\n   * @public\n   * @returns {this} The current instance.\n   */\n  public resume(): this {\n    return this.#paused = false, this;\n  }\n}\n","// Class.\nimport { Listeners } from \"@typescript-package/listeners\";\n// Type & Interface.\nimport { ListenersAdapter, ListenerFunction } from \"@typedly/listeners\";\nimport { ListenersFor } from \"../type\";\n/**\n * @description A base abstraction class that implements a named event emitter pattern.\n * @export\n * @abstract\n * @class NamedEventEmitterBase\n * @template {Record<string, ListenerFunction<any[]>>} E Object mapping event names to their listener function types.\n * @template [T=any] The type of the underlying data for the listeners.\n * @template {boolean} [R=false] The `boolean` type of the async flag for the listeners.\n * @template {ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], T, R>} [A=any] The adapter type for the listeners.\n */\nexport abstract class NamedEventEmitterBase<\n  E extends Record<string, ListenerFunction<any[]>>,\n  T = any,\n  R extends boolean = false,\n  A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], T, R> = any\n> {\n  /**\n   * @description The adapter class used to manage listeners.\n   * @type {new (...listeners: E[keyof E][]) => A}\n   */\n  #adapter: new (...listeners: E[keyof E][]) => A;\n\n  /**\n   * @description Indicates whether the emitter listeners operate asynchronously.\n   * @type {R}\n   */\n  #async: R;\n\n  /**\n   * @description The map of events to their listeners.\n   * @type {Map<keyof E, Listeners<Parameters<E[keyof E]>, E[keyof E], T, R, A>>}\n   */\n  #events: Map<keyof E, Listeners<Parameters<E[keyof E]>, E[keyof E], T, R, A>> = new Map();\n\n  /**\n   * @description The set of names of paused events.\n   * @type {Set<keyof E>}\n   */\n  #pausedEvents: Set<keyof E> = new Set();\n\n  /**\n   * Creates an instance of `NamedEventEmitterBase`.\n   * @constructor\n   * @param {{async?: R, value?: T}} param0 \n   * @param {R} param0.async Whether the emitter listeners operate asynchronously.\n   * @param {T} param0.value The value underlying data for the listeners for capture its type only.\n   * @param {new (...listeners: E[keyof E][]) => A} adapter The adapter class to manage listeners.\n   * @param {?Partial<{ [K in keyof E]: E[K][] }>} [events] The initial events and their listeners.\n   */\n  constructor(\n    {async, value}: {async?: R, value?: T},\n    adapter: new (...listeners: E[keyof E][]) => A,\n    events?: Partial<{ [K in keyof E]: E[K][] }>\n  ) {\n    this.#adapter = adapter;\n    this.#async = async ?? false as R;\n    for (const [event, listeners] of Object.entries(events ?? {})) {\n      this.#events.set(event as keyof E, new Listeners(this.#async, this.#adapter));\n      for (const listener of listeners!) {\n        this.#events.get(event as keyof E)!.add(listener);\n      }\n    }\n  }\n\n  /**\n   * @description Removes all listeners for a specific event type.\n   * @public\n   * @template {keyof E} Event The event key.\n   * @param {Event} event The event name of key.\n   * @returns {this} The current instance.\n   */\n  public clear<Event extends keyof E>(event: Event): this {\n    return this.#events.get(event)?.clear(), this;\n  }\n\n  /**\n   * @description Removes all listeners for all event types.\n   * @public\n   * @returns {this} The current instance.\n   */\n  public clearAll(): this {\n    return this.#events.clear(), this;\n  }\n\n  /**\n   * @description Gets the number of listeners for a specific event.\n   * @public\n   * @template {keyof E} Event The event key.\n   * @param {Event} event The event name of key.\n   * @returns {number} The number of listeners for the event.\n   */\n  public count<Event extends keyof E>(event: Event): number {\n    return this.#events.get(event)?.size ?? 0;\n  }\n\n  /**\n   * @description Emits an event, calling all listeners for that event type.\n   * @public\n   * @template {keyof E} Event The event key.\n   * @param {Event} event The event name of key.\n   * @param {...Parameters<E[Event]>} args The arguments for the event listeners.\n   */\n  public emit<Event extends keyof E>(event: Event, ...args: Parameters<E[Event]>): this {\n    return !this.isPaused(event) && this.#events.get(event)?.forEach(listener => listener(...args)),\n      this\n  }\n\n  /**\n   * @description Gets all event names with registered listeners.\n   * @public\n   * @returns {(keyof E)[]} Array of event names.\n   */\n  public eventNames(): (keyof E)[] {\n    return Array.from(this.#events.keys());\n  }\n\n  /**\n   * @description Checks if the event is paused.\n   * @public\n   * @param {keyof E} event The event name of key.\n   * @returns {boolean} Whether the event is paused.\n   */\n  public isPaused(event: keyof E): boolean {\n    return this.#pausedEvents.has(event);\n  }\n\n  /**\n   * @description Gets the listeners for a specific event type.\n   * @public\n   * @template {keyof E} Event The event key.\n   * @param {Event} event The event name of key.\n   * @returns {(ListenersFor<Event, E, T, R> | undefined)} The listeners for the event.\n   */\n  public listeners<Event extends keyof E>(event: Event): ListenersFor<Event, E, T, R> | undefined {\n    return this.#events.get(event) as any;\n  }\n\n  /**\n   * @description Emits an event asynchronously, calling all listeners for that event type.\n   * @public\n   * @async\n   * @template {keyof E} Event The event key.\n   * @param {Event} event The event name of key.\n   * @param {...Parameters<E[Event]>} args The arguments for the event listeners.\n   * @returns {this} The current instance.\n   */\n  public async emitAsync<Event extends keyof E>(event: Event, ...args: Parameters<E[Event]>): Promise<this> {\n    const listeners = this.listeners(event);\n    if (!listeners || this.isPaused(event)) {\n      return this;\n    }\n    const snapshot = await listeners.snapshot();\n    await Promise.all(snapshot.map(listener => Promise.resolve(listener(...args))));\n    return this;\n  }\n\n  /**\n   * @description Adds a listener for a specific event type.\n   * @public\n   * @template {keyof E} Event The event key.\n   * @param {Event} event The event name of key.\n   * @param {E[Event]} listener The listener function.\n   * @returns {this} The current instance.\n   */\n  public on<Event extends keyof E>(event: Event, listener: E[Event]): this {\n    return !this.#events.has(event) && this.#events.set(event, new Listeners(this.#async, this.#adapter)),\n      this.#events.get(event)!.add(listener),\n      this;\n  }\n\n  /**\n   * @description Adds a listener for a specific event type.\n   * @public\n   * @template {keyof E} Event The event key.\n   * @param {Event} event The event name of key.\n   * @param {E[Event]} listener The listener function.\n   * @returns {this} The current instance.\n   */\n  public once<Event extends keyof E>(event: Event, listener: E[Event]): this {\n    return !this.#events.has(event) && this.#events.set(event, new Listeners(this.#async, this.#adapter)),\n      this.#events.get(event)!.once(listener),\n      this;\n  }\n\n  /**\n   * @description Removes a listener for a specific event type.\n   * @public\n   * @template {keyof E} Event The event key.\n   * @param {Event} event The event name of key.\n   * @param {E[Event]} listener The listener function.\n   * @returns {this} The current instance.\n   */\n  public off<Event extends keyof E>(event: Event, listener: E[Event]): this {\n    return this.#events.get(event)?.delete(listener), this;\n  }\n\n  /**\n   * @description Pauses the event, preventing it from being emitted.\n   * @public\n   * @template {keyof E} Event The event key.\n   * @param {Event} event The event name of key.\n   * @returns {this} The current instance.\n   */\n  public pause<Event extends keyof E>(event: Event): this {\n    return this.#pausedEvents.add(event), this;\n  }\n\n  /**\n   * @description Resumes the event if it was paused.\n   * @public\n   * @template {keyof E} Event The event key.\n   * @param {Event} event The event name of key.\n   * @returns {this} The current instance.\n   */\n  public resume<Event extends keyof E>(event: Event): this {\n    return this.#pausedEvents.delete(event), this;\n  }\n}\n","import { ListenerFunction } from \"@typedly/listeners\";\nimport { SetAdapter } from \"@typescript-package/collection-adapter\";\n\nexport class ListenersSetAdapter<L extends ListenerFunction<any[]>> extends SetAdapter<L> {\n  public override version: string = '1.0.0';\n  public once(...listeners: L[]): this {\n    listeners.forEach(listener => {\n      if (this.has(listener)) {\n        throw new Error('Listener already exists in the collection.');\n      }\n\n      const onceListener = (...args: any[]) => (\n        this.delete(onceListener as L),\n        listener(...args)\n      );\n\n      this.add(onceListener as L)\n\n    });\n    return this;\n  }\n\n  public snapshot(): L[] {\n    return Array.from(this.value);\n  }\n}","// Abstract.\nimport { EventEmitterBase } from \"./event-emitter.base\";\n// Class.\nimport { ListenersSetAdapter } from \"../adapter\";\n// Type & Interface.\nimport { ListenersAdapter, ListenerFunction } from \"@typedly/listeners\";\n/**\n * @description A concrete class that implements an event emitter pattern.\n * @export\n * @class EventEmitter\n * @template {ListenerFunction<any[]>} E The object type of events.\n * @template [T=any] The type of the listeners underlying data.\n * @template {boolean} [R=false] The async flag for the listeners.\n * @template {ListenersAdapter<Parameters<E>, E, any, R >} [A=R extends false ? ListenersSetAdapter<E> : any] The adapter type for the listeners.\n * @extends {EventEmitterBase<E, any, R, A>}Base class abstracting common event emitter functionality.\n */\nexport class EventEmitter<\n  E extends ListenerFunction<any[]>,\n  T = any,\n  R extends boolean = false,\n  A extends ListenersAdapter<Parameters<E>, E, T, R > = R extends false ? ListenersSetAdapter<E> : any\n> extends EventEmitterBase<E, T, R, A> {\n  /**\n   * Creates an instance of `EventEmitter`.\n   * @constructor\n   * @param {R} async \n   * @param {?(E | E[])} [events] \n   * @param {new (...listeners: E[]) => A} [adapter=ListenersSetAdapter as any] \n   */\n  \n  /**\n   * Creates an instance of `EventEmitter`.\n   * @constructor\n   * @param {{adapter?: new (...listeners: E[]) => A, async?: R, value?: T}} param0 \n   * @param {new (...listeners: {}) => A} param0.adapter The adapter class to manage listeners.\n   * @param {R} param0.async Whether the emitter listeners operate asynchronously.\n   * @param {T} param0.value The underlying data for the listeners for capture its type only.\n   * @param {?(E | E[])} [events] The initial listeners.\n   */\n  constructor(\n    {adapter, async, value}: {adapter?: new (...listeners: E[]) => A, async?: R, value?: T},\n    events?: E | E[],\n  ) {\n    super({async, value}, adapter ?? ListenersSetAdapter as any, events);\n  }\n}\n","// Abstract.\nimport { NamedEventEmitterBase } from \"./named-event-emitter.base\";\n// Class.\nimport { ListenersSetAdapter } from \"../adapter\";\n// Type & Interface.\nimport { ListenersAdapter, ListenerFunction } from \"@typedly/listeners\";\n/**\n * @description A concrete class that implements a named event emitter pattern.\n * @export\n * @class NamedEventEmitter\n * @template {Record<string, ListenerFunction<any[]>>} E Object mapping event names to their listener function types.\n * @template {boolean} [R=false] The `boolean` type of the async flag for the listeners.\n * @template {ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, R>} [A=R extends false ?  ListenersSetAdapter<E[keyof E]> : any] \n * @extends {NamedEventEmitterBase<E, any, R, A>}\n */\nexport class NamedEventEmitter<\n  E extends Record<string, ListenerFunction<any[]>>,\n  T = any,\n  R extends boolean = false,\n  A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], T, R> = R extends false ?  ListenersSetAdapter<E[keyof E]> : any\n> extends NamedEventEmitterBase<E, T, R, A> {\n  /**\n   * Creates an instance of `NamedEventEmitter`.\n   * @constructor\n   * @param {R} async Whether the emitter listeners operate asynchronously.\n   * @param {?Partial<{ [K in keyof E]: E[K][] }>} [events] The initial listeners.\n   * @param {new (...listeners: E[keyof E][]) => A} [adapter=ListenersSetAdapter as any] The adapter class to manage listeners.\n   */\n  constructor(\n    {adapter, async, value}: {adapter?: new (...listeners: E[keyof E][]) => A, async?: R, value?: T},\n    events?: Partial<{ [K in keyof E]: E[K][] }>,\n  ) {\n    super({async}, adapter ?? ListenersSetAdapter as any, events);\n  }\n}\n","// Abstract.\nexport { EventEmitterBase } from './event-emitter.base';\nexport { NamedEventEmitterBase } from './named-event-emitter.base';\n// Concrete.\nexport { EventEmitter } from './event-emitter.class';\nexport { NamedEventEmitter } from './named-event-emitter.class';\n","/*\n * Public API Surface of event-emitter\n */\n\nexport {\n  // Abstract.\n  EventEmitterBase,\n  NamedEventEmitterBase,\n  // Concrete.\n  EventEmitter,\n  NamedEventEmitter\n} from './lib';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@typescript-package/event-emitter",
+  "version": "0.1.0",
+  "author": "wwwdev.io <dev@wwwdev.io>",
+  "description": "A lightweight TypeScript package for event emitter.",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "peerDependencies": {
+    "@typescript-package/collection-adapter": "^0.2.0",
+    "@typescript-package/listeners": "^0.0.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/typescript-package/event-emitter.git"
+  },
+  "bugs": {
+    "url": "https://github.com/typescript-package/event-emitter/issues"
+  },
+  "keywords": [
+    "@typescript-package",
+    "@typescript-package/event-emitter",
+    "EventEmitter",
+    "Listeners"
+  ],
+  "funding": [
+    {
+      "type": "stripe",
+      "url": "https://donate.stripe.com/dR614hfDZcJE3wAcMM"
+    },
+    {
+      "type": "individual",
+      "url": "https://checkout.revolut.com/pay/048b10a3-0e10-42c8-a917-e3e9cb4c8e29"
+    }
+  ],
+  "sideEffects": false,
+  "module": "fesm2022/typescript-package-event-emitter.mjs",
+  "typings": "types/typescript-package-event-emitter.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/typescript-package-event-emitter.d.ts",
+      "default": "./fesm2022/typescript-package-event-emitter.mjs"
+    }
+  }
+}

package/types/typescript-package-event-emitter.d.ts

@@ -0,0 +1,312 @@
+import { Listeners } from '@typescript-package/listeners';
+import { ListenerFunction, ListenersAdapter } from '@typedly/listeners';
+import { SetAdapter } from '@typescript-package/collection-adapter';
+
+/**
+ * @description The base abstraction class for an event emitter pattern.
+ * @export
+ * @abstract
+ * @class EventEmitterBase
+ * @template {ListenerFunction<any[]>} E The listener function type.
+ * @template [T=any] The type of the listeners underlying data.
+ * @template {boolean} [R=false] The async flag for the listeners.
+ * @template {ListenersAdapter<Parameters<E>, E, T, R>} [A=any] The adapter type for the listeners.
+ */
+declare abstract class EventEmitterBase<E extends ListenerFunction<any[]>, T = any, R extends boolean = false, A extends ListenersAdapter<Parameters<E>, E, T, R> = any> {
+    #private;
+    /**
+     * Creates an instance of `EventEmitterBase`.
+     * @constructor
+     * @param {{async?: R, value?: T}} param0 The object with configuration options.
+     * @param {R} param0.async Whether the emitter listeners operate asynchronously.
+     * @param {T} param0.value The underlying data for the listeners for capture its type only.
+     * @param {new (...listeners: E[]) => A} adapter The adapter class to manage listeners.
+     * @param {?(E | E[])} [events] The initial listeners.
+     */
+    constructor({ async, value }: {
+        async?: R;
+        value?: T;
+    }, adapter: new (...listeners: E[]) => A, events?: E | E[]);
+    /**
+     * @description Removes all listeners for a specific event type.
+     * @public
+     * @returns {this} The current instance.
+     */
+    clear(): this;
+    /**
+     * @description Gets the number of listeners for a specific event.
+     * @public
+     * @returns {number} The number of listeners for the event.
+     */
+    count(): number;
+    /**
+     * @description Emits an event, calling all listeners for that event type.
+     * @public
+     * @param {...Parameters<E>} args The arguments for the event listeners.
+     */
+    emit(...args: Parameters<E>): this;
+    /**
+     * @description Checks if the event is paused.
+     * @public
+     * @returns {boolean} Whether the event is paused.
+     */
+    isPaused(): boolean;
+    /**
+     * @description Gets the listeners for a specific event type.
+     * @public
+     * @returns {(ListenersFor<Event, E, T, R> | undefined)} The listeners for the event.
+     */
+    listeners(): Listeners<Parameters<E>, E, T, R, A>;
+    /**
+     * @description Emits an event asynchronously, calling all listeners for that event type.
+     * @public
+     * @async
+     * @param {...Parameters<E>} args The arguments for the event listeners.
+     * @returns {this} The current instance.
+     */
+    emitAsync(...args: Parameters<E>): Promise<this>;
+    /**
+     * @description Adds a listener for event.
+     * @public
+     * @param {E} listener The listener function.
+     * @returns {this} The current instance.
+     */
+    on(listener: E): this;
+    /**
+     * @description Adds a one-time listener for event.
+     * @public
+     * @param {E} listener The listener function.
+     * @returns {this} The current instance.
+     */
+    once(listener: E): this;
+    /**
+     * @description Removes a listener for event.
+     * @public
+     * @param {E} listener The listener function.
+     * @returns {this} The current instance.
+     */
+    off(listener: E): this;
+    /**
+     * @description Pauses the event, preventing it from being emitted.
+     * @public
+     * @returns {this} The current instance.
+     */
+    pause(): this;
+    /**
+     * @description Resumes the event if it was paused.
+     * @public
+     * @returns {this} The current instance.
+     */
+    resume(): this;
+}
+
+/**
+ * @description
+ * @export
+ * @template {keyof E} Event
+ * @template {Record<string, ListenerFunction<any[]>>} E
+ * @template [T=any]
+ * @template {boolean} [R=false]
+ */
+type ListenersFor<Event extends keyof E, E extends Record<string, ListenerFunction<any[]>>, T = any, R extends boolean = false> = Listeners<Parameters<E[Event]>, E[Event], T, R, ListenersAdapter<Parameters<E[Event]>, E[Event], T, R>>;
+
+/**
+ * @description A base abstraction class that implements a named event emitter pattern.
+ * @export
+ * @abstract
+ * @class NamedEventEmitterBase
+ * @template {Record<string, ListenerFunction<any[]>>} E Object mapping event names to their listener function types.
+ * @template [T=any] The type of the underlying data for the listeners.
+ * @template {boolean} [R=false] The `boolean` type of the async flag for the listeners.
+ * @template {ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], T, R>} [A=any] The adapter type for the listeners.
+ */
+declare abstract class NamedEventEmitterBase<E extends Record<string, ListenerFunction<any[]>>, T = any, R extends boolean = false, A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], T, R> = any> {
+    #private;
+    /**
+     * Creates an instance of `NamedEventEmitterBase`.
+     * @constructor
+     * @param {{async?: R, value?: T}} param0
+     * @param {R} param0.async Whether the emitter listeners operate asynchronously.
+     * @param {T} param0.value The value underlying data for the listeners for capture its type only.
+     * @param {new (...listeners: E[keyof E][]) => A} adapter The adapter class to manage listeners.
+     * @param {?Partial<{ [K in keyof E]: E[K][] }>} [events] The initial events and their listeners.
+     */
+    constructor({ async, value }: {
+        async?: R;
+        value?: T;
+    }, adapter: new (...listeners: E[keyof E][]) => A, events?: Partial<{
+        [K in keyof E]: E[K][];
+    }>);
+    /**
+     * @description Removes all listeners for a specific event type.
+     * @public
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @returns {this} The current instance.
+     */
+    clear<Event extends keyof E>(event: Event): this;
+    /**
+     * @description Removes all listeners for all event types.
+     * @public
+     * @returns {this} The current instance.
+     */
+    clearAll(): this;
+    /**
+     * @description Gets the number of listeners for a specific event.
+     * @public
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @returns {number} The number of listeners for the event.
+     */
+    count<Event extends keyof E>(event: Event): number;
+    /**
+     * @description Emits an event, calling all listeners for that event type.
+     * @public
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @param {...Parameters<E[Event]>} args The arguments for the event listeners.
+     */
+    emit<Event extends keyof E>(event: Event, ...args: Parameters<E[Event]>): this;
+    /**
+     * @description Gets all event names with registered listeners.
+     * @public
+     * @returns {(keyof E)[]} Array of event names.
+     */
+    eventNames(): (keyof E)[];
+    /**
+     * @description Checks if the event is paused.
+     * @public
+     * @param {keyof E} event The event name of key.
+     * @returns {boolean} Whether the event is paused.
+     */
+    isPaused(event: keyof E): boolean;
+    /**
+     * @description Gets the listeners for a specific event type.
+     * @public
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @returns {(ListenersFor<Event, E, T, R> | undefined)} The listeners for the event.
+     */
+    listeners<Event extends keyof E>(event: Event): ListenersFor<Event, E, T, R> | undefined;
+    /**
+     * @description Emits an event asynchronously, calling all listeners for that event type.
+     * @public
+     * @async
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @param {...Parameters<E[Event]>} args The arguments for the event listeners.
+     * @returns {this} The current instance.
+     */
+    emitAsync<Event extends keyof E>(event: Event, ...args: Parameters<E[Event]>): Promise<this>;
+    /**
+     * @description Adds a listener for a specific event type.
+     * @public
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @param {E[Event]} listener The listener function.
+     * @returns {this} The current instance.
+     */
+    on<Event extends keyof E>(event: Event, listener: E[Event]): this;
+    /**
+     * @description Adds a listener for a specific event type.
+     * @public
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @param {E[Event]} listener The listener function.
+     * @returns {this} The current instance.
+     */
+    once<Event extends keyof E>(event: Event, listener: E[Event]): this;
+    /**
+     * @description Removes a listener for a specific event type.
+     * @public
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @param {E[Event]} listener The listener function.
+     * @returns {this} The current instance.
+     */
+    off<Event extends keyof E>(event: Event, listener: E[Event]): this;
+    /**
+     * @description Pauses the event, preventing it from being emitted.
+     * @public
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @returns {this} The current instance.
+     */
+    pause<Event extends keyof E>(event: Event): this;
+    /**
+     * @description Resumes the event if it was paused.
+     * @public
+     * @template {keyof E} Event The event key.
+     * @param {Event} event The event name of key.
+     * @returns {this} The current instance.
+     */
+    resume<Event extends keyof E>(event: Event): this;
+}
+
+declare class ListenersSetAdapter<L extends ListenerFunction<any[]>> extends SetAdapter<L> {
+    version: string;
+    once(...listeners: L[]): this;
+    snapshot(): L[];
+}
+
+/**
+ * @description A concrete class that implements an event emitter pattern.
+ * @export
+ * @class EventEmitter
+ * @template {ListenerFunction<any[]>} E The object type of events.
+ * @template [T=any] The type of the listeners underlying data.
+ * @template {boolean} [R=false] The async flag for the listeners.
+ * @template {ListenersAdapter<Parameters<E>, E, any, R >} [A=R extends false ? ListenersSetAdapter<E> : any] The adapter type for the listeners.
+ * @extends {EventEmitterBase<E, any, R, A>}Base class abstracting common event emitter functionality.
+ */
+declare class EventEmitter<E extends ListenerFunction<any[]>, T = any, R extends boolean = false, A extends ListenersAdapter<Parameters<E>, E, T, R> = R extends false ? ListenersSetAdapter<E> : any> extends EventEmitterBase<E, T, R, A> {
+    /**
+     * Creates an instance of `EventEmitter`.
+     * @constructor
+     * @param {R} async
+     * @param {?(E | E[])} [events]
+     * @param {new (...listeners: E[]) => A} [adapter=ListenersSetAdapter as any]
+     */
+    /**
+     * Creates an instance of `EventEmitter`.
+     * @constructor
+     * @param {{adapter?: new (...listeners: E[]) => A, async?: R, value?: T}} param0
+     * @param {new (...listeners: {}) => A} param0.adapter The adapter class to manage listeners.
+     * @param {R} param0.async Whether the emitter listeners operate asynchronously.
+     * @param {T} param0.value The underlying data for the listeners for capture its type only.
+     * @param {?(E | E[])} [events] The initial listeners.
+     */
+    constructor({ adapter, async, value }: {
+        adapter?: new (...listeners: E[]) => A;
+        async?: R;
+        value?: T;
+    }, events?: E | E[]);
+}
+
+/**
+ * @description A concrete class that implements a named event emitter pattern.
+ * @export
+ * @class NamedEventEmitter
+ * @template {Record<string, ListenerFunction<any[]>>} E Object mapping event names to their listener function types.
+ * @template {boolean} [R=false] The `boolean` type of the async flag for the listeners.
+ * @template {ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, R>} [A=R extends false ?  ListenersSetAdapter<E[keyof E]> : any]
+ * @extends {NamedEventEmitterBase<E, any, R, A>}
+ */
+declare class NamedEventEmitter<E extends Record<string, ListenerFunction<any[]>>, T = any, R extends boolean = false, A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], T, R> = R extends false ? ListenersSetAdapter<E[keyof E]> : any> extends NamedEventEmitterBase<E, T, R, A> {
+    /**
+     * Creates an instance of `NamedEventEmitter`.
+     * @constructor
+     * @param {R} async Whether the emitter listeners operate asynchronously.
+     * @param {?Partial<{ [K in keyof E]: E[K][] }>} [events] The initial listeners.
+     * @param {new (...listeners: E[keyof E][]) => A} [adapter=ListenersSetAdapter as any] The adapter class to manage listeners.
+     */
+    constructor({ adapter, async, value }: {
+        adapter?: new (...listeners: E[keyof E][]) => A;
+        async?: R;
+        value?: T;
+    }, events?: Partial<{
+        [K in keyof E]: E[K][];
+    }>);
+}
+
+export { EventEmitter, EventEmitterBase, NamedEventEmitter, NamedEventEmitterBase };