@xylabs/events 5.0.83 → 5.0.86

package/README.md

@@ -15,6 +15,8 @@
 
 Base functionality used throughout XY Labs TypeScript/JavaScript libraries
 
+
+
 ## Reference
 
 **@xylabs/events**
@@ -23,28 +25,34 @@ Base functionality used throughout XY Labs TypeScript/JavaScript libraries
 
 ## Classes
 
-- [BaseEmitter](#classes/BaseEmitter)
-- [Events](#classes/Events)
+| 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. |
 
 ## Interfaces
 
-- [BaseEmitterParamsFields](#interfaces/BaseEmitterParamsFields)
-- [EventEmitter](#interfaces/EventEmitter)
+| 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. |
 
 ## Type Aliases
 
-- [BaseEmitterParams](#type-aliases/BaseEmitterParams)
-- [DebugLogger](#type-aliases/DebugLogger)
-- [EventListenerInfo](#type-aliases/EventListenerInfo)
-- [DebugOptions](#type-aliases/DebugOptions)
-- [MetaEventData](#type-aliases/MetaEventData)
-- [EventsParams](#type-aliases/EventsParams)
-- [EventName](#type-aliases/EventName)
-- [EventArgs](#type-aliases/EventArgs)
-- [EventData](#type-aliases/EventData)
-- [EventUnsubscribeFunction](#type-aliases/EventUnsubscribeFunction)
-- [EventAnyListener](#type-aliases/EventAnyListener)
-- [EventListener](#type-aliases/EventListener)
+| 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. |
 
 ### classes
 
@@ -54,19 +62,19 @@ Base functionality used throughout XY Labs TypeScript/JavaScript libraries
 
 ***
 
+Base class that combines the Base utility class with typed event emission capabilities.
+Delegates all event operations to an internal Events instance.
+
 ## Extends
 
 - `Base`\<`TParams`\>
 
 ## Type Parameters
 
-### TParams
-
-`TParams` *extends* `BaseParams` = `BaseParams`
-
-### TEventData
-
-`TEventData` *extends* [`EventData`](#../type-aliases/EventData) = [`EventData`](#../type-aliases/EventData)
+| Type Parameter | Default type |
+| ------ | ------ |
+| `TParams` *extends* `BaseParams` | `BaseParams` |
+| `TEventData` *extends* [`EventData`](#../type-aliases/EventData) | [`EventData`](#../type-aliases/EventData) |
 
 ## Implements
 
@@ -77,14 +85,14 @@ Base functionality used throughout XY Labs TypeScript/JavaScript libraries
 ### Constructor
 
 ```ts
-new BaseEmitter<TParams, TEventData>(params): BaseEmitter<TParams, TEventData>;
+new BaseEmitter<TParams, TEventData>(params: BaseParams<TParams>): BaseEmitter<TParams, TEventData>;
 ```
 
 ### Parameters
 
-#### params
-
-`BaseParams`\<`TParams`\>
+| Parameter | Type |
+| ------ | ------ |
+| `params` | `BaseParams`\<`TParams`\> |
 
 ### Returns
 
@@ -98,57 +106,12 @@ Base<TParams>.constructor
 
 ## Properties
 
-### 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;
-```
-
-### Implementation of
-
-[`EventEmitter`](#../interfaces/EventEmitter).[`eventData`](../interfaces/EventEmitter.md#eventdata)
+| 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. | - |
 
 ## Accessors
 
@@ -167,14 +130,14 @@ get static historyInterval(): number;
 ### Set Signature
 
 ```ts
-set static historyInterval(value): void;
+set static historyInterval(value: number): void;
 ```
 
 #### Parameters
 
-##### value
-
-`number`
+| Parameter | Type |
+| ------ | ------ |
+| `value` | `number` |
 
 #### Returns
 
@@ -203,14 +166,14 @@ get static historyTime(): number;
 ### Set Signature
 
 ```ts
-set static historyTime(value): void;
+set static historyTime(value: number): void;
 ```
 
 #### Parameters
 
-##### value
-
-`number`
+| Parameter | Type |
+| ------ | ------ |
+| `value` | `number` |
 
 #### Returns
 
@@ -239,14 +202,14 @@ get static maxGcFrequency(): number;
 ### Set Signature
 
 ```ts
-set static maxGcFrequency(value): void;
+set static maxGcFrequency(value: number): void;
 ```
 
 #### Parameters
 
-##### value
-
-`number`
+| Parameter | Type |
+| ------ | ------ |
+| `value` | `number` |
 
 #### Returns
 
@@ -365,14 +328,14 @@ Base.tracer
 ### Call Signature
 
 ```ts
-static gc(force?): void;
+static gc(force?: boolean): void;
 ```
 
 #### Parameters
 
-##### force?
-
-`boolean`
+| Parameter | Type |
+| ------ | ------ |
+| `force?` | `boolean` |
 
 #### Returns
 
@@ -387,14 +350,14 @@ Base.gc
 ### Call Signature
 
 ```ts
-static gc(className): void;
+static gc(className: BaseClassName): void;
 ```
 
 #### Parameters
 
-##### className
-
-`BaseClassName`
+| Parameter | Type |
+| ------ | ------ |
+| `className` | `BaseClassName` |
 
 #### Returns
 
@@ -411,14 +374,14 @@ Base.gc
 ### instanceCount()
 
 ```ts
-static instanceCount(className): number;
+static instanceCount(className: BaseClassName): number;
 ```
 
 ### Parameters
 
-#### className
-
-`BaseClassName`
+| Parameter | Type |
+| ------ | ------ |
+| `className` | `BaseClassName` |
 
 ### Returns
 
@@ -489,19 +452,23 @@ Base.stopHistory
 ### clearListeners()
 
 ```ts
-clearListeners(eventNames): BaseEmitter<TParams, TEventData>;
+clearListeners(eventNames: keyof TEventData | keyof TEventData[]): BaseEmitter<TParams, TEventData>;
 ```
 
-### Parameters
+Removes all listeners for the specified event name(s).
 
-#### eventNames
+### Parameters
 
-keyof `TEventData` | keyof `TEventData`[]
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `eventNames` | keyof `TEventData` \| keyof `TEventData`[] | One or more event names to clear listeners for. |
 
 ### Returns
 
 `BaseEmitter`\<`TParams`, `TEventData`\>
 
+This instance for chaining.
+
 ### Implementation of
 
 [`EventEmitter`](#../interfaces/EventEmitter).[`clearListeners`](../interfaces/EventEmitter.md#clearlisteners)
@@ -511,28 +478,24 @@ keyof `TEventData` | keyof `TEventData`[]
 ### emit()
 
 ```ts
-emit<TEventName, TEventArgs>(eventName, eventArgs): Promise<void>;
+emit<TEventName, TEventArgs>(eventName: TEventName, eventArgs: TEventArgs): Promise<void>;
 ```
 
-### Type Parameters
-
-#### TEventName
-
-`TEventName` *extends* `string` \| `number` \| `symbol` = keyof `TEventData`
+Emits an event, invoking all registered listeners concurrently.
 
-#### TEventArgs
+### Type Parameters
 
-`TEventArgs` *extends* [`EventArgs`](#../type-aliases/EventArgs) = `TEventData`\[`TEventName`\]
+| Type Parameter | Default type |
+| ------ | ------ |
+| `TEventName` *extends* `string` \| `number` \| `symbol` | keyof `TEventData` |
+| `TEventArgs` *extends* [`EventArgs`](#../type-aliases/EventArgs) | `TEventData`\[`TEventName`\] |
 
 ### Parameters
 
-#### eventName
-
-`TEventName`
-
-#### eventArgs
-
-`TEventArgs`
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `eventName` | `TEventName` | The event to emit. |
+| `eventArgs` | `TEventArgs` | The data to pass to listeners. |
 
 ### Returns
 
@@ -547,28 +510,24 @@ emit<TEventName, TEventArgs>(eventName, eventArgs): Promise<void>;
 ### emitSerial()
 
 ```ts
-emitSerial<TEventName, TEventArgs>(eventName, eventArgs): Promise<void>;
+emitSerial<TEventName, TEventArgs>(eventName: TEventName, eventArgs: TEventArgs): Promise<void>;
 ```
 
-### Type Parameters
-
-#### TEventName
-
-`TEventName` *extends* `string` \| `number` \| `symbol` = keyof `TEventData`
+Emits an event, invoking all registered listeners sequentially in order.
 
-#### TEventArgs
+### Type Parameters
 
-`TEventArgs` *extends* [`EventArgs`](#../type-aliases/EventArgs) = `TEventData`\[`TEventName`\]
+| Type Parameter | Default type |
+| ------ | ------ |
+| `TEventName` *extends* `string` \| `number` \| `symbol` | keyof `TEventData` |
+| `TEventArgs` *extends* [`EventArgs`](#../type-aliases/EventArgs) | `TEventData`\[`TEventName`\] |
 
 ### Parameters
 
-#### eventName
-
-`TEventName`
-
-#### eventArgs
-
-`TEventArgs`
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `eventName` | `TEventName` | The event to emit. |
+| `eventArgs` | `TEventArgs` | The data to pass to listeners. |
 
 ### Returns
 
@@ -583,19 +542,23 @@ emitSerial<TEventName, TEventArgs>(eventName, eventArgs): Promise<void>;
 ### listenerCount()
 
 ```ts
-listenerCount(eventNames): number;
+listenerCount(eventNames: keyof TEventData | keyof TEventData[]): number;
 ```
 
-### Parameters
+Returns the total number of listeners registered for the specified event name(s).
 
-#### eventNames
+### Parameters
 
-keyof `TEventData` | keyof `TEventData`[]
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `eventNames` | keyof `TEventData` \| keyof `TEventData`[] | One or more event names to count listeners for. |
 
 ### Returns
 
 `number`
 
+The total listener count.
+
 ### Implementation of
 
 [`EventEmitter`](#../interfaces/EventEmitter).[`listenerCount`](../interfaces/EventEmitter.md#listenercount)
@@ -605,24 +568,23 @@ keyof `TEventData` | keyof `TEventData`[]
 ### off()
 
 ```ts
-off<TEventName>(eventNames, listener): void;
+off<TEventName>(eventNames: TEventName | TEventName[], listener: EventListener<TEventData[TEventName]>): void;
 ```
 
-### Type Parameters
+Removes a specific listener from the specified event name(s).
 
-#### TEventName
+### Type Parameters
 
-`TEventName` *extends* `string` \| `number` \| `symbol`
+| Type Parameter |
+| ------ |
+| `TEventName` *extends* `string` \| `number` \| `symbol` |
 
 ### Parameters
 
-#### eventNames
-
-`TEventName` | `TEventName`[]
-
-#### listener
-
-[`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\>
+| 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. |
 
 ### Returns
 
@@ -637,14 +599,16 @@ off<TEventName>(eventNames, listener): void;
 ### offAny()
 
 ```ts
-offAny(listener): void;
+offAny(listener: EventAnyListener): void;
 ```
 
-### Parameters
+Removes a wildcard listener that was receiving all events.
 
-#### listener
+### Parameters
 
-[`EventAnyListener`](#../type-aliases/EventAnyListener)
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `listener` | [`EventAnyListener`](#../type-aliases/EventAnyListener) | The wildcard listener to remove. |
 
 ### Returns
 
@@ -659,36 +623,37 @@ offAny(listener): void;
 ### on()
 
 ```ts
-on<TEventName>(eventNames, listener): (...args) => void;
+on<TEventName>(eventNames: TEventName | TEventName[], listener: EventListener<TEventData[TEventName]>): (...args: []) => void;
 ```
 
-### Type Parameters
+Subscribes a listener to the specified event name(s).
 
-#### TEventName
+### Type Parameters
 
-`TEventName` *extends* `string` \| `number` \| `symbol`
+| Type Parameter |
+| ------ |
+| `TEventName` *extends* `string` \| `number` \| `symbol` |
 
 ### Parameters
 
-#### eventNames
-
-`TEventName` | `TEventName`[]
-
-#### listener
-
-[`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\>
+| 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. |
 
 ### Returns
 
+An unsubscribe function.
+
 ```ts
-(...args): void;
+(...args: []): void;
 ```
 
 #### Parameters
 
-##### args
-
-...\[\]
+| Parameter | Type |
+| ------ | ------ |
+| ...`args` | \[\] |
 
 #### Returns
 
@@ -703,26 +668,30 @@ on<TEventName>(eventNames, listener): (...args) => void;
 ### onAny()
 
 ```ts
-onAny(listener): (...args) => void;
+onAny(listener: EventAnyListener): (...args: []) => void;
 ```
 
-### Parameters
+Subscribes a wildcard listener that receives all events.
 
-#### listener
+### Parameters
 
-[`EventAnyListener`](#../type-aliases/EventAnyListener)
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `listener` | [`EventAnyListener`](#../type-aliases/EventAnyListener) | The callback to invoke for any event. |
 
 ### Returns
 
+An unsubscribe function.
+
 ```ts
-(...args): void;
+(...args: []): void;
 ```
 
 #### Parameters
 
-##### args
-
-...\[\]
+| Parameter | Type |
+| ------ | ------ |
+| ...`args` | \[\] |
 
 #### Returns
 
@@ -737,36 +706,37 @@ onAny(listener): (...args) => void;
 ### once()
 
 ```ts
-once<TEventName>(eventName, listener): (...args) => void;
+once<TEventName>(eventName: TEventName, listener: EventListener<TEventData[TEventName]>): (...args: []) => void;
 ```
 
-### Type Parameters
+Subscribes a listener that will be invoked only once for the specified event, then automatically removed.
 
-#### TEventName
+### Type Parameters
 
-`TEventName` *extends* `string` \| `number` \| `symbol`
+| Type Parameter |
+| ------ |
+| `TEventName` *extends* `string` \| `number` \| `symbol` |
 
 ### Parameters
 
-#### eventName
-
-`TEventName`
-
-#### listener
-
-[`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\>
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `eventName` | `TEventName` | The event to listen for. |
+| `listener` | [`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\> | The callback to invoke once. |
 
 ### Returns
 
+An unsubscribe function.
+
 ```ts
-(...args): void;
+(...args: []): void;
 ```
 
 #### Parameters
 
-##### args
-
-...\[\]
+| Parameter | Type |
+| ------ | ------ |
+| ...`args` | \[\] |
 
 #### Returns
 
@@ -782,15 +752,18 @@ once<TEventName>(eventName, listener): (...args) => void;
 
 ***
 
+Core typed event emitter implementation supporting named events, wildcard listeners,
+serial and concurrent emission, listener filtering, and debug logging.
+
 ## Extends
 
 - `Base`\<[`EventsParams`](#../type-aliases/EventsParams)\>
 
 ## Type Parameters
 
-### TEventData
-
-`TEventData` *extends* [`EventData`](#../type-aliases/EventData) = [`EventData`](#../type-aliases/EventData)
+| Type Parameter | Default type |
+| ------ | ------ |
+| `TEventData` *extends* [`EventData`](#../type-aliases/EventData) | [`EventData`](#../type-aliases/EventData) |
 
 ## Implements
 
@@ -801,14 +774,14 @@ once<TEventName>(eventName, listener): (...args) => void;
 ### Constructor
 
 ```ts
-new Events<TEventData>(params?): Events<TEventData>;
+new Events<TEventData>(params?: EventsParams): Events<TEventData>;
 ```
 
 ### Parameters
 
-#### params?
-
-[`EventsParams`](#../type-aliases/EventsParams) = `{}`
+| Parameter | Type |
+| ------ | ------ |
+| `params` | [`EventsParams`](#../type-aliases/EventsParams) |
 
 ### Returns
 
@@ -822,73 +795,14 @@ Base<EventsParams>.constructor
 
 ## Properties
 
-### 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;
-```
-
-### Implementation of
-
-[`EventEmitter`](#../interfaces/EventEmitter).[`eventData`](../interfaces/EventEmitter.md#eventdata)
+| 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. | - |
 
 ## Accessors
 
@@ -907,14 +821,14 @@ get static historyInterval(): number;
 ### Set Signature
 
 ```ts
-set static historyInterval(value): void;
+set static historyInterval(value: number): void;
 ```
 
 #### Parameters
 
-##### value
-
-`number`
+| Parameter | Type |
+| ------ | ------ |
+| `value` | `number` |
 
 #### Returns
 
@@ -943,14 +857,14 @@ get static historyTime(): number;
 ### Set Signature
 
 ```ts
-set static historyTime(value): void;
+set static historyTime(value: number): void;
 ```
 
 #### Parameters
 
-##### value
-
-`number`
+| Parameter | Type |
+| ------ | ------ |
+| `value` | `number` |
 
 #### Returns
 
@@ -979,14 +893,14 @@ get static maxGcFrequency(): number;
 ### Set Signature
 
 ```ts
-set static maxGcFrequency(value): void;
+set static maxGcFrequency(value: number): void;
 ```
 
 #### Parameters
 
-##### value
-
-`number`
+| Parameter | Type |
+| ------ | ------ |
+| `value` | `number` |
 
 #### Returns
 
@@ -1108,6 +1022,8 @@ Base.tracer
 get static isDebugEnabled(): boolean;
 ```
 
+Whether debug mode is enabled globally or via the DEBUG environment variable.
+
 #### Returns
 
 `boolean`
@@ -1115,14 +1031,14 @@ get static isDebugEnabled(): boolean;
 ### Set Signature
 
 ```ts
-set static isDebugEnabled(newValue): void;
+set static isDebugEnabled(newValue: boolean): void;
 ```
 
 #### Parameters
 
-##### newValue
-
-`boolean`
+| Parameter | Type |
+| ------ | ------ |
+| `newValue` | `boolean` |
 
 #### Returns
 
@@ -1138,6 +1054,8 @@ set static isDebugEnabled(newValue): void;
 get debug(): DebugOptions | undefined;
 ```
 
+The debug configuration for this instance, if provided.
+
 #### Returns
 
 [`DebugOptions`](#../type-aliases/DebugOptions) \| `undefined`
@@ -1149,14 +1067,14 @@ get debug(): DebugOptions | undefined;
 ### Call Signature
 
 ```ts
-static gc(force?): void;
+static gc(force?: boolean): void;
 ```
 
 #### Parameters
 
-##### force?
-
-`boolean`
+| Parameter | Type |
+| ------ | ------ |
+| `force?` | `boolean` |
 
 #### Returns
 
@@ -1171,14 +1089,14 @@ Base.gc
 ### Call Signature
 
 ```ts
-static gc(className): void;
+static gc(className: BaseClassName): void;
 ```
 
 #### Parameters
 
-##### className
-
-`BaseClassName`
+| Parameter | Type |
+| ------ | ------ |
+| `className` | `BaseClassName` |
 
 #### Returns
 
@@ -1195,14 +1113,14 @@ Base.gc
 ### instanceCount()
 
 ```ts
-static instanceCount(className): number;
+static instanceCount(className: BaseClassName): number;
 ```
 
 ### Parameters
 
-#### className
-
-`BaseClassName`
+| Parameter | Type |
+| ------ | ------ |
+| `className` | `BaseClassName` |
 
 ### Returns
 
@@ -1273,14 +1191,16 @@ Base.stopHistory
 ### clearListeners()
 
 ```ts
-clearListeners(eventNames): void;
+clearListeners(eventNames: keyof TEventData | keyof TEventData[]): void;
 ```
 
-### Parameters
+Removes all listeners for the specified event name(s).
 
-#### eventNames
+### Parameters
 
-keyof `TEventData` | keyof `TEventData`[]
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `eventNames` | keyof `TEventData` \| keyof `TEventData`[] | One or more event names to clear listeners for. |
 
 ### Returns
 
@@ -1295,24 +1215,23 @@ keyof `TEventData` | keyof `TEventData`[]
 ### emit()
 
 ```ts
-emit<TEventName>(eventName, eventArgs): Promise<void>;
+emit<TEventName>(eventName: TEventName, eventArgs: TEventData[TEventName]): Promise<void>;
 ```
 
-### Type Parameters
+Emits an event, invoking all registered listeners concurrently.
 
-#### TEventName
+### Type Parameters
 
-`TEventName` *extends* `string` \| `number` \| `symbol`
+| Type Parameter |
+| ------ |
+| `TEventName` *extends* `string` \| `number` \| `symbol` |
 
 ### Parameters
 
-#### eventName
-
-`TEventName`
-
-#### eventArgs
-
-`TEventData`\[`TEventName`\]
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `eventName` | `TEventName` | The event to emit. |
+| `eventArgs` | `TEventData`\[`TEventName`\] | The data to pass to listeners. |
 
 ### Returns
 
@@ -1327,52 +1246,52 @@ emit<TEventName>(eventName, eventArgs): Promise<void>;
 ### emitMetaEvent()
 
 ```ts
-emitMetaEvent<TEventName>(eventName, eventArgs): Promise<boolean | undefined>;
+emitMetaEvent<TEventName>(eventName: TEventName, eventArgs: MetaEventData<TEventData>[TEventName]): Promise<boolean | undefined>;
 ```
 
-### Type Parameters
+Emits an internal meta event (listenerAdded or listenerRemoved).
 
-#### TEventName
+### Type Parameters
 
-`TEventName` *extends* keyof [`MetaEventData`](#../type-aliases/MetaEventData)\<`TEventData`\>
+| Type Parameter |
+| ------ |
+| `TEventName` *extends* keyof [`MetaEventData`](#../type-aliases/MetaEventData)\<`TEventData`\> |
 
 ### Parameters
 
-#### eventName
-
-`TEventName`
-
-#### eventArgs
-
-[`MetaEventData`](#../type-aliases/MetaEventData)\<`TEventData`\>\[`TEventName`\]
+| 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. |
 
 ### Returns
 
 `Promise`\<`boolean` \| `undefined`\>
 
+True if the meta event was emitted successfully.
+
 ***
 
 ### emitSerial()
 
 ```ts
-emitSerial<TEventName>(eventName, eventArgs): Promise<void>;
+emitSerial<TEventName>(eventName: TEventName, eventArgs: TEventData[TEventName]): Promise<void>;
 ```
 
-### Type Parameters
+Emits an event, invoking all registered listeners sequentially in order.
 
-#### TEventName
+### Type Parameters
 
-`TEventName` *extends* `string` \| `number` \| `symbol`
+| Type Parameter |
+| ------ |
+| `TEventName` *extends* `string` \| `number` \| `symbol` |
 
 ### Parameters
 
-#### eventName
-
-`TEventName`
-
-#### eventArgs
-
-`TEventData`\[`TEventName`\]
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `eventName` | `TEventName` | The event to emit. |
+| `eventArgs` | `TEventData`\[`TEventName`\] | The data to pass to listeners. |
 
 ### Returns
 
@@ -1387,19 +1306,23 @@ emitSerial<TEventName>(eventName, eventArgs): Promise<void>;
 ### listenerCount()
 
 ```ts
-listenerCount(eventNames?): number;
+listenerCount(eventNames?: keyof TEventData | keyof TEventData[]): number;
 ```
 
-### Parameters
+Returns the total number of listeners registered for the specified event name(s).
 
-#### eventNames?
+### Parameters
 
-keyof `TEventData` | keyof `TEventData`[]
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `eventNames?` | keyof `TEventData` \| keyof `TEventData`[] | One or more event names to count listeners for. |
 
 ### Returns
 
 `number`
 
+The total listener count.
+
 ### Implementation of
 
 [`EventEmitter`](#../interfaces/EventEmitter).[`listenerCount`](../interfaces/EventEmitter.md#listenercount)
@@ -1410,30 +1333,26 @@ keyof `TEventData` | keyof `TEventData`[]
 
 ```ts
 logIfDebugEnabled<TEventName>(
-   type, 
-   eventName?, 
-   eventArgs?): void;
+   type: string, 
+   eventName?: TEventName, 
+   eventArgs?: EventArgs): void;
 ```
 
-### Type Parameters
+Logs debug information if debug mode is enabled.
 
-#### TEventName
+### Type Parameters
 
-`TEventName` *extends* `PropertyKey`
+| Type Parameter |
+| ------ |
+| `TEventName` *extends* `PropertyKey` |
 
 ### Parameters
 
-#### type
-
-`string`
-
-#### eventName?
-
-`TEventName`
-
-#### eventArgs?
-
-[`EventArgs`](#../type-aliases/EventArgs)
+| 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. |
 
 ### Returns
 
@@ -1444,28 +1363,24 @@ logIfDebugEnabled<TEventName>(
 ### off()
 
 ```ts
-off<TEventName, TEventListener>(eventNames, listener): void;
+off<TEventName, TEventListener>(eventNames: TEventName | TEventName[], listener: TEventListener): void;
 ```
 
-### Type Parameters
+Removes a specific listener from the specified event name(s).
 
-#### TEventName
-
-`TEventName` *extends* `string` \| `number` \| `symbol`
-
-#### TEventListener
+### Type Parameters
 
-`TEventListener` = [`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\>
+| Type Parameter | Default type |
+| ------ | ------ |
+| `TEventName` *extends* `string` \| `number` \| `symbol` | - |
+| `TEventListener` | [`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\> |
 
 ### Parameters
 
-#### eventNames
-
-`TEventName` | `TEventName`[]
-
-#### listener
-
-`TEventListener`
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `eventNames` | `TEventName` \| `TEventName`[] | One or more event names to unsubscribe from. |
+| `listener` | `TEventListener` | The listener to remove. |
 
 ### Returns
 
@@ -1480,14 +1395,16 @@ off<TEventName, TEventListener>(eventNames, listener): void;
 ### offAny()
 
 ```ts
-offAny(listener): void;
+offAny(listener: EventAnyListener): void;
 ```
 
-### Parameters
+Removes a wildcard listener that was receiving all events.
 
-#### listener
+### Parameters
 
-[`EventAnyListener`](#../type-aliases/EventAnyListener)
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `listener` | [`EventAnyListener`](#../type-aliases/EventAnyListener) | The wildcard listener to remove. |
 
 ### Returns
 
@@ -1503,42 +1420,40 @@ offAny(listener): void;
 
 ```ts
 on<TEventName>(
-   eventNames, 
-   listener, 
-   filter?): (...args) => void;
+   eventNames: TEventName | TEventName[], 
+   listener: EventListener<TEventData[TEventName]>, 
+   filter?: TEventData[TEventName]): (...args: []) => void;
 ```
 
-### Type Parameters
+Subscribes a listener to the specified event name(s).
 
-#### TEventName
+### Type Parameters
 
-`TEventName` *extends* `string` \| `number` \| `symbol` = keyof `TEventData`
+| Type Parameter | Default type |
+| ------ | ------ |
+| `TEventName` *extends* `string` \| `number` \| `symbol` | keyof `TEventData` |
 
 ### Parameters
 
-#### eventNames
-
-`TEventName` | `TEventName`[]
-
-#### listener
-
-[`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\>
-
-#### filter?
-
-`TEventData`\[`TEventName`\]
+| 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. |
 
 ### Returns
 
+An unsubscribe function.
+
 ```ts
-(...args): void;
+(...args: []): void;
 ```
 
 #### Parameters
 
-##### args
-
-...\[\]
+| Parameter | Type |
+| ------ | ------ |
+| ...`args` | \[\] |
 
 #### Returns
 
@@ -1553,26 +1468,30 @@ on<TEventName>(
 ### onAny()
 
 ```ts
-onAny(listener): (...args) => void;
+onAny(listener: EventAnyListener): (...args: []) => void;
 ```
 
-### Parameters
+Subscribes a wildcard listener that receives all events.
 
-#### listener
+### Parameters
 
-[`EventAnyListener`](#../type-aliases/EventAnyListener)
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `listener` | [`EventAnyListener`](#../type-aliases/EventAnyListener) | The callback to invoke for any event. |
 
 ### Returns
 
+An unsubscribe function.
+
 ```ts
-(...args): void;
+(...args: []): void;
 ```
 
 #### Parameters
 
-##### args
-
-...\[\]
+| Parameter | Type |
+| ------ | ------ |
+| ...`args` | \[\] |
 
 #### Returns
 
@@ -1587,36 +1506,37 @@ onAny(listener): (...args) => void;
 ### once()
 
 ```ts
-once<TEventName>(eventName, listener): (...args) => void;
+once<TEventName>(eventName: TEventName, listener: EventListener<TEventData[TEventName]>): (...args: []) => void;
 ```
 
-### Type Parameters
+Subscribes a listener that will be invoked only once for the specified event, then automatically removed.
 
-#### TEventName
+### Type Parameters
 
-`TEventName` *extends* `string` \| `number` \| `symbol`
+| Type Parameter |
+| ------ |
+| `TEventName` *extends* `string` \| `number` \| `symbol` |
 
 ### Parameters
 
-#### eventName
-
-`TEventName`
-
-#### listener
-
-[`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\>
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `eventName` | `TEventName` | The event to listen for. |
+| `listener` | [`EventListener`](#../type-aliases/EventListener)\<`TEventData`\[`TEventName`\]\> | The callback to invoke once. |
 
 ### Returns
 
+An unsubscribe function.
+
 ```ts
-(...args): void;
+(...args: []): void;
 ```
 
 #### Parameters
 
-##### args
-
-...\[\]
+| Parameter | Type |
+| ------ | ------ |
+| ...`args` | \[\] |
 
 #### Returns
 
@@ -1634,39 +1554,43 @@ once<TEventName>(eventName, listener): (...args) => void;
 
 ***
 
+Fields specific to BaseEmitter configuration parameters.
+
   ### <a id="EventEmitter"></a>EventEmitter
 
 [**@xylabs/events**](#../README)
 
 ***
 
-## Type Parameters
+Interface for a typed event emitter that supports subscribing, unsubscribing, and emitting events.
 
-### T
+## Type Parameters
 
-`T` *extends* [`EventData`](#../type-aliases/EventData)
+| Type Parameter |
+| ------ |
+| `T` *extends* [`EventData`](#../type-aliases/EventData) |
 
 ## Properties
 
-### eventData
-
-```ts
-eventData: T;
-```
+| Property | Type | Description |
+| ------ | ------ | ------ |
+| <a id="eventdata"></a> `eventData` | `T` | Type-level reference to the event data shape for external type queries. |
 
 ## Methods
 
 ### clearListeners()
 
 ```ts
-clearListeners(eventNames): void;
+clearListeners(eventNames: keyof T | keyof T[]): void;
 ```
 
-### Parameters
+Removes all listeners for the specified event name(s).
 
-#### eventNames
+### Parameters
 
-keyof `T` | keyof `T`[]
+| Parameter | Type |
+| ------ | ------ |
+| `eventNames` | keyof `T` \| keyof `T`[] |
 
 ### Returns
 
@@ -1677,24 +1601,23 @@ keyof `T` | keyof `T`[]
 ### emit()
 
 ```ts
-emit<TEventName>(eventName, eventArgs): Promise<void>;
+emit<TEventName>(eventName: TEventName, eventArgs: T[TEventName]): Promise<void>;
 ```
 
-### Type Parameters
+Emits an event, invoking all registered listeners concurrently.
 
-#### TEventName
+### Type Parameters
 
-`TEventName` *extends* `string` \| `number` \| `symbol`
+| Type Parameter |
+| ------ |
+| `TEventName` *extends* `string` \| `number` \| `symbol` |
 
 ### Parameters
 
-#### eventName
-
-`TEventName`
-
-#### eventArgs
-
-`T`\[`TEventName`\]
+| Parameter | Type |
+| ------ | ------ |
+| `eventName` | `TEventName` |
+| `eventArgs` | `T`\[`TEventName`\] |
 
 ### Returns
 
@@ -1705,24 +1628,23 @@ emit<TEventName>(eventName, eventArgs): Promise<void>;
 ### emitSerial()
 
 ```ts
-emitSerial<TEventName>(eventName, eventArgs): Promise<void>;
+emitSerial<TEventName>(eventName: TEventName, eventArgs: T[TEventName]): Promise<void>;
 ```
 
-### Type Parameters
+Emits an event, invoking all registered listeners sequentially in order.
 
-#### TEventName
+### Type Parameters
 
-`TEventName` *extends* `string` \| `number` \| `symbol`
+| Type Parameter |
+| ------ |
+| `TEventName` *extends* `string` \| `number` \| `symbol` |
 
 ### Parameters
 
-#### eventName
-
-`TEventName`
-
-#### eventArgs
-
-`T`\[`TEventName`\]
+| Parameter | Type |
+| ------ | ------ |
+| `eventName` | `TEventName` |
+| `eventArgs` | `T`\[`TEventName`\] |
 
 ### Returns
 
@@ -1733,14 +1655,16 @@ emitSerial<TEventName>(eventName, eventArgs): Promise<void>;
 ### listenerCount()
 
 ```ts
-listenerCount(eventNames): number;
+listenerCount(eventNames: keyof T | keyof T[]): number;
 ```
 
-### Parameters
+Returns the total number of listeners registered for the specified event name(s).
 
-#### eventNames
+### Parameters
 
-keyof `T` | keyof `T`[]
+| Parameter | Type |
+| ------ | ------ |
+| `eventNames` | keyof `T` \| keyof `T`[] |
 
 ### Returns
 
@@ -1751,24 +1675,23 @@ keyof `T` | keyof `T`[]
 ### off()
 
 ```ts
-off<TEventName>(eventNames, listener): void;
+off<TEventName>(eventNames: TEventName | TEventName[], listener: EventListener<T[TEventName]>): void;
 ```
 
-### Type Parameters
+Removes a specific listener from the specified event name(s).
 
-#### TEventName
+### Type Parameters
 
-`TEventName` *extends* `string` \| `number` \| `symbol`
+| Type Parameter |
+| ------ |
+| `TEventName` *extends* `string` \| `number` \| `symbol` |
 
 ### Parameters
 
-#### eventNames
-
-`TEventName` | `TEventName`[]
-
-#### listener
-
-[`EventListener`](#../type-aliases/EventListener)\<`T`\[`TEventName`\]\>
+| Parameter | Type |
+| ------ | ------ |
+| `eventNames` | `TEventName` \| `TEventName`[] |
+| `listener` | [`EventListener`](#../type-aliases/EventListener)\<`T`\[`TEventName`\]\> |
 
 ### Returns
 
@@ -1779,14 +1702,18 @@ off<TEventName>(eventNames, listener): void;
 ### offAny()
 
 ```ts
-offAny(listener): void;
+offAny(listener: 
+  | Promise<void>
+  | EventAnyListener): void;
 ```
 
-### Parameters
+Removes a wildcard listener that was receiving all events.
 
-#### listener
+### Parameters
 
-`Promise`\<`void`\> | [`EventAnyListener`](#../type-aliases/EventAnyListener)
+| Parameter | Type |
+| ------ | ------ |
+| `listener` | \| `Promise`\<`void`\> \| [`EventAnyListener`](#../type-aliases/EventAnyListener) |
 
 ### Returns
 
@@ -1797,24 +1724,23 @@ offAny(listener): void;
 ### on()
 
 ```ts
-on<TEventName>(eventNames, listener): EventUnsubscribeFunction;
+on<TEventName>(eventNames: TEventName | TEventName[], listener: EventListener<T[TEventName]>): EventUnsubscribeFunction;
 ```
 
-### Type Parameters
+Subscribes a listener to the specified event name(s) and returns an unsubscribe function.
 
-#### TEventName
+### Type Parameters
 
-`TEventName` *extends* `string` \| `number` \| `symbol`
+| Type Parameter |
+| ------ |
+| `TEventName` *extends* `string` \| `number` \| `symbol` |
 
 ### Parameters
 
-#### eventNames
-
-`TEventName` | `TEventName`[]
-
-#### listener
-
-[`EventListener`](#../type-aliases/EventListener)\<`T`\[`TEventName`\]\>
+| Parameter | Type |
+| ------ | ------ |
+| `eventNames` | `TEventName` \| `TEventName`[] |
+| `listener` | [`EventListener`](#../type-aliases/EventListener)\<`T`\[`TEventName`\]\> |
 
 ### Returns
 
@@ -1825,14 +1751,16 @@ on<TEventName>(eventNames, listener): EventUnsubscribeFunction;
 ### onAny()
 
 ```ts
-onAny(listener): EventUnsubscribeFunction;
+onAny(listener: EventAnyListener): EventUnsubscribeFunction;
 ```
 
-### Parameters
+Subscribes a wildcard listener that receives all events and returns an unsubscribe function.
 
-#### listener
+### Parameters
 
-[`EventAnyListener`](#../type-aliases/EventAnyListener)
+| Parameter | Type |
+| ------ | ------ |
+| `listener` | [`EventAnyListener`](#../type-aliases/EventAnyListener) |
 
 ### Returns
 
@@ -1843,24 +1771,23 @@ onAny(listener): EventUnsubscribeFunction;
 ### once()
 
 ```ts
-once<TEventName>(eventName, listener): EventUnsubscribeFunction;
+once<TEventName>(eventName: TEventName, listener: EventListener<T[TEventName]>): EventUnsubscribeFunction;
 ```
 
-### Type Parameters
+Subscribes a listener that will be invoked only once for the specified event, then automatically removed.
 
-#### TEventName
+### Type Parameters
 
-`TEventName` *extends* `string` \| `number` \| `symbol`
+| Type Parameter |
+| ------ |
+| `TEventName` *extends* `string` \| `number` \| `symbol` |
 
 ### Parameters
 
-#### eventName
-
-`TEventName`
-
-#### listener
-
-[`EventListener`](#../type-aliases/EventListener)\<`T`\[`TEventName`\]\>
+| Parameter | Type |
+| ------ | ------ |
+| `eventName` | `TEventName` |
+| `listener` | [`EventListener`](#../type-aliases/EventListener)\<`T`\[`TEventName`\]\> |
 
 ### Returns
 
@@ -1878,11 +1805,13 @@ once<TEventName>(eventName, listener): EventUnsubscribeFunction;
 type BaseEmitterParams<T> = BaseParams<T & BaseEmitterParamsFields & T>;
 ```
 
-## Type Parameters
+Parameters type for configuring a BaseEmitter instance.
 
-### T
+## Type Parameters
 
-`T` *extends* `EmptyObject` = `EmptyObject`
+| Type Parameter | Default type |
+| ------ | ------ |
+| `T` *extends* `EmptyObject` | `EmptyObject` |
 
   ### <a id="DebugLogger"></a>DebugLogger
 
@@ -1891,7 +1820,7 @@ type BaseEmitterParams<T> = BaseParams<T & BaseEmitterParamsFields & T>;
 ***
 
 ```ts
-type DebugLogger = (type, debugName, eventName?, eventData?) => void;
+type DebugLogger = (type: string, debugName: string, eventName?: EventName, eventData?: EventArgs) => void;
 ```
 
 Emittery can collect and log debug information.
@@ -1903,21 +1832,12 @@ See API for more information on how debugging works.
 
 ## Parameters
 
-### type
-
-`string`
-
-### debugName
-
-`string`
-
-### eventName?
-
-[`EventName`](#EventName)
-
-### eventData?
-
-[`EventArgs`](#EventArgs)
+| Parameter | Type |
+| ------ | ------ |
+| `type` | `string` |
+| `debugName` | `string` |
+| `eventName?` | [`EventName`](#EventName) |
+| `eventData?` | [`EventArgs`](#EventArgs) |
 
 ## Returns
 
@@ -1930,34 +1850,22 @@ See API for more information on how debugging works.
 ***
 
 ```ts
-type DebugOptions = object;
+type DebugOptions = {
+  enabled?: boolean;
+  logger?: DebugLogger;
+  name: string;
+};
 ```
 
 Configure debug options of an instance.
 
 ## Properties
 
-### enabled?
-
-```ts
-optional enabled: boolean;
-```
-
-***
-
-### logger?
-
-```ts
-optional logger: DebugLogger;
-```
-
-***
-
-### name
-
-```ts
-readonly name: string;
-```
+| 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` |
 
   ### <a id="EventAnyListener"></a>EventAnyListener
 
@@ -1966,24 +1874,23 @@ readonly name: string;
 ***
 
 ```ts
-type EventAnyListener<TEventArgs> = (eventName, eventData) => Promisable<void>;
+type EventAnyListener<TEventArgs> = (eventName: EventName, eventData: TEventArgs) => Promisable<void>;
 ```
 
-## Type Parameters
+A listener that receives all events regardless of name.
 
-### TEventArgs
+## Type Parameters
 
-`TEventArgs` *extends* [`EventArgs`](#EventArgs) = [`EventArgs`](#EventArgs)
+| Type Parameter | Default type |
+| ------ | ------ |
+| `TEventArgs` *extends* [`EventArgs`](#EventArgs) | [`EventArgs`](#EventArgs) |
 
 ## Parameters
 
-### eventName
-
-[`EventName`](#EventName)
-
-### eventData
-
-`TEventArgs`
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `eventName` | [`EventName`](#EventName) | The name of the emitted event. |
+| `eventData` | `TEventArgs` | The data associated with the event. |
 
 ## Returns
 
@@ -1999,6 +1906,8 @@ type EventAnyListener<TEventArgs> = (eventName, eventData) => Promisable<void>;
 type EventArgs = string | number | object;
 ```
 
+The allowed types for event argument payloads.
+
   ### <a id="EventData"></a>EventData
 
 [**@xylabs/events**](#../README)
@@ -2006,9 +1915,13 @@ type EventArgs = string | number | object;
 ***
 
 ```ts
-type EventData = object;
+type EventData = {
+[key: string | number | symbol]: EventArgs;
+};
 ```
 
+A mapping of event names to their corresponding event argument types.
+
 ## Index Signature
 
 ```ts
@@ -2022,20 +1935,22 @@ type EventData = object;
 ***
 
 ```ts
-type EventListener<TEventArgs> = (eventData) => Promisable<void>;
+type EventListener<TEventArgs> = (eventData: TEventArgs) => Promisable<void>;
 ```
 
-## Type Parameters
+A listener for a specific event type.
 
-### TEventArgs
+## Type Parameters
 
-`TEventArgs` *extends* [`EventArgs`](#EventArgs) = [`EventArgs`](#EventArgs)
+| Type Parameter | Default type |
+| ------ | ------ |
+| `TEventArgs` *extends* [`EventArgs`](#EventArgs) | [`EventArgs`](#EventArgs) |
 
 ## Parameters
 
-### eventData
-
-`TEventArgs`
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `eventData` | `TEventArgs` | The data associated with the event. |
 
 ## Returns
 
@@ -2048,30 +1963,26 @@ type EventListener<TEventArgs> = (eventData) => Promisable<void>;
 ***
 
 ```ts
-type EventListenerInfo<TEventArgs> = object;
+type EventListenerInfo<TEventArgs> = {
+  filter?: TEventArgs;
+  listener: EventListener<TEventArgs>;
+};
 ```
 
-## Type Parameters
+Information about a registered event listener, including an optional filter for selective invocation.
 
-### TEventArgs
+## Type Parameters
 
-`TEventArgs` *extends* [`EventArgs`](#EventArgs) = [`EventArgs`](#EventArgs)
+| Type Parameter | Default type |
+| ------ | ------ |
+| `TEventArgs` *extends* [`EventArgs`](#EventArgs) | [`EventArgs`](#EventArgs) |
 
 ## Properties
 
-### filter?
-
-```ts
-optional filter: TEventArgs;
-```
-
-***
-
-### listener
-
-```ts
-listener: EventListener<TEventArgs>;
-```
+| Property | Type |
+| ------ | ------ |
+| <a id="filter"></a> `filter?` | `TEventArgs` |
+| <a id="listener"></a> `listener` | [`EventListener`](#EventListener)\<`TEventArgs`\> |
 
   ### <a id="EventName"></a>EventName
 
@@ -2083,6 +1994,8 @@ listener: EventListener<TEventArgs>;
 type EventName = PropertyKey;
 ```
 
+A valid event name, which can be any property key (string, number, or symbol).
+
   ### <a id="EventUnsubscribeFunction"></a>EventUnsubscribeFunction
 
 [**@xylabs/events**](#../README)
@@ -2093,6 +2006,8 @@ type EventName = PropertyKey;
 type EventUnsubscribeFunction = () => void;
 ```
 
+A function returned by event subscription methods that unsubscribes the listener when called.
+
 ## Returns
 
 `void`
@@ -2109,6 +2024,8 @@ type EventsParams = BaseParams<{
 }>;
 ```
 
+Parameters for constructing an Events instance, with optional debug configuration.
+
   ### <a id="MetaEventData"></a>MetaEventData
 
 [**@xylabs/events**](#../README)
@@ -2116,58 +2033,38 @@ type EventsParams = BaseParams<{
 ***
 
 ```ts
-type MetaEventData<TEventData> = object;
+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]>;
+  };
+};
 ```
 
-## Type Parameters
+Data shape for internal meta events that fire when listeners are added or removed.
 
-### TEventData
+## Type Parameters
 
-`TEventData` *extends* [`EventData`](#EventData)
+| Type Parameter |
+| ------ |
+| `TEventData` *extends* [`EventData`](#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]>;
-```
+| 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)