npm - @typescript-package/event-emitter - Versions diffs - 0.1.0 → 1.0.0 - Mend

@typescript-package/event-emitter 0.1.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/README.md +44 -17
package/fesm2022/typescript-package-event-emitter.mjs +96 -95
package/fesm2022/typescript-package-event-emitter.mjs.map +1 -1
package/package.json +23 -3
package/types/typescript-package-event-emitter.d.ts +86 -83

package/README.md CHANGED Viewed

@@ -26,6 +26,9 @@ A **lightweight** TypeScript package for event emitter.
   - Concrete
     - [`EventEmitter`](#eventemitter)
     - [`NamedEventEmitter`](#namedeventemitter)
+  - Type
+    - [`EventListeners`](#eventlisteners)
+    - [`ListenersFor`](#listenersfor)
 - [Contributing](#contributing)
 - [Code of Conduct](code-of-conduct)
 - [Git](#git)
@@ -52,33 +55,33 @@ import {
 } from '@typescript-package/event-emitter';
 ```
-## Abstract
+### Abstract
 ### `EventEmitterBase`
-The base abstraction class for an event emitter pattern.
+The base abstraction class for an event emitter pattern with replaceable listeners adapter and asynchronous capabilities.
 ```typescript
 import { EventEmitter } from '@typescript-package/event-emitter';
 ```
-[`EventEmitterBase`](https://github.com/typescript-package/hooks/blob/main/src/lib/event-emitter.base.ts)
+[`EventEmitterBase`](https://github.com/typescript-package/event-emitter/blob/main/src/lib/event-emitter.base.ts)
 ### `NamedEventEmitterBase`
-A base abstraction class that implements a named event emitter pattern.
+A base abstraction class that implements a named event emitter pattern with replaceable listeners adapter and asynchronous capabilities.
 ```typescript
 import { NamedEventEmitterBase } from '@typescript-package/event-emitter';
 ```
-[`NamedEventEmitterBase`](https://github.com/typescript-package/hooks/blob/main/src/lib/named-event-emitter.base.ts)
+[`NamedEventEmitterBase`](https://github.com/typescript-package/event-emitter/blob/main/src/lib/named-event-emitter.base.ts)
-## Concrete
+### Concrete
 ### `EventEmitter`
-A concrete class that implements an event emitter pattern.
+A concrete class for an event emitter pattern with replaceable listeners adapter and asynchronous capabilities.
 ```typescript
 import { EventEmitter } from '@typescript-package/event-emitter';
@@ -93,11 +96,11 @@ eventEmitter.emit('Hello, World!');
 ```
-[`EventEmitter`](https://github.com/typescript-package/hooks/blob/main/src/lib/event-emitter.class.ts)
+[`EventEmitter`](https://github.com/typescript-package/event-emitter/blob/main/src/lib/event-emitter.class.ts)
 ### `NamedEventEmitter`
-A concrete class that implements a named event emitter pattern.
+A concrete class that implements a named event emitter pattern with replaceable listeners adapter and asynchronous capabilities.
 ```typescript
 import { NamedEventEmitter } from '@typescript-package/event-emitter';
@@ -126,7 +129,27 @@ eventEmitter.listeners('event1')?.forEach(listener => {
 });
 ```
-[`NamedEventEmitter`](https://github.com/typescript-package/hooks/blob/main/src/lib/named-event-emitter.class.ts)
+[`NamedEventEmitter`](https://github.com/typescript-package/event-emitter/blob/main/src/lib/named-event-emitter.class.ts)
+### Type
+### `EventListeners`
+A type representing a partial mapping of event names to their listener arrays.
+```typescript
+import { EventListeners } from '@typescript-package/event-emitter';
+```
+### `ListenersFor`
+A type representing the listeners for a specific event in a named event emitter, utilizing a specified listeners adapter and supporting asynchronous capabilities.
+```typescript
+import { EventListeners } from '@typescript-package/event-emitter';
+```
+[`EventListeners`](https://github.com/typescript-package/event-emitter/blob/main/src/type/listeners-for.type.ts)
 ## Contributing
@@ -138,19 +161,23 @@ If you find this package useful and would like to support its and general develo
 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)
+- [4Fund](https://4fund.com/bruubs)
 - [DonorBox](https://donorbox.org/become-a-sponsor-to-the-angular-package?default_interval=o)
+- [GitHub](https://github.com/sponsors/angular-package/sponsorships?sponsor=sciborrudnicki&tier_id=83618)
+- [Ko-fi](https://ko-fi.com/sterblack)
+- [OpenCollective](https://opencollective.com/sterblack)
 - [Patreon](https://www.patreon.com/checkout/angularpackage?rid=0&fan_landing=true&view_as=public)
+- [PayPal](https://paypal.me/sterblack)
+- [Stripe](https://donate.stripe.com/dR614hfDZcJE3wAcMM)
+- ~~[Revolut](https://checkout.revolut.com/pay/048b10a3-0e10-42c8-a917-e3e9cb4c8e29)~~
 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)
+- [BTC](https://link.trustwallet.com/send?coin=0&address=bc1qnf709336tfl57ta5mfkf4t9fndhx7agxvv9svn)
+- [ETH](https://link.trustwallet.com/send?coin=60&address=0xA0c22A2bc7E37C1d5992dFDFFeD5E6f9298E1b94)
+- [USDT (BEP20)](https://link.trustwallet.com/send?coin=20000714&address=0xA0c22A2bc7E37C1d5992dFDFFeD5E6f9298E1b94&token_id=0x55d398326f99059fF775485246999027B3197955)
+- [XLM](https://link.trustwallet.com/send?coin=148&address=GAFFFB7H3LG42O6JA63FJDRK4PP4JCNEOPHLGLLFH625X2KFYQ4UYVM4)
 Thanks for your support!

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

@@ -1,31 +1,70 @@
-import { Listeners } from '@typescript-package/listeners';
 import { SetAdapter } from '@typescript-package/collection-adapter';
+import { Listeners } from '@typescript-package/listeners';
+class ListenersSetAdapter extends SetAdapter {
+    version = '1.0.0';
+    once(...listeners) {
+        listeners.forEach(listener => {
+            if (super.has(listener)) {
+                throw new Error('Listener already exists in the collection.');
+            }
+            const onceListener = (...args) => (super.delete(onceListener),
+                listener(...args));
+            super.add(onceListener);
+        });
+        return this;
+    }
+    snapshot() {
+        return Array.from(this.value);
+    }
+}
 // Class.
 /**
- * @description The base abstraction class for an event emitter pattern.
+ * @description The base abstraction class for an event emitter pattern with replaceable listeners adapter and asynchronous capabilities.
  * @export
  * @abstract
  * @class EventEmitterBase
- * @template {ListenerFunction<any[]>} E The listener function type.
+ * @template {ListenerFunction<any[]>} L 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.
+ * @template {ListenersAdapter<Parameters<L>, L, T, R>} [A=ListenersAdapter<Parameters<L>, L, T, R>] The adapter type for the listeners.
  */
 class EventEmitterBase {
     /**
-     * @description The adapter class used to manage listeners.
-     * @type {new (...listeners: E[]) => A}
+     * @description Gets the async flag for the listeners.
+     * @public
+     * @readonly
+     * @type {R}
      */
-    #adapter;
+    get async() {
+        return this.#listeners.async;
+    }
     /**
-     * @description Indicates whether the emitter listeners operate asynchronously.
-     * @type {R}
+     * @description Gets the listeners for a specific event type.
+     * @public
+     * @readonly
+     * @type {Listeners<A, L, Parameters<L>, T, R>} The listeners for the event.
      */
-    #async;
+    get listeners() {
+        return this.#listeners;
+    }
+    /**
+     * @description Gets the adapter constructor.
+     * @protected
+     * @returns {new (...listeners: {}) => A} The adapter constructor.
+     */
+    adapterCtor() {
+        return this.#adapterCtor;
+    }
+    /**
+     * @description The adapter class used to manage listeners.
+     * @type {new (...listeners: L[]) => A}
+     */
+    #adapterCtor;
     /**
      * @description The map of events to their listeners.
-     * @type {Listeners<Parameters<E>, E, T, R, A>}
+     * @type {Listeners<A, L, Parameters<L>, T, R>}
      */
     #listeners;
     /**
@@ -36,16 +75,13 @@ class EventEmitterBase {
     /**
      * 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.
+     * @param {R} async Whether the emitter listeners operate asynchronously.
+     * @param {new (...listeners: L[]) => A} adapter The adapter class to manage listeners.
+     * @param {?(L | L[])} [listeners] 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;
+    constructor(async, adapter, listeners) {
+        this.#listeners = new Listeners(async, adapter, ...(Array.isArray(listeners) ? listeners : listeners ? [listeners] : []));
+        this.#adapterCtor = adapter;
     }
     /**
      * @description Removes all listeners for a specific event type.
@@ -66,7 +102,7 @@ class EventEmitterBase {
     /**
      * @description Emits an event, calling all listeners for that event type.
      * @public
-     * @param {...Parameters<E>} args The arguments for the event listeners.
+     * @param {...Parameters<L>} args The arguments for the event listeners.
      */
     emit(...args) {
         return !this.isPaused() && this.#listeners.forEach(listener => listener(...args)),
@@ -80,23 +116,15 @@ class EventEmitterBase {
     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.
+     * @param {...Parameters<L>} args The arguments for the event listeners.
      * @returns {this} The current instance.
      */
     async emitAsync(...args) {
-        const listeners = this.listeners();
+        const listeners = this.listeners;
         if (!listeners || this.isPaused()) {
             return this;
         }
@@ -107,7 +135,7 @@ class EventEmitterBase {
     /**
      * @description Adds a listener for event.
      * @public
-     * @param {E} listener The listener function.
+     * @param {L} listener The listener function.
      * @returns {this} The current instance.
      */
     on(listener) {
@@ -117,7 +145,7 @@ class EventEmitterBase {
     /**
      * @description Adds a one-time listener for event.
      * @public
-     * @param {E} listener The listener function.
+     * @param {L} listener The listener function.
      * @returns {this} The current instance.
      */
     once(listener) {
@@ -127,7 +155,7 @@ class EventEmitterBase {
     /**
      * @description Removes a listener for event.
      * @public
-     * @param {E} listener The listener function.
+     * @param {L} listener The listener function.
      * @returns {this} The current instance.
      */
     off(listener) {
@@ -153,29 +181,29 @@ class EventEmitterBase {
 // Class.
 /**
- * @description A base abstraction class that implements a named event emitter pattern.
+ * @description A base abstraction class that implements a named event emitter pattern with replaceable listeners adapter and asynchronous capabilities.
  * @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.
+ * @template {ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], T, R>} [A=ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, any>] The adapter type for the listeners.
+ * @template [T=A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], infer U, any> ? U : any] The type of the listeners underlying data, inferred from the adapter if possible.
+ * @template {boolean} [R=A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, infer V> ? V : false] The async flag for the listeners, inferred from the adapter if possible.
  */
 class NamedEventEmitterBase {
     /**
      * @description The adapter class used to manage listeners.
      * @type {new (...listeners: E[keyof E][]) => A}
      */
-    #adapter;
+    #adapterCtor;
     /**
-     * @description Indicates whether the emitter listeners operate asynchronously.
+     * @description The async flag for the listeners.
      * @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>>}
+     * @type {Map<keyof E, Listeners<A, E[keyof E], Parameters<E[keyof E]>, T, R>>}
      */
     #events = new Map();
     /**
@@ -186,17 +214,15 @@ class NamedEventEmitterBase {
     /**
      * 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.
+     * @param {R} async Whether the emitter listeners operate asynchronously.
+     * @param {new (...listeners: E[keyof E][]) => A} adapter  The adapter class to manage listeners.
+     * @param {?EventListeners<E>} [events] The initial events and their listeners.
      */
-    constructor({ async, value }, adapter, events) {
-        this.#adapter = adapter;
-        this.#async = async ?? false;
+    constructor(async, adapter, events) {
+        this.#adapterCtor = adapter;
+        this.#async = async;
         for (const [event, listeners] of Object.entries(events ?? {})) {
-            this.#events.set(event, new Listeners(this.#async, this.#adapter));
+            this.#events.set(event, new Listeners(async, adapter));
             for (const listener of listeners) {
                 this.#events.get(event).add(listener);
             }
@@ -295,7 +321,7 @@ class NamedEventEmitterBase {
      * @returns {this} The current instance.
      */
     on(event, listener) {
-        return !this.#events.has(event) && this.#events.set(event, new Listeners(this.#async, this.#adapter)),
+        return !this.#events.has(event) && this.#events.set(event, new Listeners(this.#async, this.#adapterCtor)),
             this.#events.get(event).add(listener),
             this;
     }
@@ -308,7 +334,7 @@ class NamedEventEmitterBase {
      * @returns {this} The current instance.
      */
     once(event, listener) {
-        return !this.#events.has(event) && this.#events.set(event, new Listeners(this.#async, this.#adapter)),
+        return !this.#events.has(event) && this.#events.set(event, new Listeners(this.#async, this.#adapterCtor)),
             this.#events.get(event).once(listener),
             this;
     }
@@ -345,66 +371,41 @@ class NamedEventEmitterBase {
     }
 }
-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.
+ * @description A concrete class for an event emitter pattern with replaceable listeners adapter and asynchronous capabilities.
  * @export
  * @class EventEmitter
- * @template {ListenerFunction<any[]>} E The object type of events.
- * @template [T=any] The type of the listeners underlying data.
+ * @template {ListenerFunction<any[]>} L The listener function type.
+ * @template {ListenersAdapter<Parameters<L>, L, T, any>} [A=ListenersAdapter<Parameters<L>, L, any, any>] The adapter type for the listeners.
+ * @template [T=A extends ListenersAdapter<Parameters<L>, L, infer U, any> ? U : any] The type of the listeners underlying data, inferred from the adapter if possible.
  * @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.
+ * @extends {EventEmitterBase<L, T, R, A>}
  */
 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 {{adapter?: new (...listeners: L[]) => A, async?: R}} param0 The options for the event emitter.
+     * @param {new (...listeners: L[]) => 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.
+     * @param {?(L | L[])} [listeners] The initial listeners.
      */
-    constructor({ adapter, async, value }, events) {
-        super({ async, value }, adapter ?? ListenersSetAdapter, events);
+    constructor({ adapter, async }, listeners) {
+        super(async ?? false, adapter ?? ListenersSetAdapter, listeners);
     }
 }
 // Abstract.
 /**
- * @description A concrete class that implements a named event emitter pattern.
+ * @description A concrete class that implements a named event emitter pattern with replaceable listeners adapter and asynchronous capabilities.
  * @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>}
+ * @template {ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], T, R>} [A=ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, any>] The adapter type for the listeners.
+ * @template [T=A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], infer U, any> ? U : any] The type of the listeners underlying data, inferred from the adapter if possible.
+ * @template {boolean} [R=A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, infer V> ? V : false] The async flag for the listeners, inferred from the adapter if possible.
+ * @extends {NamedEventEmitterBase<E, A, T, R>} The base class for the named event emitter.
  */
 class NamedEventEmitter extends NamedEventEmitterBase {
     /**
@@ -414,8 +415,8 @@ class NamedEventEmitter extends NamedEventEmitterBase {
      * @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);
+    constructor({ adapter, async }, events) {
+        super(async ?? false, adapter ?? ListenersSetAdapter, events);
     }
 }
@@ -429,5 +430,5 @@ class NamedEventEmitter extends NamedEventEmitterBase {
  * Generated bundle index. Do not edit.
  */
-export { EventEmitter, EventEmitterBase, NamedEventEmitter, NamedEventEmitterBase };
+export { EventEmitter, EventEmitterBase, ListenersSetAdapter, NamedEventEmitter, NamedEventEmitterBase };
 //# sourceMappingURL=typescript-package-event-emitter.mjs.map

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

	@@ -1 +1 @@
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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"}
1	+ {"version":3,"file":"typescript-package-event-emitter.mjs","sources":["../../../package/event-emitter/src/adapter/lib/listeners-set.adapter.ts","../../../package/event-emitter/src/lib/event-emitter.base.ts","../../../package/event-emitter/src/lib/named-event-emitter.base.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":["import { ListenerFunction, ListenersAdapter } from \"@typedly/listeners\";\nimport { SetAdapter } from \"@typescript-package/collection-adapter\";\n\nexport class ListenersSetAdapter<\n L extends ListenerFunction<any[]>,\n T extends Set<L> = Set<L>\n> extends SetAdapter<L, T>\n implements ListenersAdapter<Parameters<L>, L, T, false> {\n public override version: string = '1.0.0';\n public once(...listeners: L[]): this {\n listeners.forEach(listener => {\n if (super.has(listener)) {\n throw new Error('Listener already exists in the collection.');\n }\n\n const onceListener = (...args: any[]) => (\n super.delete(onceListener as L),\n listener(...args)\n );\n\n super.add(onceListener as L);\n\n });\n return this;\n }\n\n public snapshot(): L[] {\n return Array.from(this.value);\n }\n}","// Class.\nimport { Listeners } from \"@typescript-package/listeners\";\n// Type & Interface.\nimport type { ListenersAdapter, ListenerFunction } from \"@typedly/listeners\";\n/*\n @description The base abstraction class for an event emitter pattern with replaceable listeners adapter and asynchronous capabilities.\n * @export\n * @abstract\n * @class EventEmitterBase\n * @template {ListenerFunction<any[]>} L 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<L>, L, T, R>} [A=ListenersAdapter<Parameters<L>, L, T, R>] The adapter type for the listeners.\n /\nexport abstract class EventEmitterBase<\n L extends ListenerFunction<any[]>,\n T = any,\n R extends boolean = false,\n A extends ListenersAdapter<Parameters<L>, L, T, R> = ListenersAdapter<Parameters<L>, L, T, R>\n> {\n /\n @description Gets the async flag for the listeners.\n * @public\n * @readonly\n * @type {R}\n /\n public get async(): R {\n return this.#listeners.async;\n }\n\n /\n @description Gets the listeners for a specific event type.\n * @public\n * @readonly\n * @type {Listeners<A, L, Parameters<L>, T, R>} The listeners for the event.\n /\n public get listeners(): Listeners<A, L, Parameters<L>, T, R> {\n return this.#listeners;\n }\n\n /\n @description Gets the adapter constructor.\n * @protected\n * @returns {new (...listeners: {}) => A} The adapter constructor.\n /\n protected adapterCtor() {\n return this.#adapterCtor;\n }\n\n /\n @description The adapter class used to manage listeners.\n * @type {new (...listeners: L[]) => A}\n /\n #adapterCtor: new (...listeners: L[]) => A;\n\n /\n @description The map of events to their listeners.\n * @type {Listeners<A, L, Parameters<L>, T, R>}\n /\n #listeners: Listeners<A, L, Parameters<L>, T, R>;\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 {R} async Whether the emitter listeners operate asynchronously.\n * @param {new (...listeners: L[]) => A} adapter The adapter class to manage listeners.\n * @param {?(L \| L[])} [listeners] The initial listeners.\n /\n constructor(\n async: R,\n adapter: new (...listeners: L[]) => A,\n listeners?: L \| L[]\n ) {\n this.#listeners = new Listeners(\n async,\n adapter,\n ...(Array.isArray(listeners) ? listeners : listeners ? [listeners] : [])\n );\n this.#adapterCtor = adapter;\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<L>} args The arguments for the event listeners.\n /\n public emit(...args: Parameters<L>): 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 Emits an event asynchronously, calling all listeners for that event type.\n * @public\n * @async\n * @param {...Parameters<L>} args The arguments for the event listeners.\n * @returns {this} The current instance.\n /\n public async emitAsync(...args: Parameters<L>): 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 {L} listener The listener function.\n * @returns {this} The current instance.\n /\n public on(listener: L): 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 {L} listener The listener function.\n * @returns {this} The current instance.\n /\n public once(listener: L): this {\n return this.#listeners.once(listener),\n this;\n }\n\n /\n @description Removes a listener for event.\n * @public\n * @param {L} listener The listener function.\n * @returns {this} The current instance.\n /\n public off(listener: L): 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 type { ListenersAdapter, ListenerFunction } from \"@typedly/listeners\";\nimport type { EventListeners, ListenersFor } from \"../type\";\n/\n @description A base abstraction class that implements a named event emitter pattern with replaceable listeners adapter and asynchronous capabilities.\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 {ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], T, R>} [A=ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, any>] The adapter type for the listeners.\n * @template [T=A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], infer U, any> ? U : any] The type of the listeners underlying data, inferred from the adapter if possible.\n * @template {boolean} [R=A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, infer V> ? V : false] The async flag for the listeners, inferred from the adapter if possible.\n /\nexport abstract class NamedEventEmitterBase<\n E extends Record<string, ListenerFunction<any[]>>,\n A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], T, R> = ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, any>,\n T = A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], infer U, any> ? U : any,\n R extends boolean = A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, infer V> ? V : false\n> {\n /\n @description The adapter class used to manage listeners.\n * @type {new (...listeners: E[keyof E][]) => A}\n /\n #adapterCtor: new (...listeners: E[keyof E][]) => A;\n\n /\n @description The async flag for the listeners.\n * @type {R}\n /\n #async: R;\n\n /\n @description The map of events to their listeners.\n * @type {Map<keyof E, Listeners<A, E[keyof E], Parameters<E[keyof E]>, T, R>>}\n /\n #events: Map<keyof E, Listeners<A, E[keyof E], Parameters<E[keyof E]>, T, R>> = 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 {R} async Whether the emitter listeners operate asynchronously.\n * @param {new (...listeners: E[keyof E][]) => A} adapter The adapter class to manage listeners.\n * @param {?EventListeners<E>} [events] The initial events and their listeners.\n /\n constructor(\n async: R,\n adapter: new (...listeners: E[keyof E][]) => A,\n events?: EventListeners<E>\n ) {\n this.#adapterCtor = adapter;\n this.#async = async;\n for (const [event, listeners] of Object.entries(events ?? {})) {\n this.#events.set(event as keyof E, new Listeners(async, 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.#adapterCtor)),\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.#adapterCtor)),\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","// 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 for an event emitter pattern with replaceable listeners adapter and asynchronous capabilities.\n * @export\n * @class EventEmitter\n * @template {ListenerFunction<any[]>} L The listener function type.\n * @template {ListenersAdapter<Parameters<L>, L, T, any>} [A=ListenersAdapter<Parameters<L>, L, any, any>] The adapter type for the listeners.\n * @template [T=A extends ListenersAdapter<Parameters<L>, L, infer U, any> ? U : any] The type of the listeners underlying data, inferred from the adapter if possible.\n * @template {boolean} [R=false] The async flag for the listeners.\n * @extends {EventEmitterBase<L, T, R, A>}\n /\nexport class EventEmitter<\n L extends ListenerFunction<any[]>,\n A extends ListenersAdapter<Parameters<L>, L, T, any> = ListenersAdapter<Parameters<L>, L, any, any>,\n T = A extends ListenersAdapter<Parameters<L>, L, infer U, any> ? U : any,\n R extends boolean = false,\n> extends EventEmitterBase<L, T, R, A> {\n /\n Creates an instance of `EventEmitter`.\n * @constructor\n * @param {{adapter?: new (...listeners: L[]) => A, async?: R}} param0 The options for the event emitter.\n * @param {new (...listeners: L[]) => A} param0.adapter The adapter class to manage listeners.\n * @param {R} param0.async Whether the emitter listeners operate asynchronously.\n * @param {?(L \| L[])} [listeners] The initial listeners.\n /\n constructor(\n {adapter, async}: {adapter?: new (...listeners: L[]) => A, async?: R},\n listeners?: L \| L[],\n ) {\n super(async ?? false as R, adapter ?? ListenersSetAdapter as any, listeners);\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 with replaceable listeners adapter and asynchronous capabilities.\n * @export\n * @class NamedEventEmitter\n * @template {Record<string, ListenerFunction<any[]>>} E Object mapping event names to their listener function types.\n * @template {ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], T, R>} [A=ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, any>] The adapter type for the listeners.\n * @template [T=A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], infer U, any> ? U : any] The type of the listeners underlying data, inferred from the adapter if possible.\n * @template {boolean} [R=A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, infer V> ? V : false] The async flag for the listeners, inferred from the adapter if possible.\n * @extends {NamedEventEmitterBase<E, A, T, R>} The base class for the named event emitter.\n /\nexport class NamedEventEmitter<\n E extends Record<string, ListenerFunction<any[]>>,\n A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], T, R> = ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, any>,\n T = A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], infer U, any> ? U : any,\n R extends boolean = A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, infer V> ? V : false\n> extends NamedEventEmitterBase<E, A, T, R> {\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}: {adapter?: new (...listeners: E[keyof E][]) => A, async?: R},\n events?: Partial<{ [K in keyof E]: E[K][] }>,\n ) {\n super(async ?? false as R, 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 ListenersSetAdapter\n} from './adapter';\n\nexport {\n // Abstract.\n EventEmitterBase,\n NamedEventEmitterBase,\n // Concrete.\n EventEmitter,\n NamedEventEmitter\n} from './lib';\n\nexport type {\n EventListeners,\n ListenersFor\n} from './type';\n","/\n Generated bundle index. Do not edit.\n /\n\nexport from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@typescript-package/event-emitter",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "author": "wwwdev.io <dev@wwwdev.io>",
   "description": "A lightweight TypeScript package for event emitter.",
   "license": "MIT",
@@ -9,8 +9,8 @@
     "registry": "https://registry.npmjs.org"
   },
   "peerDependencies": {
-    "@typescript-package/collection-adapter": "^0.2.0",
-    "@typescript-package/listeners": "^0.0.1"
+    "@typescript-package/collection-adapter": "^0.3.0",
+    "@typescript-package/listeners": "^1.0.0"
   },
   "repository": {
     "type": "git",
@@ -30,6 +30,26 @@
       "type": "stripe",
       "url": "https://donate.stripe.com/dR614hfDZcJE3wAcMM"
     },
+    {
+      "type": "Donorbox",
+      "url": "https://donorbox.org/become-a-sponsor-to-the-angular-package?default_interval=once&amount=1"
+    },
+    {
+      "type": "Open Collective",
+      "url": "https://opencollective.com/sterblack"
+    },
+    {
+      "type": "Ko-fi",
+      "url": "https://ko-fi.com/sterblack"
+    },
+    {
+      "type": "4Fund",
+      "url": "https://4fund.com/bruubs"
+    },
+    {
+      "type": "paypal",
+      "url": "https://paypal.me/sterblack"
+    },
     {
       "type": "individual",
       "url": "https://checkout.revolut.com/pay/048b10a3-0e10-42c8-a917-e3e9cb4c8e29"

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

@@ -1,32 +1,53 @@
-import { Listeners } from '@typescript-package/listeners';
 import { ListenerFunction, ListenersAdapter } from '@typedly/listeners';
 import { SetAdapter } from '@typescript-package/collection-adapter';
+import { Listeners } from '@typescript-package/listeners';
+declare class ListenersSetAdapter<L extends ListenerFunction<any[]>, T extends Set<L> = Set<L>> extends SetAdapter<L, T> implements ListenersAdapter<Parameters<L>, L, T, false> {
+    version: string;
+    once(...listeners: L[]): this;
+    snapshot(): L[];
+}
 /**
- * @description The base abstraction class for an event emitter pattern.
+ * @description The base abstraction class for an event emitter pattern with replaceable listeners adapter and asynchronous capabilities.
  * @export
  * @abstract
  * @class EventEmitterBase
- * @template {ListenerFunction<any[]>} E The listener function type.
+ * @template {ListenerFunction<any[]>} L 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.
+ * @template {ListenersAdapter<Parameters<L>, L, T, R>} [A=ListenersAdapter<Parameters<L>, L, T, R>] 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> {
+declare abstract class EventEmitterBase<L extends ListenerFunction<any[]>, T = any, R extends boolean = false, A extends ListenersAdapter<Parameters<L>, L, T, R> = ListenersAdapter<Parameters<L>, L, T, R>> {
     #private;
+    /**
+     * @description Gets the async flag for the listeners.
+     * @public
+     * @readonly
+     * @type {R}
+     */
+    get async(): R;
+    /**
+     * @description Gets the listeners for a specific event type.
+     * @public
+     * @readonly
+     * @type {Listeners<A, L, Parameters<L>, T, R>} The listeners for the event.
+     */
+    get listeners(): Listeners<A, L, Parameters<L>, T, R>;
+    /**
+     * @description Gets the adapter constructor.
+     * @protected
+     * @returns {new (...listeners: {}) => A} The adapter constructor.
+     */
+    protected adapterCtor(): new (...listeners: L[]) => A;
     /**
      * 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.
+     * @param {R} async Whether the emitter listeners operate asynchronously.
+     * @param {new (...listeners: L[]) => A} adapter The adapter class to manage listeners.
+     * @param {?(L | L[])} [listeners] The initial listeners.
      */
-    constructor({ async, value }: {
-        async?: R;
-        value?: T;
-    }, adapter: new (...listeners: E[]) => A, events?: E | E[]);
+    constructor(async: R, adapter: new (...listeners: L[]) => A, listeners?: L | L[]);
     /**
      * @description Removes all listeners for a specific event type.
      * @public
@@ -42,50 +63,44 @@ declare abstract class EventEmitterBase<E extends ListenerFunction<any[]>, T = a
     /**
      * @description Emits an event, calling all listeners for that event type.
      * @public
-     * @param {...Parameters<E>} args The arguments for the event listeners.
+     * @param {...Parameters<L>} args The arguments for the event listeners.
      */
-    emit(...args: Parameters<E>): this;
+    emit(...args: Parameters<L>): 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.
+     * @param {...Parameters<L>} args The arguments for the event listeners.
      * @returns {this} The current instance.
      */
-    emitAsync(...args: Parameters<E>): Promise<this>;
+    emitAsync(...args: Parameters<L>): Promise<this>;
     /**
      * @description Adds a listener for event.
      * @public
-     * @param {E} listener The listener function.
+     * @param {L} listener The listener function.
      * @returns {this} The current instance.
      */
-    on(listener: E): this;
+    on(listener: L): this;
     /**
      * @description Adds a one-time listener for event.
      * @public
-     * @param {E} listener The listener function.
+     * @param {L} listener The listener function.
      * @returns {this} The current instance.
      */
-    once(listener: E): this;
+    once(listener: L): this;
     /**
      * @description Removes a listener for event.
      * @public
-     * @param {E} listener The listener function.
+     * @param {L} listener The listener function.
      * @returns {this} The current instance.
      */
-    off(listener: E): this;
+    off(listener: L): this;
     /**
      * @description Pauses the event, preventing it from being emitted.
      * @public
@@ -101,42 +116,44 @@ declare abstract class EventEmitterBase<E extends ListenerFunction<any[]>, T = a
 }
 /**
- * @description
+ * @description A type representing a partial mapping of event names to their listener arrays.
+ * @export
+ * @template E
+ */
+type EventListeners<E> = Partial<{
+    [K in keyof E]: E[K][] | E[K];
+}>;
+/**
+ * @description A type representing the listeners for a specific event in a named event emitter, utilizing a specified listeners adapter and supporting asynchronous capabilities.
  * @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>>;
+type ListenersFor<Event extends keyof E, E extends Record<string, ListenerFunction<any[]>>, T = any, R extends boolean = false, A extends ListenersAdapter<Parameters<E[Event]>, E[Event], T, R> = ListenersAdapter<Parameters<E[Event]>, E[Event], T, R>> = Listeners<A, E[Event], Parameters<E[Event]>, T, R>;
 /**
- * @description A base abstraction class that implements a named event emitter pattern.
+ * @description A base abstraction class that implements a named event emitter pattern with replaceable listeners adapter and asynchronous capabilities.
  * @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.
+ * @template {ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], T, R>} [A=ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, any>] The adapter type for the listeners.
+ * @template [T=A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], infer U, any> ? U : any] The type of the listeners underlying data, inferred from the adapter if possible.
+ * @template {boolean} [R=A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, infer V> ? V : false] The async flag for the listeners, inferred from the adapter if possible.
  */
-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> {
+declare abstract class NamedEventEmitterBase<E extends Record<string, ListenerFunction<any[]>>, A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], T, R> = ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, any>, T = A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], infer U, any> ? U : any, R extends boolean = A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, infer V> ? V : false> {
     #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.
+     * @param {R} async Whether the emitter listeners operate asynchronously.
+     * @param {new (...listeners: E[keyof E][]) => A} adapter  The adapter class to manage listeners.
+     * @param {?EventListeners<E>} [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][];
-    }>);
+    constructor(async: R, adapter: new (...listeners: E[keyof E][]) => A, events?: EventListeners<E>);
     /**
      * @description Removes all listeners for a specific event type.
      * @public
@@ -243,56 +260,42 @@ declare abstract class NamedEventEmitterBase<E extends Record<string, ListenerFu
     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.
+ * @description A concrete class for an event emitter pattern with replaceable listeners adapter and asynchronous capabilities.
  * @export
  * @class EventEmitter
- * @template {ListenerFunction<any[]>} E The object type of events.
- * @template [T=any] The type of the listeners underlying data.
+ * @template {ListenerFunction<any[]>} L The listener function type.
+ * @template {ListenersAdapter<Parameters<L>, L, T, any>} [A=ListenersAdapter<Parameters<L>, L, any, any>] The adapter type for the listeners.
+ * @template [T=A extends ListenersAdapter<Parameters<L>, L, infer U, any> ? U : any] The type of the listeners underlying data, inferred from the adapter if possible.
  * @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.
+ * @extends {EventEmitterBase<L, T, R, A>}
  */
-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]
-     */
+declare class EventEmitter<L extends ListenerFunction<any[]>, A extends ListenersAdapter<Parameters<L>, L, T, any> = ListenersAdapter<Parameters<L>, L, any, any>, T = A extends ListenersAdapter<Parameters<L>, L, infer U, any> ? U : any, R extends boolean = false> extends EventEmitterBase<L, T, R, A> {
     /**
      * 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 {{adapter?: new (...listeners: L[]) => A, async?: R}} param0 The options for the event emitter.
+     * @param {new (...listeners: L[]) => 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.
+     * @param {?(L | L[])} [listeners] The initial listeners.
      */
-    constructor({ adapter, async, value }: {
-        adapter?: new (...listeners: E[]) => A;
+    constructor({ adapter, async }: {
+        adapter?: new (...listeners: L[]) => A;
         async?: R;
-        value?: T;
-    }, events?: E | E[]);
+    }, listeners?: L | L[]);
 }
 /**
- * @description A concrete class that implements a named event emitter pattern.
+ * @description A concrete class that implements a named event emitter pattern with replaceable listeners adapter and asynchronous capabilities.
  * @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>}
+ * @template {ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], T, R>} [A=ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, any>] The adapter type for the listeners.
+ * @template [T=A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], infer U, any> ? U : any] The type of the listeners underlying data, inferred from the adapter if possible.
+ * @template {boolean} [R=A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, infer V> ? V : false] The async flag for the listeners, inferred from the adapter if possible.
+ * @extends {NamedEventEmitterBase<E, A, T, R>} The base class for the named event emitter.
  */
-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> {
+declare class NamedEventEmitter<E extends Record<string, ListenerFunction<any[]>>, A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], T, R> = ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, any>, T = A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], infer U, any> ? U : any, R extends boolean = A extends ListenersAdapter<Parameters<E[keyof E]>, E[keyof E], any, infer V> ? V : false> extends NamedEventEmitterBase<E, A, T, R> {
     /**
      * Creates an instance of `NamedEventEmitter`.
      * @constructor
@@ -300,13 +303,13 @@ declare class NamedEventEmitter<E extends Record<string, ListenerFunction<any[]>
      * @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 }: {
+    constructor({ adapter, async }: {
         adapter?: new (...listeners: E[keyof E][]) => A;
         async?: R;
-        value?: T;
     }, events?: Partial<{
         [K in keyof E]: E[K][];
     }>);
 }
-export { EventEmitter, EventEmitterBase, NamedEventEmitter, NamedEventEmitterBase };
+export { EventEmitter, EventEmitterBase, ListenersSetAdapter, NamedEventEmitter, NamedEventEmitterBase };
+export type { EventListeners, ListenersFor };