events-ex 2.1.0 → 2.1.1

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [2.1.1](https://github.com/snowyu/events-ex.js/compare/v2.1.0...v2.1.1) (2025-10-24)
+
+
+### Bug Fixes
+
+* **ts:** forget to add removeListener declaration ([9c254b2](https://github.com/snowyu/events-ex.js/commit/9c254b2e1f1ab5e437c0099f002776a49e976c5b))
+
 ## [2.1.0](https://github.com/snowyu/events-ex.js/compare/v2.0.1...v2.1.0) (2025-06-09)
 
 

package/README.cn.md

@@ -1,16 +1,7 @@
 ### events-ex [![npm](https://img.shields.io/npm/v/events-ex.svg)](https://npmjs.org/package/events-ex) [![downloads](https://img.shields.io/npm/dm/events-ex.svg)](https://npmjs.org/package/events-ex) [![license](https://img.shields.io/npm/l/events-ex.svg)](https://npmjs.org/package/events-ex)
 
-
 浏览器友好的增强的**事件**[能力][Ability]和类。 它主要是从 [event-emitter][event-emitter] 修改而来的。 本库可以为你的任何类添加(注入)**事件**[能力][Ability]。
 
-
-TODO: 异步事件,添加`emitAsync`方法. 没这么简单,因为要支持bubbling,所以必须顺序执行事件.
-将`bubbling`作为功能选项.如果没有启用,就可以乱发了.
-
-当关闭`bubbling`的时候,那么是否还需要用`event`对象传递.
-
-首先完成异步支持.已经完成.`emitAsync`方法已经加上.
-
 ### Features
 
 * 重写核心架构
@@ -32,7 +23,7 @@ TODO: 异步事件,添加`emitAsync`方法. 没这么简单,因为要支持bubbl
     * **`改变`**: `emit` 方法返回监听器回调函数的结果而不是成功状态。
     * **`改变`**: 监听器回调函数的 `this` 对象是 `Event Object` 事件对象而不是事件发射器对象。
       * 事件发射器对象被放入 `Event` 对象的 `target` 属性中。
-  * ⚡ 添加了`emitAsync`方法,确保所有异步监听器完成后再返回结果。
+  * ⚡ 添加了`emitAsync`方法,采用瀑布流式顺序执行异步事件,支持冒泡机制与中断。
     * 非常适合用于需要等待多个异步任务完成的场景（如数据验证、插件系统等）。
   * 事件监听器`on/once(event: string|RegExp, listener, index?:number)`
     * 📌 支持第三个参数 index（可选），允许你在监听器数组中指定插入位置。
@@ -110,7 +101,6 @@ my.emit('event1');
 import {EventEmitter, states} from 'events-ex';
 import {isObject} from 'util-ex';
 
-states.ABORT = -1
 class MyDb extends EventEmitter {
   get(key) {
     // Demo the event object bubbling usage:

package/README.md

@@ -25,8 +25,8 @@ Browser-friendly enhanced event emitter [ability][Ability] and class. It's modif
       * The emitter object is put into the `target` property of the `Event` Object.
   * Adds async event emitting via `emitAsync` method.
   * ⚡ Added `emitAsync` Method:
-    * Ensures all async listeners complete before returning results.
-    * Ideal for scenarios requiring sequential async tasks (e.g., data validation, plugin systems).
+    * Ensures all async listeners are executed **sequentially** (in registration and bubbling order) before returning results.
+    * Ideal for scenarios requiring ordered async execution (e.g., middleware-style validation, plugin pipelines, state transitions).
   * Listener APIs: `on/once(event: string|RegExp, listener, index?: number)`
     * 📌 **Index Parameter** (Optional):
       * Allows specifying the insertion position in the listener array.
@@ -105,7 +105,6 @@ Bubbling event usage:
 import {EventEmitter, states} from 'events-ex';
 import {isObject} from 'util-ex';
 
-states.ABORT = -1
 class MyDb extends EventEmitter {
   get(key) {
     // Demo the event object bubbling usage:

package/docs/README.md

@@ -27,8 +27,8 @@ Browser-friendly enhanced event emitter [ability][Ability] and class. It's modif
       * The emitter object is put into the `target` property of the `Event` Object.
   * Adds async event emitting via `emitAsync` method.
   * ⚡ Added `emitAsync` Method:
-    * Ensures all async listeners complete before returning results.
-    * Ideal for scenarios requiring sequential async tasks (e.g., data validation, plugin systems).
+    * Ensures all async listeners are executed **sequentially** (in registration and bubbling order) before returning results.
+    * Ideal for scenarios requiring ordered async execution (e.g., middleware-style validation, plugin pipelines, state transitions).
   * Listener APIs: `on/once(event: string|RegExp, listener, index?: number)`
     * 📌 **Index Parameter** (Optional):
       * Allows specifying the insertion position in the listener array.
@@ -106,7 +106,6 @@ Bubbling event usage:
 import {EventEmitter, states} from 'events-ex';
 import {isObject} from 'util-ex';
 
-states.ABORT = -1
 class MyDb extends EventEmitter {
   get(key) {
     // Demo the event object bubbling usage:

package/docs/classes/event.Event.md

@@ -49,7 +49,7 @@ Event Object that contains information about the event, such as the target eleme
 
 #### Defined in
 
-[src/event.js:8](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event.js#L8)
+[src/event.js:8](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event.js#L8)
 
 ## Properties
 
@@ -61,7 +61,7 @@ Keep your event result here if any.
 
 #### Defined in
 
-[src/event.js:38](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event.js#L38)
+[src/event.js:38](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event.js#L38)
 
 ___
 
@@ -73,7 +73,7 @@ Whether stop the bubbling event
 
 #### Defined in
 
-[src/event.js:32](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event.js#L32)
+[src/event.js:32](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event.js#L32)
 
 ___
 
@@ -85,7 +85,7 @@ Who trigger the event
 
 #### Defined in
 
-[src/event.js:26](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event.js#L26)
+[src/event.js:26](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event.js#L26)
 
 ___
 
@@ -97,7 +97,7 @@ The type of the event.
 
 #### Defined in
 
-[src/event.js:44](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event.js#L44)
+[src/event.js:44](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event.js#L44)
 
 ## Methods
 
@@ -115,7 +115,7 @@ The result of the event.
 
 #### Defined in
 
-[src/event.js:51](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event.js#L51)
+[src/event.js:51](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event.js#L51)
 
 ___
 
@@ -138,4 +138,4 @@ Initializes the event with the target object.
 
 #### Defined in
 
-[src/event.js:20](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event.js#L20)
+[src/event.js:20](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event.js#L20)

package/docs/classes/event_emitter-1.EventEmitter.md

@@ -26,4 +26,4 @@ Class that represents an event emitter.
 
 #### Defined in
 
-[src/event-emitter.js:8](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event-emitter.js#L8)
+[src/event-emitter.js:8](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event-emitter.js#L8)

package/docs/classes/event_emitter.EventEmitter.md

@@ -26,6 +26,7 @@ Class that represents an event emitter.
 - [on](event_emitter.EventEmitter.md#on)
 - [once](event_emitter.EventEmitter.md#once)
 - [removeAllListeners](event_emitter.EventEmitter.md#removealllisteners)
+- [removeListener](event_emitter.EventEmitter.md#removelistener)
 - [setMaxListeners](event_emitter.EventEmitter.md#setmaxlisteners)
 - [listenerCount](event_emitter.EventEmitter.md#listenercount-1)
 
@@ -47,7 +48,7 @@ Class that represents an event emitter.
 
 #### Defined in
 
-[src/event-emitter.d.ts:7](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event-emitter.d.ts#L7)
+[src/event-emitter.d.ts:7](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event-emitter.d.ts#L7)
 
 ## Methods
 
@@ -72,7 +73,7 @@ The result of the event.
 
 #### Defined in
 
-[src/event-emitter.d.ts:38](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event-emitter.d.ts#L38)
+[src/event-emitter.d.ts:48](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event-emitter.d.ts#L48)
 
 ___
 
@@ -97,7 +98,7 @@ A promise that resolves with the result of the event.
 
 #### Defined in
 
-[src/event-emitter.d.ts:44](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event-emitter.d.ts#L44)
+[src/event-emitter.d.ts:54](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event-emitter.d.ts#L54)
 
 ___
 
@@ -121,7 +122,7 @@ Returns the count of listeners that are registered to listen for the specified e
 
 #### Defined in
 
-[src/event-emitter.d.ts:66](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event-emitter.d.ts#L66)
+[src/event-emitter.d.ts:83](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event-emitter.d.ts#L83)
 
 ___
 
@@ -145,7 +146,7 @@ Returns an array of functions that are registered to listen for the specified ev
 
 #### Defined in
 
-[src/event-emitter.d.ts:59](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event-emitter.d.ts#L59)
+[src/event-emitter.d.ts:76](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event-emitter.d.ts#L76)
 
 ___
 
@@ -172,9 +173,13 @@ The EventEmitter instance to allow chaining.
 
 If the listener is not a function.
 
+**`See`**
+
+[removeListener](event_emitter.EventEmitter.md#removelistener)
+
 #### Defined in
 
-[src/event-emitter.d.ts:32](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event-emitter.d.ts#L32)
+[src/event-emitter.d.ts:33](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event-emitter.d.ts#L33)
 
 ___
 
@@ -203,7 +208,7 @@ If the listener is not a function.
 
 #### Defined in
 
-[src/event-emitter.d.ts:16](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event-emitter.d.ts#L16)
+[src/event-emitter.d.ts:16](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event-emitter.d.ts#L16)
 
 ___
 
@@ -232,7 +237,7 @@ If the listener is not a function.
 
 #### Defined in
 
-[src/event-emitter.d.ts:24](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event-emitter.d.ts#L24)
+[src/event-emitter.d.ts:24](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event-emitter.d.ts#L24)
 
 ___
 
@@ -256,7 +261,40 @@ Removes all listeners for a specific event or all events from an event emitter.
 
 #### Defined in
 
-[src/event-emitter.d.ts:51](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event-emitter.d.ts#L51)
+[src/event-emitter.d.ts:61](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event-emitter.d.ts#L61)
+
+___
+
+### removeListener
+
+▸ **removeListener**(`eventName`, `listener`): [`EventEmitter`](event_emitter.EventEmitter.md)
+
+Removes a listener function from the specified event type.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `eventName` | `string` \| `RegExp` | - |
+| `listener` | `Function` | The listener function to be removed. |
+
+#### Returns
+
+[`EventEmitter`](event_emitter.EventEmitter.md)
+
+The EventEmitter instance to allow chaining.
+
+**`Throws`**
+
+If the listener is not a function.
+
+**`See`**
+
+[off](event_emitter.EventEmitter.md#off)
+
+#### Defined in
+
+[src/event-emitter.d.ts:42](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event-emitter.d.ts#L42)
 
 ___
 
@@ -264,19 +302,27 @@ ___
 
 ▸ **setMaxListeners**(`n`): [`EventEmitter`](event_emitter.EventEmitter.md)
 
+Sets the maximum number of listeners allowed for the event emitter.
+
 #### Parameters
 
-| Name | Type |
-| :------ | :------ |
-| `n` | `number` |
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `n` | `number` | The maximum number of listeners to set. Must be a positive integer. |
 
 #### Returns
 
 [`EventEmitter`](event_emitter.EventEmitter.md)
 
+The [EventEmitter](event_emitter.EventEmitter.md) instance for method chaining.
+
+**`Throws`**
+
+If `n` is not a positive integer.
+
 #### Defined in
 
-[src/event-emitter.d.ts:52](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event-emitter.d.ts#L52)
+[src/event-emitter.d.ts:69](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event-emitter.d.ts#L69)
 
 ___
 
@@ -303,4 +349,4 @@ use emitter.listenerCount instead
 
 #### Defined in
 
-[src/event-emitter.d.ts:74](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/event-emitter.d.ts#L74)
+[src/event-emitter.d.ts:91](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/event-emitter.d.ts#L91)

package/docs/modules/all_off.md

@@ -41,4 +41,4 @@ Removes all listeners for a specific event or all events from an event emitter.
 
 #### Defined in
 
-[src/all-off.js:12](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/all-off.js#L12)
+[src/all-off.js:12](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/all-off.js#L12)

package/docs/modules/consts.md

@@ -17,7 +17,7 @@
 
 #### Defined in
 
-[src/consts.js:13](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/consts.js#L13)
+[src/consts.js:13](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/consts.js#L13)
 
 ___
 
@@ -36,4 +36,4 @@ ___
 
 #### Defined in
 
-[src/consts.js:6](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/consts.js#L6)
+[src/consts.js:6](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/consts.js#L6)

package/docs/modules/default_methods.md

@@ -48,4 +48,4 @@ Renames and re-exports [getEventableMethods](default_methods.md#geteventablemeth
 
 #### Defined in
 
-[src/default-methods.js:14](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/default-methods.js#L14)
+[src/default-methods.js:14](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/default-methods.js#L14)

package/docs/modules/has_listeners.md

@@ -46,4 +46,4 @@ Throws a TypeError if `obj` is null or undefined.
 
 #### Defined in
 
-[src/has-listeners.js:20](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/has-listeners.js#L20)
+[src/has-listeners.js:20](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/has-listeners.js#L20)

package/docs/modules/pipe.md

@@ -46,4 +46,4 @@ Creates a pipeline between two event emitters, so that any events emitted by the
 
 #### Defined in
 
-[src/pipe.js:21](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/pipe.js#L21)
+[src/pipe.js:21](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/pipe.js#L21)

package/docs/modules/pipe_async.md

@@ -46,4 +46,4 @@ Creates a pipeline between two event emitters, so that any events emitted by the
 
 #### Defined in
 
-[src/pipe-async.js:21](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/pipe-async.js#L21)
+[src/pipe-async.js:21](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/pipe-async.js#L21)

package/docs/modules/unify.md

@@ -43,4 +43,4 @@ Unifies the event listeners of two event emitter objects so that they share the
 
 #### Defined in
 
-[src/unify.js:17](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/unify.js#L17)
+[src/unify.js:17](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/unify.js#L17)

package/docs/modules/util_array_remove.md

@@ -36,4 +36,4 @@ Renames and re-exports [remove](util_array_remove.md#remove)
 
 #### Defined in
 
-[src/util/array-remove.js:5](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/util/array-remove.js#L5)
+[src/util/array-remove.js:5](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/util/array-remove.js#L5)

package/docs/modules/util_object_for_each.md

@@ -38,4 +38,4 @@ Renames and re-exports [forEach](util_object_for_each.md#foreach)
 
 #### Defined in
 
-[src/util/object-for-each.js:6](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/util/object-for-each.js#L6)
+[src/util/object-for-each.js:6](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/util/object-for-each.js#L6)

package/docs/modules/util_string_pad.md

@@ -37,4 +37,4 @@ Renames and re-exports [pad](util_string_pad.md#pad)
 
 #### Defined in
 
-[src/util/string-pad.js:8](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/util/string-pad.js#L8)
+[src/util/string-pad.js:8](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/util/string-pad.js#L8)

package/docs/modules/util_to_int.md

@@ -36,4 +36,4 @@ Renames and re-exports [toInt](util_to_int.md#toint)
 
 #### Defined in
 
-[src/util/to-int.js:2](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/util/to-int.js#L2)
+[src/util/to-int.js:2](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/util/to-int.js#L2)

package/docs/modules/util_valid_callable.md

@@ -36,4 +36,4 @@ Renames and re-exports [validCallable](util_valid_callable.md#validcallable)
 
 #### Defined in
 
-[src/util/valid-callable.js:1](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/util/valid-callable.js#L1)
+[src/util/valid-callable.js:1](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/util/valid-callable.js#L1)

package/docs/modules/util_valid_object.md

@@ -36,4 +36,4 @@ Renames and re-exports [validObject](util_valid_object.md#validobject)
 
 #### Defined in
 
-[src/util/valid-object.js:3](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/util/valid-object.js#L3)
+[src/util/valid-object.js:3](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/util/valid-object.js#L3)

package/docs/modules/wrap_event_emitter.md

@@ -30,7 +30,7 @@ Renames and re-exports [wrapEventEmitter](wrap_event_emitter.md#wrapeventemitter
 
 #### Defined in
 
-[src/wrap-event-emitter.js:7](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/wrap-event-emitter.js#L7)
+[src/wrap-event-emitter.js:7](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/wrap-event-emitter.js#L7)
 
 ## Functions
 
@@ -54,4 +54,4 @@ o or new Event instance
 
 #### Defined in
 
-[src/wrap-event-emitter.js:34](https://github.com/snowyu/events-ex.js/blob/a6cce2d/src/wrap-event-emitter.js#L34)
+[src/wrap-event-emitter.js:34](https://github.com/snowyu/events-ex.js/blob/9c254b2/src/wrap-event-emitter.js#L34)

package/lib/event-emitter.d.ts

@@ -28,8 +28,18 @@ export class EventEmitter {
    * @param {Function} listener - The listener function to be removed.
    * @returns {EventEmitter} The EventEmitter instance to allow chaining.
    * @throws {TypeError} If the listener is not a function.
+   * @see {@link removeListener}
    */
   off(eventName: string|RegExp, listener: ListenerCallbackFunc): EventEmitter;
+  /**
+   * Removes a listener function from the specified event type.
+   * @param {string|RegExp} type - The event type to remove the listener from.
+   * @param {Function} listener - The listener function to be removed.
+   * @returns {EventEmitter} The EventEmitter instance to allow chaining.
+   * @throws {TypeError} If the listener is not a function.
+   * @see {@link off}
+   */
+  removeListener(eventName: string|RegExp, listener: ListenerCallbackFunc): EventEmitter;
   /**
    * Emits the specified event type with the given arguments.
    * @param {...*} args - The event type followed by any number of arguments to be passed to the listener functions.
@@ -49,6 +59,13 @@ export class EventEmitter {
    * @returns {EventEmitter} - The event emitter with all listeners removed.
    */
   removeAllListeners(eventName?: string|RegExp): EventEmitter;
+  /**
+   * Sets the maximum number of listeners allowed for the event emitter.
+   *
+   * @param {number} n - The maximum number of listeners to set. Must be a positive integer.
+   * @returns {EventEmitter} The {@link EventEmitter} instance for method chaining.
+   * @throws {TypeError} If `n` is not a positive integer.
+   */
   setMaxListeners(n: number): EventEmitter;
   /**
    * Returns an array of functions that are registered to listen for the specified event.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "events-ex",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Browser-friendly enhanced events most compatible with standard node.js, it's powerful eventable ability.",
   "contributors": [
     {

package/src/event-emitter.d.ts

@@ -28,8 +28,18 @@ export class EventEmitter {
    * @param {Function} listener - The listener function to be removed.
    * @returns {EventEmitter} The EventEmitter instance to allow chaining.
    * @throws {TypeError} If the listener is not a function.
+   * @see {@link removeListener}
    */
   off(eventName: string|RegExp, listener: ListenerCallbackFunc): EventEmitter;
+  /**
+   * Removes a listener function from the specified event type.
+   * @param {string|RegExp} type - The event type to remove the listener from.
+   * @param {Function} listener - The listener function to be removed.
+   * @returns {EventEmitter} The EventEmitter instance to allow chaining.
+   * @throws {TypeError} If the listener is not a function.
+   * @see {@link off}
+   */
+  removeListener(eventName: string|RegExp, listener: ListenerCallbackFunc): EventEmitter;
   /**
    * Emits the specified event type with the given arguments.
    * @param {...*} args - The event type followed by any number of arguments to be passed to the listener functions.
@@ -49,6 +59,13 @@ export class EventEmitter {
    * @returns {EventEmitter} - The event emitter with all listeners removed.
    */
   removeAllListeners(eventName?: string|RegExp): EventEmitter;
+  /**
+   * Sets the maximum number of listeners allowed for the event emitter.
+   *
+   * @param {number} n - The maximum number of listeners to set. Must be a positive integer.
+   * @returns {EventEmitter} The {@link EventEmitter} instance for method chaining.
+   * @throws {TypeError} If `n` is not a positive integer.
+   */
   setMaxListeners(n: number): EventEmitter;
   /**
    * Returns an array of functions that are registered to listen for the specified event.