@xylabs/events 5.0.94 → 5.0.96

package/README.md

@@ -1,62 +1,52 @@
 # @xylabs/events
 
-[![logo][]](https://xylabs.com)
+[![npm][npm-badge]][npm-link]
+[![license][license-badge]][license-link]
 
-[![main-build][]][main-build-link]
-[![npm-badge][]][npm-link]
-[![npm-downloads-badge][]][npm-link]
-[![jsdelivr-badge][]][jsdelivr-link]
-[![npm-license-badge][]](LICENSE)
-[![codacy-badge][]][codacy-link]
-[![codeclimate-badge][]][codeclimate-link]
-[![snyk-badge][]][snyk-link]
-[![socket-badge][]][socket-link]
+> Base functionality used throughout XY Labs TypeScript/JavaScript libraries
 
+## Install
 
-Base functionality used throughout XY Labs TypeScript/JavaScript libraries
+Using npm:
 
+```sh
+npm install {{name}}
+```
 
+Using yarn:
 
-## Reference
+```sh
+yarn add {{name}}
+```
 
-**@xylabs/events**
+Using pnpm:
 
-***
+```sh
+pnpm add {{name}}
+```
 
-## Classes
+Using bun:
 
-| Class | Description |
-| ------ | ------ |
-| [BaseEmitter](#classes/BaseEmitter) | Base class that combines the Base utility class with typed event emission capabilities. Delegates all event operations to an internal Events instance. |
-| [Events](#classes/Events) | Core typed event emitter implementation supporting named events, wildcard listeners, serial and concurrent emission, listener filtering, and debug logging. |
+```sh
+bun add {{name}}
+```
 
-## Interfaces
 
-| Interface | Description |
-| ------ | ------ |
-| [BaseEmitterParamsFields](#interfaces/BaseEmitterParamsFields) | Fields specific to BaseEmitter configuration parameters. |
-| [EventEmitter](#interfaces/EventEmitter) | Interface for a typed event emitter that supports subscribing, unsubscribing, and emitting events. |
+## License
 
-## Type Aliases
+See the [LICENSE](LICENSE) file for license rights and limitations (LGPL-3.0-only).
 
-| Type Alias | Description |
-| ------ | ------ |
-| [BaseEmitterParams](#type-aliases/BaseEmitterParams) | Parameters type for configuring a BaseEmitter instance. |
-| [DebugLogger](#type-aliases/DebugLogger) | Emittery can collect and log debug information. |
-| [EventListenerInfo](#type-aliases/EventListenerInfo) | Information about a registered event listener, including an optional filter for selective invocation. |
-| [DebugOptions](#type-aliases/DebugOptions) | Configure debug options of an instance. |
-| [MetaEventData](#type-aliases/MetaEventData) | Data shape for internal meta events that fire when listeners are added or removed. |
-| [EventsParams](#type-aliases/EventsParams) | Parameters for constructing an Events instance, with optional debug configuration. |
-| [EventName](#type-aliases/EventName) | A valid event name, which can be any property key (string, number, or symbol). |
-| [EventArgs](#type-aliases/EventArgs) | The allowed types for event argument payloads. |
-| [EventData](#type-aliases/EventData) | A mapping of event names to their corresponding event argument types. |
-| [EventUnsubscribeFunction](#type-aliases/EventUnsubscribeFunction) | A function returned by event subscription methods that unsubscribes the listener when called. |
-| [EventAnyListener](#type-aliases/EventAnyListener) | A listener that receives all events regardless of name. |
-| [EventListener](#type-aliases/EventListener) | A listener for a specific event type. |
+## Reference
 
-### classes
+### packages
 
-  ### <a id="BaseEmitter"></a>BaseEmitter
+  ### events
+
+    ### .temp-typedoc
+
+      ### classes
+
+        ### <a id="BaseEmitter"></a>BaseEmitter
 
 [**@xylabs/events**](#../README)
 
@@ -71,10 +61,13 @@ Delegates all event operations to an internal Events instance.
 
 ## Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TParams` *extends* `BaseParams` | `BaseParams` |
-| `TEventData` *extends* [`EventData`](#../type-aliases/EventData) | [`EventData`](#../type-aliases/EventData) |
+### TParams
+
+`TParams` *extends* `BaseParams` = `BaseParams`
+
+### TEventData
+
+`TEventData` *extends* [`EventData`](#../type-aliases/EventData) = [`EventData`](#../type-aliases/EventData)
 
 ## Implements
 
@@ -85,14 +78,14 @@ Delegates all event operations to an internal Events instance.
 ### Constructor
 
 ```ts
-new BaseEmitter<TParams, TEventData>(params: BaseParams<TParams>): BaseEmitter<TParams, TEventData>;
+new BaseEmitter<TParams, TEventData>(params): BaseEmitter<TParams, TEventData>;
 ```
 
 ### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `params` | `BaseParams`\<`TParams`\> |
+#### params
+
+`BaseParams`\<`TParams`\>
 
 ### Returns
 
@@ -106,12 +99,59 @@ Base<TParams>.constructor
 
 ## Properties
 
-| Property | Modifier | Type | Description | Inherited from |
-| ------ | ------ | ------ | ------ | ------ |
-| <a id="defaultlogger"></a> `defaultLogger?` | `static` | `Logger` | - | `Base.defaultLogger` |
-| <a id="globalinstances"></a> `globalInstances` | `readonly` | `Record`\<`BaseClassName`, `WeakRef`\<`Base`\>[]\> | - | `Base.globalInstances` |
-| <a id="globalinstancescounthistory"></a> `globalInstancesCountHistory` | `readonly` | `Record`\<`BaseClassName`, `number`[]\> | - | `Base.globalInstancesCountHistory` |
-| <a id="eventdata"></a> `eventData` | `public` | `TEventData` | Type-level reference to the event data shape for external type queries. | - |
+### defaultLogger?
+
+```ts
+static optional defaultLogger?: Logger;
+```
+
+### Inherited from
+
+```ts
+Base.defaultLogger
+```
+
+***
+
+### globalInstances
+
+```ts
+readonly static globalInstances: Record<BaseClassName, WeakRef<Base>[]>;
+```
+
+### Inherited from
+
+```ts
+Base.globalInstances
+```
+
+***
+
+### globalInstancesCountHistory
+
+```ts
+readonly static globalInstancesCountHistory: Record<BaseClassName, number[]>;
+```
+
+### Inherited from
+
+```ts
+Base.globalInstancesCountHistory
+```
+
+***
+
+### eventData
+
+```ts
+eventData: TEventData;
+```
+
+Type-level reference to the event data shape for external type queries.
+
+### Implementation of
+
+[`EventEmitter`](#../interfaces/EventEmitter).[`eventData`](../interfaces/EventEmitter.md#eventdata)
 
 ## Accessors
 
@@ -130,14 +170,14 @@ get static historyInterval(): number;
 ### Set Signature
 
 ```ts
-set static historyInterval(value: number): void;
+set static historyInterval(value): void;
 ```
 
 #### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `value` | `number` |
+##### value
+
+`number`
 
 #### Returns
 
@@ -166,14 +206,14 @@ get static historyTime(): number;
 ### Set Signature
 
 ```ts
-set static historyTime(value: number): void;
+set static historyTime(value): void;
 ```
 
 #### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `value` | `number` |
+##### value
+
+`number`
 
 #### Returns
 
@@ -202,14 +242,14 @@ get static maxGcFrequency(): number;
 ### Set Signature
 
 ```ts
-set static maxGcFrequency(value: number): void;
+set static maxGcFrequency(value): void;
 ```
 
 #### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `value` | `number` |
+##### value
+
+`number`
 
 #### Returns
 
@@ -328,14 +368,14 @@ Base.tracer
 ### Call Signature
 
 ```ts
-static gc(force?: boolean): void;
+static gc(force?): void;
 ```
 
 #### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `force?` | `boolean` |
+##### force?
+
+`boolean`
 
 #### Returns
 
@@ -350,14 +390,14 @@ Base.gc
 ### Call Signature
 
 ```ts
-static gc(className: BaseClassName): void;
+static gc(className): void;
 ```
 
 #### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `className` | `BaseClassName` |
+##### className
+
+`BaseClassName`
 
 #### Returns
 
@@ -374,14 +414,14 @@ Base.gc
 ### instanceCount()
 
 ```ts
-static instanceCount(className: BaseClassName): number;
+static instanceCount(className): number;
 ```
 
 ### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `className` | `BaseClassName` |
+#### className
+
+`BaseClassName`
 
 ### Returns
 
@@ -452,16 +492,18 @@ Base.stopHistory
 ### clearListeners()
 
 ```ts
-clearListeners(eventNames: keyof TEventData | keyof TEventData[]): BaseEmitter<TParams, TEventData>;
+clearListeners(eventNames): BaseEmitter<TParams, TEventData>;
 ```
 
 Removes all listeners for the specified event name(s).
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `eventNames` | keyof `TEventData` \| keyof `TEventData`[] | One or more event names to clear listeners for. |
+#### eventNames
+
+keyof `TEventData` \| keyof `TEventData`[]
+
+One or more event names to clear listeners for.
 
 ### Returns
 
@@ -478,24 +520,34 @@ This instance for chaining.
 ### emit()
 
 ```ts
-emit<TEventName, TEventArgs>(eventName: TEventName, eventArgs: TEventArgs): Promise<void>;
+emit<TEventName, TEventArgs>(eventName, eventArgs): Promise<void>;
 ```
 
 Emits an event, invoking all registered listeners concurrently.
 
 ### Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TEventName` *extends* `string` \| `number` \| `symbol` | keyof `TEventData` |
-| `TEventArgs` *extends* [`EventArgs`](#../type-aliases/EventArgs) | `TEventData`\[`TEventName`\] |
+#### TEventName
+
+`TEventName` *extends* `string` \| `number` \| `symbol` = keyof `TEventData`
+
+#### TEventArgs
+
+`TEventArgs` *extends* [`EventArgs`](#../type-aliases/EventArgs) = `TEventData`\[`TEventName`\]
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `eventName` | `TEventName` | The event to emit. |
-| `eventArgs` | `TEventArgs` | The data to pass to listeners. |
+#### eventName
+
+`TEventName`
+
+The event to emit.
+
+#### eventArgs
+
+`TEventArgs`
+
+The data to pass to listeners.
 
 ### Returns
 
@@ -510,24 +562,34 @@ Emits an event, invoking all registered listeners concurrently.
 ### emitSerial()
 
 ```ts
-emitSerial<TEventName, TEventArgs>(eventName: TEventName, eventArgs: TEventArgs): Promise<void>;
+emitSerial<TEventName, TEventArgs>(eventName, eventArgs): Promise<void>;
 ```
 
 Emits an event, invoking all registered listeners sequentially in order.
 
 ### Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TEventName` *extends* `string` \| `number` \| `symbol` | keyof `TEventData` |
-| `TEventArgs` *extends* [`EventArgs`](#../type-aliases/EventArgs) | `TEventData`\[`TEventName`\] |
+#### TEventName
+
+`TEventName` *extends* `string` \| `number` \| `symbol` = keyof `TEventData`
+
+#### TEventArgs
+
+`TEventArgs` *extends* [`EventArgs`](#../type-aliases/EventArgs) = `TEventData`\[`TEventName`\]
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `eventName` | `TEventName` | The event to emit. |
-| `eventArgs` | `TEventArgs` | The data to pass to listeners. |
+#### eventName
+
+`TEventName`
+
+The event to emit.
+
+#### eventArgs
+
+`TEventArgs`
+
+The data to pass to listeners.
 
 ### Returns
 
@@ -542,16 +604,18 @@ Emits an event, invoking all registered listeners sequentially in order.
 ### listenerCount()
 
 ```ts
-listenerCount(eventNames: keyof TEventData | keyof TEventData[]): number;
+listenerCount(eventNames): number;
 ```
 
 Returns the total number of listeners registered for the specified event name(s).
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `eventNames` | keyof `TEventData` \| keyof `TEventData`[] | One or more event names to count listeners for. |
+#### eventNames
+
+keyof `TEventData` \| keyof `TEventData`[]
+
+One or more event names to count listeners for.
 
 ### Returns
 
@@ -568,23 +632,30 @@ The total listener count.
 ### off()
 
 ```ts
-off<TEventName>(eventNames: TEventName | TEventName[], listener: EventListener<TEventData[TEventName]>): void;
+off<TEventName>(eventNames, listener): void;
 ```
 
 Removes a specific listener from the specified event name(s).
 
 ### Type Parameters
 
-| Type Parameter |
-| ------ |
-| `TEventName` *extends* `string` \| `number` \| `symbol` |
+#### TEventName
+
+`TEventName` *extends* `string` \| `number` \| `symbol`
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `eventNames` | `TEventName` \| `TEventName`[] | One or more event names to unsubscribe from. |
-| `listener` | [`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\> | The listener to remove. |
+#### eventNames
+
+`TEventName` \| `TEventName`[]
+
+One or more event names to unsubscribe from.
+
+#### listener
+
+[`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\>
+
+The listener to remove.
 
 ### Returns
 
@@ -599,16 +670,18 @@ Removes a specific listener from the specified event name(s).
 ### offAny()
 
 ```ts
-offAny(listener: EventAnyListener): void;
+offAny(listener): void;
 ```
 
 Removes a wildcard listener that was receiving all events.
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `listener` | [`EventAnyListener`](#../type-aliases/EventAnyListener) | The wildcard listener to remove. |
+#### listener
+
+[`EventAnyListener`](#../type-aliases/EventAnyListener)
+
+The wildcard listener to remove.
 
 ### Returns
 
@@ -623,41 +696,36 @@ Removes a wildcard listener that was receiving all events.
 ### on()
 
 ```ts
-on<TEventName>(eventNames: TEventName | TEventName[], listener: EventListener<TEventData[TEventName]>): (...args: []) => void;
+on<TEventName>(eventNames, listener): (...args) => void;
 ```
 
 Subscribes a listener to the specified event name(s).
 
 ### Type Parameters
 
-| Type Parameter |
-| ------ |
-| `TEventName` *extends* `string` \| `number` \| `symbol` |
+#### TEventName
+
+`TEventName` *extends* `string` \| `number` \| `symbol`
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `eventNames` | `TEventName` \| `TEventName`[] | One or more event names to listen for. |
-| `listener` | [`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\> | The callback to invoke when the event fires. |
+#### eventNames
 
-### Returns
+`TEventName` \| `TEventName`[]
 
-An unsubscribe function.
+One or more event names to listen for.
 
-```ts
-(...args: []): void;
-```
+#### listener
 
-#### Parameters
+[`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\>
 
-| Parameter | Type |
-| ------ | ------ |
-| ...`args` | \[\] |
+The callback to invoke when the event fires.
 
-#### Returns
+### Returns
 
-`void`
+An unsubscribe function.
+
+(...`args`) => `void`
 
 ### Implementation of
 
@@ -668,34 +736,24 @@ An unsubscribe function.
 ### onAny()
 
 ```ts
-onAny(listener: EventAnyListener): (...args: []) => void;
+onAny(listener): (...args) => void;
 ```
 
 Subscribes a wildcard listener that receives all events.
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `listener` | [`EventAnyListener`](#../type-aliases/EventAnyListener) | The callback to invoke for any event. |
-
-### Returns
-
-An unsubscribe function.
+#### listener
 
-```ts
-(...args: []): void;
-```
+[`EventAnyListener`](#../type-aliases/EventAnyListener)
 
-#### Parameters
+The callback to invoke for any event.
 
-| Parameter | Type |
-| ------ | ------ |
-| ...`args` | \[\] |
+### Returns
 
-#### Returns
+An unsubscribe function.
 
-`void`
+(...`args`) => `void`
 
 ### Implementation of
 
@@ -706,47 +764,42 @@ An unsubscribe function.
 ### once()
 
 ```ts
-once<TEventName>(eventName: TEventName, listener: EventListener<TEventData[TEventName]>): (...args: []) => void;
+once<TEventName>(eventName, listener): (...args) => void;
 ```
 
 Subscribes a listener that will be invoked only once for the specified event, then automatically removed.
 
 ### Type Parameters
 
-| Type Parameter |
-| ------ |
-| `TEventName` *extends* `string` \| `number` \| `symbol` |
+#### TEventName
+
+`TEventName` *extends* `string` \| `number` \| `symbol`
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `eventName` | `TEventName` | The event to listen for. |
-| `listener` | [`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\> | The callback to invoke once. |
+#### eventName
 
-### Returns
+`TEventName`
 
-An unsubscribe function.
+The event to listen for.
 
-```ts
-(...args: []): void;
-```
+#### listener
 
-#### Parameters
+[`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\>
 
-| Parameter | Type |
-| ------ | ------ |
-| ...`args` | \[\] |
+The callback to invoke once.
 
-#### Returns
+### Returns
 
-`void`
+An unsubscribe function.
+
+(...`args`) => `void`
 
 ### Implementation of
 
 [`EventEmitter`](#../interfaces/EventEmitter).[`once`](../interfaces/EventEmitter.md#once)
 
-  ### <a id="Events"></a>Events
+        ### <a id="Events"></a>Events
 
 [**@xylabs/events**](#../README)
 
@@ -761,9 +814,9 @@ serial and concurrent emission, listener filtering, and debug logging.
 
 ## Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TEventData` *extends* [`EventData`](#../type-aliases/EventData) | [`EventData`](#../type-aliases/EventData) |
+### TEventData
+
+`TEventData` *extends* [`EventData`](#../type-aliases/EventData) = [`EventData`](#../type-aliases/EventData)
 
 ## Implements
 
@@ -774,14 +827,14 @@ serial and concurrent emission, listener filtering, and debug logging.
 ### Constructor
 
 ```ts
-new Events<TEventData>(params?: EventsParams): Events<TEventData>;
+new Events<TEventData>(params?): Events<TEventData>;
 ```
 
 ### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `params` | [`EventsParams`](#../type-aliases/EventsParams) |
+#### params?
+
+[`EventsParams`](#../type-aliases/EventsParams) = `{}`
 
 ### Returns
 
@@ -795,14 +848,75 @@ Base<EventsParams>.constructor
 
 ## Properties
 
-| Property | Modifier | Type | Description | Inherited from |
-| ------ | ------ | ------ | ------ | ------ |
-| <a id="defaultlogger"></a> `defaultLogger?` | `static` | `Logger` | - | `Base.defaultLogger` |
-| <a id="globalinstances"></a> `globalInstances` | `readonly` | `Record`\<`BaseClassName`, `WeakRef`\<`Base`\>[]\> | - | `Base.globalInstances` |
-| <a id="globalinstancescounthistory"></a> `globalInstancesCountHistory` | `readonly` | `Record`\<`BaseClassName`, `number`[]\> | - | `Base.globalInstancesCountHistory` |
-| <a id="anymap"></a> `anyMap` | `static` | `WeakMap`\<`object`, `Set`\<[`EventAnyListener`](#../type-aliases/EventAnyListener)\>\> | - | - |
-| <a id="eventsmap"></a> `eventsMap` | `static` | `WeakMap`\<`object`, `Map`\<`PropertyKey`, `Set`\<[`EventListenerInfo`](#../type-aliases/EventListenerInfo)\<[`EventArgs`](#../type-aliases/EventArgs)\>\>\>\> | - | - |
-| <a id="eventdata"></a> `eventData` | `public` | `TEventData` | Type-level reference to the event data shape for external type queries. | - |
+### defaultLogger?
+
+```ts
+static optional defaultLogger?: Logger;
+```
+
+### Inherited from
+
+```ts
+Base.defaultLogger
+```
+
+***
+
+### globalInstances
+
+```ts
+readonly static globalInstances: Record<BaseClassName, WeakRef<Base>[]>;
+```
+
+### Inherited from
+
+```ts
+Base.globalInstances
+```
+
+***
+
+### globalInstancesCountHistory
+
+```ts
+readonly static globalInstancesCountHistory: Record<BaseClassName, number[]>;
+```
+
+### Inherited from
+
+```ts
+Base.globalInstancesCountHistory
+```
+
+***
+
+### anyMap
+
+```ts
+protected static anyMap: WeakMap<object, Set<EventAnyListener>>;
+```
+
+***
+
+### eventsMap
+
+```ts
+protected static eventsMap: WeakMap<object, Map<PropertyKey, Set<EventListenerInfo<EventArgs>>>>;
+```
+
+***
+
+### eventData
+
+```ts
+eventData: TEventData;
+```
+
+Type-level reference to the event data shape for external type queries.
+
+### Implementation of
+
+[`EventEmitter`](#../interfaces/EventEmitter).[`eventData`](../interfaces/EventEmitter.md#eventdata)
 
 ## Accessors
 
@@ -821,14 +935,14 @@ get static historyInterval(): number;
 ### Set Signature
 
 ```ts
-set static historyInterval(value: number): void;
+set static historyInterval(value): void;
 ```
 
 #### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `value` | `number` |
+##### value
+
+`number`
 
 #### Returns
 
@@ -857,14 +971,14 @@ get static historyTime(): number;
 ### Set Signature
 
 ```ts
-set static historyTime(value: number): void;
+set static historyTime(value): void;
 ```
 
 #### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `value` | `number` |
+##### value
+
+`number`
 
 #### Returns
 
@@ -893,14 +1007,14 @@ get static maxGcFrequency(): number;
 ### Set Signature
 
 ```ts
-set static maxGcFrequency(value: number): void;
+set static maxGcFrequency(value): void;
 ```
 
 #### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `value` | `number` |
+##### value
+
+`number`
 
 #### Returns
 
@@ -1031,14 +1145,14 @@ Whether debug mode is enabled globally or via the DEBUG environment variable.
 ### Set Signature
 
 ```ts
-set static isDebugEnabled(newValue: boolean): void;
+set static isDebugEnabled(newValue): void;
 ```
 
 #### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `newValue` | `boolean` |
+##### newValue
+
+`boolean`
 
 #### Returns
 
@@ -1058,7 +1172,7 @@ The debug configuration for this instance, if provided.
 
 #### Returns
 
-[`DebugOptions`](#../type-aliases/DebugOptions) \| `undefined`
+[`DebugOptions`](#../interfaces/DebugOptions) \| `undefined`
 
 ## Methods
 
@@ -1067,14 +1181,14 @@ The debug configuration for this instance, if provided.
 ### Call Signature
 
 ```ts
-static gc(force?: boolean): void;
+static gc(force?): void;
 ```
 
 #### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `force?` | `boolean` |
+##### force?
+
+`boolean`
 
 #### Returns
 
@@ -1089,14 +1203,14 @@ Base.gc
 ### Call Signature
 
 ```ts
-static gc(className: BaseClassName): void;
+static gc(className): void;
 ```
 
 #### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `className` | `BaseClassName` |
+##### className
+
+`BaseClassName`
 
 #### Returns
 
@@ -1113,14 +1227,14 @@ Base.gc
 ### instanceCount()
 
 ```ts
-static instanceCount(className: BaseClassName): number;
+static instanceCount(className): number;
 ```
 
 ### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `className` | `BaseClassName` |
+#### className
+
+`BaseClassName`
 
 ### Returns
 
@@ -1191,16 +1305,18 @@ Base.stopHistory
 ### clearListeners()
 
 ```ts
-clearListeners(eventNames: keyof TEventData | keyof TEventData[]): void;
+clearListeners(eventNames): void;
 ```
 
 Removes all listeners for the specified event name(s).
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `eventNames` | keyof `TEventData` \| keyof `TEventData`[] | One or more event names to clear listeners for. |
+#### eventNames
+
+keyof `TEventData` \| keyof `TEventData`[]
+
+One or more event names to clear listeners for.
 
 ### Returns
 
@@ -1215,23 +1331,30 @@ Removes all listeners for the specified event name(s).
 ### emit()
 
 ```ts
-emit<TEventName>(eventName: TEventName, eventArgs: TEventData[TEventName]): Promise<void>;
+emit<TEventName>(eventName, eventArgs): Promise<void>;
 ```
 
 Emits an event, invoking all registered listeners concurrently.
 
 ### Type Parameters
 
-| Type Parameter |
-| ------ |
-| `TEventName` *extends* `string` \| `number` \| `symbol` |
+#### TEventName
+
+`TEventName` *extends* `string` \| `number` \| `symbol`
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `eventName` | `TEventName` | The event to emit. |
-| `eventArgs` | `TEventData`\[`TEventName`\] | The data to pass to listeners. |
+#### eventName
+
+`TEventName`
+
+The event to emit.
+
+#### eventArgs
+
+`TEventData`\[`TEventName`\]
+
+The data to pass to listeners.
 
 ### Returns
 
@@ -1246,23 +1369,30 @@ Emits an event, invoking all registered listeners concurrently.
 ### emitMetaEvent()
 
 ```ts
-emitMetaEvent<TEventName>(eventName: TEventName, eventArgs: MetaEventData<TEventData>[TEventName]): Promise<boolean | undefined>;
+emitMetaEvent<TEventName>(eventName, eventArgs): Promise<boolean | undefined>;
 ```
 
 Emits an internal meta event (listenerAdded or listenerRemoved).
 
 ### Type Parameters
 
-| Type Parameter |
-| ------ |
-| `TEventName` *extends* keyof [`MetaEventData`](#../type-aliases/MetaEventData)\<`TEventData`\> |
+#### TEventName
+
+`TEventName` *extends* keyof [`MetaEventData`](#../interfaces/MetaEventData)\<`TEventData`\>
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `eventName` | `TEventName` | The meta event name. |
-| `eventArgs` | [`MetaEventData`](#../type-aliases/MetaEventData)\<`TEventData`\>\[`TEventName`\] | The meta event data containing listener and event information. |
+#### eventName
+
+`TEventName`
+
+The meta event name.
+
+#### eventArgs
+
+[`MetaEventData`](#../interfaces/MetaEventData)\<`TEventData`\>\[`TEventName`\]
+
+The meta event data containing listener and event information.
 
 ### Returns
 
@@ -1275,23 +1405,30 @@ True if the meta event was emitted successfully.
 ### emitSerial()
 
 ```ts
-emitSerial<TEventName>(eventName: TEventName, eventArgs: TEventData[TEventName]): Promise<void>;
+emitSerial<TEventName>(eventName, eventArgs): Promise<void>;
 ```
 
 Emits an event, invoking all registered listeners sequentially in order.
 
 ### Type Parameters
 
-| Type Parameter |
-| ------ |
-| `TEventName` *extends* `string` \| `number` \| `symbol` |
+#### TEventName
+
+`TEventName` *extends* `string` \| `number` \| `symbol`
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `eventName` | `TEventName` | The event to emit. |
-| `eventArgs` | `TEventData`\[`TEventName`\] | The data to pass to listeners. |
+#### eventName
+
+`TEventName`
+
+The event to emit.
+
+#### eventArgs
+
+`TEventData`\[`TEventName`\]
+
+The data to pass to listeners.
 
 ### Returns
 
@@ -1306,16 +1443,18 @@ Emits an event, invoking all registered listeners sequentially in order.
 ### listenerCount()
 
 ```ts
-listenerCount(eventNames?: keyof TEventData | keyof TEventData[]): number;
+listenerCount(eventNames?): number;
 ```
 
 Returns the total number of listeners registered for the specified event name(s).
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `eventNames?` | keyof `TEventData` \| keyof `TEventData`[] | One or more event names to count listeners for. |
+#### eventNames?
+
+keyof `TEventData` \| keyof `TEventData`[]
+
+One or more event names to count listeners for.
 
 ### Returns
 
@@ -1333,26 +1472,38 @@ The total listener count.
 
 ```ts
 logIfDebugEnabled<TEventName>(
-   type: string, 
-   eventName?: TEventName, 
-   eventArgs?: EventArgs): void;
+   type, 
+   eventName?, 
+   eventArgs?): void;
 ```
 
 Logs debug information if debug mode is enabled.
 
 ### Type Parameters
 
-| Type Parameter |
-| ------ |
-| `TEventName` *extends* `PropertyKey` |
+#### TEventName
+
+`TEventName` *extends* `PropertyKey`
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `type` | `string` | The type of operation being logged. |
-| `eventName?` | `TEventName` | The event name, if applicable. |
-| `eventArgs?` | [`EventArgs`](#../type-aliases/EventArgs) | The event data, if applicable. |
+#### type
+
+`string`
+
+The type of operation being logged.
+
+#### eventName?
+
+`TEventName`
+
+The event name, if applicable.
+
+#### eventArgs?
+
+[`EventArgs`](#../type-aliases/EventArgs)
+
+The event data, if applicable.
 
 ### Returns
 
@@ -1363,24 +1514,34 @@ Logs debug information if debug mode is enabled.
 ### off()
 
 ```ts
-off<TEventName, TEventListener>(eventNames: TEventName | TEventName[], listener: TEventListener): void;
+off<TEventName, TEventListener>(eventNames, listener): void;
 ```
 
 Removes a specific listener from the specified event name(s).
 
 ### Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TEventName` *extends* `string` \| `number` \| `symbol` | - |
-| `TEventListener` | [`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\> |
+#### TEventName
+
+`TEventName` *extends* `string` \| `number` \| `symbol`
+
+#### TEventListener
+
+`TEventListener` = [`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\>
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `eventNames` | `TEventName` \| `TEventName`[] | One or more event names to unsubscribe from. |
-| `listener` | `TEventListener` | The listener to remove. |
+#### eventNames
+
+`TEventName` \| `TEventName`[]
+
+One or more event names to unsubscribe from.
+
+#### listener
+
+`TEventListener`
+
+The listener to remove.
 
 ### Returns
 
@@ -1395,16 +1556,18 @@ Removes a specific listener from the specified event name(s).
 ### offAny()
 
 ```ts
-offAny(listener: EventAnyListener): void;
+offAny(listener): void;
 ```
 
 Removes a wildcard listener that was receiving all events.
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `listener` | [`EventAnyListener`](#../type-aliases/EventAnyListener) | The wildcard listener to remove. |
+#### listener
+
+[`EventAnyListener`](#../type-aliases/EventAnyListener)
+
+The wildcard listener to remove.
 
 ### Returns
 
@@ -1420,44 +1583,44 @@ Removes a wildcard listener that was receiving all events.
 
 ```ts
 on<TEventName>(
-   eventNames: TEventName | TEventName[], 
-   listener: EventListener<TEventData[TEventName]>, 
-   filter?: TEventData[TEventName]): (...args: []) => void;
+   eventNames, 
+   listener, 
+   filter?): (...args) => void;
 ```
 
 Subscribes a listener to the specified event name(s).
 
 ### Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TEventName` *extends* `string` \| `number` \| `symbol` | keyof `TEventData` |
+#### TEventName
+
+`TEventName` *extends* `string` \| `number` \| `symbol` = keyof `TEventData`
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `eventNames` | `TEventName` \| `TEventName`[] | One or more event names to listen for. |
-| `listener` | [`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\> | The callback to invoke when the event fires. |
-| `filter?` | `TEventData`\[`TEventName`\] | Optional filter to selectively invoke the listener based on event data. |
+#### eventNames
 
-### Returns
+`TEventName` \| `TEventName`[]
 
-An unsubscribe function.
+One or more event names to listen for.
 
-```ts
-(...args: []): void;
-```
+#### listener
 
-#### Parameters
+[`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\>
 
-| Parameter | Type |
-| ------ | ------ |
-| ...`args` | \[\] |
+The callback to invoke when the event fires.
 
-#### Returns
+#### filter?
 
-`void`
+`TEventData`\[`TEventName`\]
+
+Optional filter to selectively invoke the listener based on event data.
+
+### Returns
+
+An unsubscribe function.
+
+(...`args`) => `void`
 
 ### Implementation of
 
@@ -1468,34 +1631,24 @@ An unsubscribe function.
 ### onAny()
 
 ```ts
-onAny(listener: EventAnyListener): (...args: []) => void;
+onAny(listener): (...args) => void;
 ```
 
 Subscribes a wildcard listener that receives all events.
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `listener` | [`EventAnyListener`](#../type-aliases/EventAnyListener) | The callback to invoke for any event. |
-
-### Returns
+#### listener
 
-An unsubscribe function.
+[`EventAnyListener`](#../type-aliases/EventAnyListener)
 
-```ts
-(...args: []): void;
-```
+The callback to invoke for any event.
 
-#### Parameters
-
-| Parameter | Type |
-| ------ | ------ |
-| ...`args` | \[\] |
+### Returns
 
-#### Returns
+An unsubscribe function.
 
-`void`
+(...`args`) => `void`
 
 ### Implementation of
 
@@ -1506,49 +1659,44 @@ An unsubscribe function.
 ### once()
 
 ```ts
-once<TEventName>(eventName: TEventName, listener: EventListener<TEventData[TEventName]>): (...args: []) => void;
+once<TEventName>(eventName, listener): (...args) => void;
 ```
 
 Subscribes a listener that will be invoked only once for the specified event, then automatically removed.
 
 ### Type Parameters
 
-| Type Parameter |
-| ------ |
-| `TEventName` *extends* `string` \| `number` \| `symbol` |
+#### TEventName
+
+`TEventName` *extends* `string` \| `number` \| `symbol`
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `eventName` | `TEventName` | The event to listen for. |
-| `listener` | [`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\> | The callback to invoke once. |
+#### eventName
 
-### Returns
+`TEventName`
 
-An unsubscribe function.
+The event to listen for.
 
-```ts
-(...args: []): void;
-```
+#### listener
 
-#### Parameters
+[`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\>
 
-| Parameter | Type |
-| ------ | ------ |
-| ...`args` | \[\] |
+The callback to invoke once.
 
-#### Returns
+### Returns
 
-`void`
+An unsubscribe function.
+
+(...`args`) => `void`
 
 ### Implementation of
 
 [`EventEmitter`](#../interfaces/EventEmitter).[`once`](../interfaces/EventEmitter.md#once)
 
-### interfaces
+      ### interfaces
 
-  ### <a id="BaseEmitterParamsFields"></a>BaseEmitterParamsFields
+        ### <a id="BaseEmitterParamsFields"></a>BaseEmitterParamsFields
 
 [**@xylabs/events**](#../README)
 
@@ -1556,7 +1704,39 @@ An unsubscribe function.
 
 Fields specific to BaseEmitter configuration parameters.
 
-  ### <a id="EventEmitter"></a>EventEmitter
+        ### <a id="DebugOptions"></a>DebugOptions
+
+[**@xylabs/events**](#../README)
+
+***
+
+Configure debug options of an instance.
+
+## Properties
+
+### enabled?
+
+```ts
+optional enabled?: boolean;
+```
+
+***
+
+### logger?
+
+```ts
+optional logger?: DebugLogger;
+```
+
+***
+
+### name
+
+```ts
+readonly name: string;
+```
+
+        ### <a id="EventEmitter"></a>EventEmitter
 
 [**@xylabs/events**](#../README)
 
@@ -1566,31 +1746,35 @@ Interface for a typed event emitter that supports subscribing, unsubscribing, an
 
 ## Type Parameters
 
-| Type Parameter |
-| ------ |
-| `T` *extends* [`EventData`](#../type-aliases/EventData) |
+### T
+
+`T` *extends* [`EventData`](#../type-aliases/EventData)
 
 ## Properties
 
-| Property | Type | Description |
-| ------ | ------ | ------ |
-| <a id="eventdata"></a> `eventData` | `T` | Type-level reference to the event data shape for external type queries. |
+### eventData
+
+```ts
+eventData: T;
+```
+
+Type-level reference to the event data shape for external type queries.
 
 ## Methods
 
 ### clearListeners()
 
 ```ts
-clearListeners(eventNames: keyof T | keyof T[]): void;
+clearListeners(eventNames): void;
 ```
 
 Removes all listeners for the specified event name(s).
 
 ### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `eventNames` | keyof `T` \| keyof `T`[] |
+#### eventNames
+
+keyof `T` \| keyof `T`[]
 
 ### Returns
 
@@ -1601,23 +1785,26 @@ Removes all listeners for the specified event name(s).
 ### emit()
 
 ```ts
-emit<TEventName>(eventName: TEventName, eventArgs: T[TEventName]): Promise<void>;
+emit<TEventName>(eventName, eventArgs): Promise<void>;
 ```
 
 Emits an event, invoking all registered listeners concurrently.
 
 ### Type Parameters
 
-| Type Parameter |
-| ------ |
-| `TEventName` *extends* `string` \| `number` \| `symbol` |
+#### TEventName
+
+`TEventName` *extends* `string` \| `number` \| `symbol`
 
 ### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `eventName` | `TEventName` |
-| `eventArgs` | `T`\[`TEventName`\] |
+#### eventName
+
+`TEventName`
+
+#### eventArgs
+
+`T`\[`TEventName`\]
 
 ### Returns
 
@@ -1628,23 +1815,26 @@ Emits an event, invoking all registered listeners concurrently.
 ### emitSerial()
 
 ```ts
-emitSerial<TEventName>(eventName: TEventName, eventArgs: T[TEventName]): Promise<void>;
+emitSerial<TEventName>(eventName, eventArgs): Promise<void>;
 ```
 
 Emits an event, invoking all registered listeners sequentially in order.
 
 ### Type Parameters
 
-| Type Parameter |
-| ------ |
-| `TEventName` *extends* `string` \| `number` \| `symbol` |
+#### TEventName
+
+`TEventName` *extends* `string` \| `number` \| `symbol`
 
 ### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `eventName` | `TEventName` |
-| `eventArgs` | `T`\[`TEventName`\] |
+#### eventName
+
+`TEventName`
+
+#### eventArgs
+
+`T`\[`TEventName`\]
 
 ### Returns
 
@@ -1655,16 +1845,16 @@ Emits an event, invoking all registered listeners sequentially in order.
 ### listenerCount()
 
 ```ts
-listenerCount(eventNames: keyof T | keyof T[]): number;
+listenerCount(eventNames): number;
 ```
 
 Returns the total number of listeners registered for the specified event name(s).
 
 ### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `eventNames` | keyof `T` \| keyof `T`[] |
+#### eventNames
+
+keyof `T` \| keyof `T`[]
 
 ### Returns
 
@@ -1675,23 +1865,26 @@ Returns the total number of listeners registered for the specified event name(s)
 ### off()
 
 ```ts
-off<TEventName>(eventNames: TEventName | TEventName[], listener: EventListener<T[TEventName]>): void;
+off<TEventName>(eventNames, listener): void;
 ```
 
 Removes a specific listener from the specified event name(s).
 
 ### Type Parameters
 
-| Type Parameter |
-| ------ |
-| `TEventName` *extends* `string` \| `number` \| `symbol` |
+#### TEventName
+
+`TEventName` *extends* `string` \| `number` \| `symbol`
 
 ### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `eventNames` | `TEventName` \| `TEventName`[] |
-| `listener` | [`EventListener`](#../type-aliases/EventListener)\<`T`\[`TEventName`\]\> |
+#### eventNames
+
+`TEventName` \| `TEventName`[]
+
+#### listener
+
+[`EventListener`](#../type-aliases/EventListener)\<`T`\[`TEventName`\]\>
 
 ### Returns
 
@@ -1702,18 +1895,17 @@ Removes a specific listener from the specified event name(s).
 ### offAny()
 
 ```ts
-offAny(listener: 
-  | Promise<void>
-  | EventAnyListener): void;
+offAny(listener): void;
 ```
 
 Removes a wildcard listener that was receiving all events.
 
 ### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `listener` | \| `Promise`\<`void`\> \| [`EventAnyListener`](#../type-aliases/EventAnyListener) |
+#### listener
+
+  \| `Promise`\<`void`\>
+  \| [`EventAnyListener`](#../type-aliases/EventAnyListener)
 
 ### Returns
 
@@ -1724,23 +1916,26 @@ Removes a wildcard listener that was receiving all events.
 ### on()
 
 ```ts
-on<TEventName>(eventNames: TEventName | TEventName[], listener: EventListener<T[TEventName]>): EventUnsubscribeFunction;
+on<TEventName>(eventNames, listener): EventUnsubscribeFunction;
 ```
 
 Subscribes a listener to the specified event name(s) and returns an unsubscribe function.
 
 ### Type Parameters
 
-| Type Parameter |
-| ------ |
-| `TEventName` *extends* `string` \| `number` \| `symbol` |
+#### TEventName
+
+`TEventName` *extends* `string` \| `number` \| `symbol`
 
 ### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `eventNames` | `TEventName` \| `TEventName`[] |
-| `listener` | [`EventListener`](#../type-aliases/EventListener)\<`T`\[`TEventName`\]\> |
+#### eventNames
+
+`TEventName` \| `TEventName`[]
+
+#### listener
+
+[`EventListener`](#../type-aliases/EventListener)\<`T`\[`TEventName`\]\>
 
 ### Returns
 
@@ -1751,16 +1946,16 @@ Subscribes a listener to the specified event name(s) and returns an unsubscribe
 ### onAny()
 
 ```ts
-onAny(listener: EventAnyListener): EventUnsubscribeFunction;
+onAny(listener): EventUnsubscribeFunction;
 ```
 
 Subscribes a wildcard listener that receives all events and returns an unsubscribe function.
 
 ### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `listener` | [`EventAnyListener`](#../type-aliases/EventAnyListener) |
+#### listener
+
+[`EventAnyListener`](#../type-aliases/EventAnyListener)
 
 ### Returns
 
@@ -1771,31 +1966,122 @@ Subscribes a wildcard listener that receives all events and returns an unsubscri
 ### once()
 
 ```ts
-once<TEventName>(eventName: TEventName, listener: EventListener<T[TEventName]>): EventUnsubscribeFunction;
+once<TEventName>(eventName, listener): EventUnsubscribeFunction;
 ```
 
 Subscribes a listener that will be invoked only once for the specified event, then automatically removed.
 
 ### Type Parameters
 
-| Type Parameter |
-| ------ |
-| `TEventName` *extends* `string` \| `number` \| `symbol` |
+#### TEventName
+
+`TEventName` *extends* `string` \| `number` \| `symbol`
 
 ### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `eventName` | `TEventName` |
-| `listener` | [`EventListener`](#../type-aliases/EventListener)\<`T`\[`TEventName`\]\> |
+#### eventName
+
+`TEventName`
+
+#### listener
+
+[`EventListener`](#../type-aliases/EventListener)\<`T`\[`TEventName`\]\>
 
 ### Returns
 
 [`EventUnsubscribeFunction`](#../type-aliases/EventUnsubscribeFunction)
 
-### type-aliases
+        ### <a id="EventListenerInfo"></a>EventListenerInfo
+
+[**@xylabs/events**](#../README)
+
+***
+
+Information about a registered event listener, including an optional filter for selective invocation.
+
+## Type Parameters
+
+### TEventArgs
+
+`TEventArgs` *extends* [`EventArgs`](#../type-aliases/EventArgs) = [`EventArgs`](#../type-aliases/EventArgs)
 
-  ### <a id="BaseEmitterParams"></a>BaseEmitterParams
+## Properties
+
+### filter?
+
+```ts
+optional filter?: TEventArgs;
+```
+
+***
+
+### listener
+
+```ts
+listener: EventListener<TEventArgs>;
+```
+
+        ### <a id="MetaEventData"></a>MetaEventData
+
+[**@xylabs/events**](#../README)
+
+***
+
+Data shape for internal meta events that fire when listeners are added or removed.
+
+## Type Parameters
+
+### TEventData
+
+`TEventData` *extends* [`EventData`](#../type-aliases/EventData)
+
+## Properties
+
+### listenerAdded
+
+```ts
+listenerAdded: object;
+```
+
+### eventName?
+
+```ts
+optional eventName?: keyof TEventData;
+```
+
+### listener
+
+```ts
+listener: 
+  | EventListener<TEventData[keyof TEventData]>
+| EventAnyListener<TEventData[keyof TEventData]>;
+```
+
+***
+
+### listenerRemoved
+
+```ts
+listenerRemoved: object;
+```
+
+### eventName?
+
+```ts
+optional eventName?: keyof TEventData;
+```
+
+### listener
+
+```ts
+listener: 
+  | EventListener<TEventData[keyof TEventData]>
+| EventAnyListener<TEventData[keyof TEventData]>;
+```
+
+      ### type-aliases
+
+        ### <a id="BaseEmitterParams"></a>BaseEmitterParams
 
 [**@xylabs/events**](#../README)
 
@@ -1809,18 +2095,18 @@ Parameters type for configuring a BaseEmitter instance.
 
 ## Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `T` *extends* `EmptyObject` | `EmptyObject` |
+### T
 
-  ### <a id="DebugLogger"></a>DebugLogger
+`T` *extends* `EmptyObject` = `EmptyObject`
+
+        ### <a id="DebugLogger"></a>DebugLogger
 
 [**@xylabs/events**](#../README)
 
 ***
 
 ```ts
-type DebugLogger = (type: string, debugName: string, eventName?: EventName, eventData?: EventArgs) => void;
+type DebugLogger = (type, debugName, eventName?, eventData?) => void;
 ```
 
 Emittery can collect and log debug information.
@@ -1832,71 +2118,63 @@ See API for more information on how debugging works.
 
 ## Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `type` | `string` |
-| `debugName` | `string` |
-| `eventName?` | [`EventName`](#EventName) |
-| `eventData?` | [`EventArgs`](#EventArgs) |
+### type
 
-## Returns
+`string`
 
-`void`
+### debugName
 
-  ### <a id="DebugOptions"></a>DebugOptions
+`string`
 
-[**@xylabs/events**](#../README)
+### eventName?
 
-***
+[`EventName`](#EventName)
 
-```ts
-type DebugOptions = {
-  enabled?: boolean;
-  logger?: DebugLogger;
-  name: string;
-};
-```
+### eventData?
 
-Configure debug options of an instance.
+[`EventArgs`](#EventArgs)
 
-## Properties
+## Returns
 
-| Property | Modifier | Type |
-| ------ | ------ | ------ |
-| <a id="enabled"></a> `enabled?` | `public` | `boolean` |
-| <a id="logger"></a> `logger?` | `public` | [`DebugLogger`](#DebugLogger) |
-| <a id="name"></a> `name` | `readonly` | `string` |
+`void`
 
-  ### <a id="EventAnyListener"></a>EventAnyListener
+        ### <a id="EventAnyListener"></a>EventAnyListener
 
 [**@xylabs/events**](#../README)
 
 ***
 
 ```ts
-type EventAnyListener<TEventArgs> = (eventName: EventName, eventData: TEventArgs) => Promisable<void>;
+type EventAnyListener<TEventArgs> = (eventName, eventData) => Promisable<void>;
 ```
 
 A listener that receives all events regardless of name.
 
 ## Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TEventArgs` *extends* [`EventArgs`](#EventArgs) | [`EventArgs`](#EventArgs) |
+### TEventArgs
+
+`TEventArgs` *extends* [`EventArgs`](#EventArgs) = [`EventArgs`](#EventArgs)
 
 ## Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `eventName` | [`EventName`](#EventName) | The name of the emitted event. |
-| `eventData` | `TEventArgs` | The data associated with the event. |
+### eventName
+
+[`EventName`](#EventName)
+
+The name of the emitted event.
+
+### eventData
+
+`TEventArgs`
+
+The data associated with the event.
 
 ## Returns
 
 `Promisable`\<`void`\>
 
-  ### <a id="EventArgs"></a>EventArgs
+        ### <a id="EventArgs"></a>EventArgs
 
 [**@xylabs/events**](#../README)
 
@@ -1908,83 +2186,49 @@ type EventArgs = string | number | object;
 
 The allowed types for event argument payloads.
 
-  ### <a id="EventData"></a>EventData
+        ### <a id="EventData"></a>EventData
 
 [**@xylabs/events**](#../README)
 
 ***
 
 ```ts
-type EventData = {
-[key: string | number | symbol]: EventArgs;
-};
+type EventData = Record<EventName, EventArgs>;
 ```
 
 A mapping of event names to their corresponding event argument types.
 
-## Index Signature
-
-```ts
-[key: string | number | symbol]: EventArgs
-```
-
-  ### <a id="EventListener"></a>EventListener
+        ### <a id="EventListener"></a>EventListener
 
 [**@xylabs/events**](#../README)
 
 ***
 
 ```ts
-type EventListener<TEventArgs> = (eventData: TEventArgs) => Promisable<void>;
+type EventListener<TEventArgs> = (eventData) => Promisable<void>;
 ```
 
 A listener for a specific event type.
 
 ## Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TEventArgs` *extends* [`EventArgs`](#EventArgs) | [`EventArgs`](#EventArgs) |
-
-## Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `eventData` | `TEventArgs` | The data associated with the event. |
-
-## Returns
-
-`Promisable`\<`void`\>
-
-  ### <a id="EventListenerInfo"></a>EventListenerInfo
+### TEventArgs
 
-[**@xylabs/events**](#../README)
+`TEventArgs` *extends* [`EventArgs`](#EventArgs) = [`EventArgs`](#EventArgs)
 
-***
-
-```ts
-type EventListenerInfo<TEventArgs> = {
-  filter?: TEventArgs;
-  listener: EventListener<TEventArgs>;
-};
-```
+## Parameters
 
-Information about a registered event listener, including an optional filter for selective invocation.
+### eventData
 
-## Type Parameters
+`TEventArgs`
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TEventArgs` *extends* [`EventArgs`](#EventArgs) | [`EventArgs`](#EventArgs) |
+The data associated with the event.
 
-## Properties
+## Returns
 
-| Property | Type |
-| ------ | ------ |
-| <a id="filter"></a> `filter?` | `TEventArgs` |
-| <a id="listener"></a> `listener` | [`EventListener`](#EventListener)\<`TEventArgs`\> |
+`Promisable`\<`void`\>
 
-  ### <a id="EventName"></a>EventName
+        ### <a id="EventName"></a>EventName
 
 [**@xylabs/events**](#../README)
 
@@ -1996,7 +2240,7 @@ type EventName = PropertyKey;
 
 A valid event name, which can be any property key (string, number, or symbol).
 
-  ### <a id="EventUnsubscribeFunction"></a>EventUnsubscribeFunction
+        ### <a id="EventUnsubscribeFunction"></a>EventUnsubscribeFunction
 
 [**@xylabs/events**](#../README)
 
@@ -2012,7 +2256,7 @@ A function returned by event subscription methods that unsubscribes the listener
 
 `void`
 
-  ### <a id="EventsParams"></a>EventsParams
+        ### <a id="EventsParams"></a>EventsParams
 
 [**@xylabs/events**](#../README)
 
@@ -2026,82 +2270,8 @@ type EventsParams = BaseParams<{
 
 Parameters for constructing an Events instance, with optional debug configuration.
 
-  ### <a id="MetaEventData"></a>MetaEventData
 
-[**@xylabs/events**](#../README)
-
-***
-
-```ts
-type MetaEventData<TEventData> = {
-  listenerAdded: {
-     eventName?: keyof TEventData;
-     listener:   | EventListener<TEventData[keyof TEventData]>
-        | EventAnyListener<TEventData[keyof TEventData]>;
-  };
-  listenerRemoved: {
-     eventName?: keyof TEventData;
-     listener:   | EventListener<TEventData[keyof TEventData]>
-        | EventAnyListener<TEventData[keyof TEventData]>;
-  };
-};
-```
-
-Data shape for internal meta events that fire when listeners are added or removed.
-
-## Type Parameters
-
-| Type Parameter |
-| ------ |
-| `TEventData` *extends* [`EventData`](#EventData) |
-
-## Properties
-
-| Property | Type |
-| ------ | ------ |
-| <a id="listeneradded"></a> `listenerAdded` | \{ `eventName?`: keyof `TEventData`; `listener`: \| [`EventListener`](#EventListener)\<`TEventData`\[keyof `TEventData`\]\> \| [`EventAnyListener`](#EventAnyListener)\<`TEventData`\[keyof `TEventData`\]\>; \} |
-| `listenerAdded.eventName?` | keyof `TEventData` |
-| `listenerAdded.listener` | \| [`EventListener`](#EventListener)\<`TEventData`\[keyof `TEventData`\]\> \| [`EventAnyListener`](#EventAnyListener)\<`TEventData`\[keyof `TEventData`\]\> |
-| <a id="listenerremoved"></a> `listenerRemoved` | \{ `eventName?`: keyof `TEventData`; `listener`: \| [`EventListener`](#EventListener)\<`TEventData`\[keyof `TEventData`\]\> \| [`EventAnyListener`](#EventAnyListener)\<`TEventData`\[keyof `TEventData`\]\>; \} |
-| `listenerRemoved.eventName?` | keyof `TEventData` |
-| `listenerRemoved.listener` | \| [`EventListener`](#EventListener)\<`TEventData`\[keyof `TEventData`\]\> \| [`EventAnyListener`](#EventAnyListener)\<`TEventData`\[keyof `TEventData`\]\> |
-
-
-Part of [sdk-js](https://www.npmjs.com/package/@xyo-network/sdk-js)
-
-## Maintainers
-
--   [Arie Trouw](https://github.com/arietrouw) ([arietrouw.com](https://arietrouw.com))
--   [Matt Jones](https://github.com/jonesmac)
--   [Joel Carter](https://github.com/JoelBCarter)
--   [Jordan Trouw](https://github.com/jordantrouw)
-
-## License
-
-> See the [LICENSE](LICENSE) file for license details
-
-## Credits
-
-[Made with 🔥 and ❄️ by XYLabs](https://xylabs.com)
-
-[logo]: https://cdn.xy.company/img/brand/XYPersistentCompany_Logo_Icon_Colored.svg
-
-[main-build]: https://github.com/xylabs/sdk-js/actions/workflows/build.yml/badge.svg
-[main-build-link]: https://github.com/xylabs/sdk-js/actions/workflows/build.yml
 [npm-badge]: https://img.shields.io/npm/v/@xylabs/events.svg
 [npm-link]: https://www.npmjs.com/package/@xylabs/events
-[codacy-badge]: https://app.codacy.com/project/badge/Grade/c8e15e14f37741c18cfb47ac7245c698
-[codacy-link]: https://www.codacy.com/gh/xylabs/sdk-js/dashboard?utm_source=github.com&utm_medium=referral&utm_content=xylabs/sdk-js&utm_campaign=Badge_Grade
-[codeclimate-badge]: https://api.codeclimate.com/v1/badges/c5eb068f806f0b047ea7/maintainability
-[codeclimate-link]: https://codeclimate.com/github/xylabs/sdk-js/maintainability
-[snyk-badge]: https://snyk.io/test/github/xylabs/sdk-js/badge.svg?targetFile=package.json
-[snyk-link]: https://snyk.io/test/github/xylabs/sdk-js?targetFile=package.json
-
-[npm-downloads-badge]: https://img.shields.io/npm/dw/@xylabs/events
-[npm-license-badge]: https://img.shields.io/npm/l/@xylabs/events
-
-[jsdelivr-badge]: https://data.jsdelivr.com/v1/package/npm/@xylabs/events/badge
-[jsdelivr-link]: https://www.jsdelivr.com/package/npm/@xylabs/events
-
-[socket-badge]: https://socket.dev/api/badge/npm/package/@xylabs/events
-[socket-link]: https://socket.dev/npm/package/@xylabs/events
+[license-badge]: https://img.shields.io/npm/l/@xylabs/events.svg
+[license-link]: https://github.com/xylabs/sdk-js/blob/main/LICENSE