events-ex 2.0.1 → 2.1.1

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 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)
+
+
+### Features
+
+* add optional index argument to on/off funcs ([0b91827](https://github.com/snowyu/events-ex.js/commit/0b91827e05cb252edf645820db74fd36496ed56d))
+
 ## [2.0.1](https://github.com/snowyu/events-ex.js/compare/v2.0.0...v2.0.1) (2025-03-08)
 
 

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
 
 * 重写核心架构
@@ -23,7 +14,7 @@ TODO: 异步事件,添加`emitAsync`方法. 没这么简单,因为要支持bubbl
 ### 区别
 
 * 与 [Node 事件模块](https://nodejs.org/api/events.html) 的区别
-  * **`改变`**: 事件支持冒泡机制与中断
+  * 🔁 **`改变`**: 事件支持冒泡机制与中断
     * 事件对象(`Event Object`)作为监听器的 "this" 对象。
       * `result` 属性: 可选, 如果设置,则将该结果返回到事件发射器(`Event Emitter`)。
       * `stopped` 属性: 可选, 如果设置为 `true`，则会阻止剩余的监听器被执行。
@@ -32,7 +23,14 @@ TODO: 异步事件,添加`emitAsync`方法. 没这么简单,因为要支持bubbl
     * **`改变`**: `emit` 方法返回监听器回调函数的结果而不是成功状态。
     * **`改变`**: 监听器回调函数的 `this` 对象是 `Event Object` 事件对象而不是事件发射器对象。
       * 事件发射器对象被放入 `Event` 对象的 `target` 属性中。
-  * 添加了`emitAsync`方法,支持异步事件
+  * ⚡ 添加了`emitAsync`方法,采用瀑布流式顺序执行异步事件,支持冒泡机制与中断。
+    * 非常适合用于需要等待多个异步任务完成的场景（如数据验证、插件系统等）。
+  * 事件监听器`on/once(event: string|RegExp, listener, index?:number)`
+    * 📌 支持第三个参数 index（可选），允许你在监听器数组中指定插入位置。
+      * 对于需要精确控制监听器调用顺序的场景非常有用（如前置拦截逻辑）。
+    * 🧪 event 支持正则表达式匹配事件名
+      * 监听器可使用正则表达式绑定多个相关事件，提升灵活性。
+      * 适用于统一处理一类命名模式的事件（如日志、状态变更等）。
 * 与 [event-emitter](https://github.com/medikoo/event-emitter) 的区别
   * **`改变`**: 事件支持冒泡机制（如上所述）
   * 添加了默认最大监听器数量的类属性，以保持与 Node 事件模块的兼容性。
@@ -41,16 +39,24 @@ TODO: 异步事件,添加`emitAsync`方法. 没这么简单,因为要支持bubbl
   * 添加了 `listeners()` 方法，以保持与 Node 事件模块的兼容性。
   * 添加了 `listenerCount()` 类方法，以保持与 Node 事件模块的兼容性。
   * 添加了`emitAsync`方法,支持异步事件
-
-注意: 时间内部引发错误不会中断通知，但是会在通知结束时 emit 错误事件(`emit('error', error, 'notify', eventName, listener, args)`)
+* 🔗 事件管道与统一：pipe() 与 unify()
+  * `pipe(source, target)`：将一个 emitter 的事件转发到另一个 emitter。
+  * `unify(emitter1, emitter2)`：双向同步事件流，适用于构建共享状态或通信桥梁。
+* 📦 丰富的工具函数
+  * 提供如 `allOff()`, `hasListeners()`, `listenerCount()` 等辅助函数，便于调试与管理事件生命周期。
+  * 有助于构建更健壮的事件驱动系统。
+* 🔌 模块化能力注入：`eventable()`
+  * 不必继承基类，可通过 eventable(MyClass) 将事件能力注入任意类。
+  * 支持配置只注入特定方法，避免污染原型链。
+
+注意: 事件内部引发错误不会中断通知，但是会在通知结束时 emit 错误事件(`emit('error', error, 'notify', eventName, listener, args)`)
 
 ### 安装
 
-```
+```bash
 npm install events-ex@alpha
 ```
 
-
 ### 用法
 
 直接继承使用 `EventEmitter` 类
@@ -95,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

@@ -1,6 +1,5 @@
 ### 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)
 
-
 Browser-friendly enhanced event emitter [ability][Ability] and class. It's modified from [event-emitter][event-emitter] mainly. It can add/inject the event-able [ability][Ability] to your any class.
 
 ### Features
@@ -25,6 +24,16 @@ Browser-friendly enhanced event emitter [ability][Ability] and class. It's modif
     * **`broken change`**: The `this` object of listeners' callback function is the `Event` Object instead of the emitter object.
       * 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 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.
+      * Useful for precise control over listener execution order (e.g., pre-interception logic).
+    * 🧪 **Regex Event Matching**:
+      * Listeners can bind to multiple events via regex patterns.
+      * Great for handling events with naming patterns (e.g., logs, state changes).
 * Difference with [event-emitter](https://github.com/medikoo/event-emitter)
   + **`broken change`**: The event supports bubbling and interruption(see above)
   + Adds the defaultMaxListeners class property to keep compatibility with node events.
@@ -33,6 +42,15 @@ Browser-friendly enhanced event emitter [ability][Ability] and class. It's modif
   + Adds listeners() method to keep compatibility with node events.
   + Adds listenerCount() class method to keep compatibility with node events.
   * Adds async event emitting via `emitAsync` method.
+* 🔗 **Event Piping & Unification**:
+  * `pipe(source, target)`: Forwards events from one emitter to another.
+  * `unify(emitter1, emitter2)`: Bi-directional event synchronization (e.g., shared state management).
+* 📦 **Utility Functions**:
+  * Includes `allOff()`, `hasListeners()`, `listenerCount()` for debugging and lifecycle management.
+  * Enhances robustness in event-driven architectures.
+* 🔌 **Modular Ability Injection**:
+  * `eventable(MyClass)`: Inject event capabilities into any class without inheritance.
+  * Configurable inclusion/exclusion of methods to avoid prototype pollution.
 
 Note: The listener throw error should not broke the notification, but it will emit error(`emit('error', error, 'notify', eventName, listener, args)`) after notification.
 
@@ -87,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

@@ -26,6 +26,16 @@ Browser-friendly enhanced event emitter [ability][Ability] and class. It's modif
     * **`broken change`**: The `this` object of listeners' callback function is the `Event` Object instead of the emitter object.
       * 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 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.
+      * Useful for precise control over listener execution order (e.g., pre-interception logic).
+    * 🧪 **Regex Event Matching**:
+      * Listeners can bind to multiple events via regex patterns.
+      * Great for handling events with naming patterns (e.g., logs, state changes).
 * Difference with [event-emitter](https://github.com/medikoo/event-emitter)
   + **`broken change`**: The event supports bubbling and interruption(see above)
   + Adds the defaultMaxListeners class property to keep compatibility with node events.
@@ -34,6 +44,15 @@ Browser-friendly enhanced event emitter [ability][Ability] and class. It's modif
   + Adds listeners() method to keep compatibility with node events.
   + Adds listenerCount() class method to keep compatibility with node events.
   * Adds async event emitting via `emitAsync` method.
+* 🔗 **Event Piping & Unification**:
+  * `pipe(source, target)`: Forwards events from one emitter to another.
+  * `unify(emitter1, emitter2)`: Bi-directional event synchronization (e.g., shared state management).
+* 📦 **Utility Functions**:
+  * Includes `allOff()`, `hasListeners()`, `listenerCount()` for debugging and lifecycle management.
+  * Enhances robustness in event-driven architectures.
+* 🔌 **Modular Ability Injection**:
+  * `eventable(MyClass)`: Inject event capabilities into any class without inheritance.
+  * Configurable inclusion/exclusion of methods to avoid prototype pollution.
 
 Note: The listener throw error should not broke the notification, but it will emit error(`emit('error', error, 'notify', eventName, listener, args)`) after notification.
 
@@ -87,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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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

@@ -41,11 +41,11 @@ Renames and re-exports [getEventableMethods](default_methods.md#geteventablemeth
 | `listenerCount` | (`emitter`: `any`, `type`: `any`) => `number` |
 | `listeners` | (`type`: `any`) => `any` |
 | `off` | (`type`: `string` \| `RegExp`, `listener`: `Function`) => [`EventEmitter`](../classes/event_emitter.EventEmitter.md) |
-| `on` | (`type`: `string` \| `RegExp`, `listener`: `Function`) => [`EventEmitter`](../classes/event_emitter.EventEmitter.md) |
-| `once` | (`type`: `string` \| `RegExp`, `listener`: `Function`) => [`EventEmitter`](../classes/event_emitter.EventEmitter.md) |
+| `on` | (`type`: `string` \| `RegExp`, `listener`: `Function`, `index?`: `number`) => [`EventEmitter`](../classes/event_emitter.EventEmitter.md) |
+| `once` | (`type`: `string` \| `RegExp`, `listener`: `Function`, `index?`: `number`) => [`EventEmitter`](../classes/event_emitter.EventEmitter.md) |
 | `removeAllListeners` | (`type`: `string` \| `RegExp`) => [`EventEmitter`](../classes/event_emitter.EventEmitter.md) |
-| `setMaxListeners` | (`n`: `any`) => \{ on(type: string \| RegExp, listener: Function): EventEmitter; once(type: string \| RegExp, listener: Function): EventEmitter; ... 6 more ...; removeAllListeners(type: string \| RegExp): EventEmitter; } |
+| `setMaxListeners` | (`n`: `any`) => \{ on(type: string \| RegExp, listener: Function, index?: number): EventEmitter; once(type: string \| RegExp, listener: Function, index?: number): EventEmitter; ... 6 more ...; removeAllListeners(type: string \| RegExp): EventEmitter; } |
 
 #### Defined in
 
-[src/default-methods.js:14](https://github.com/snowyu/events-ex.js/blob/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/0aebeb6/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/default-methods.d.ts

@@ -3,18 +3,20 @@ export function getEventableMethods(aClass: any): {
      * Adds a listener function to the specified event type.
      * @param {string|RegExp} type - The event type to listen for.
      * @param {Function} listener - The listener function to be called when the event is emitted.
+     * @param {number} [index] - The index at which to insert the listener. If not specified, the listener will be added at the end of the listeners array.
      * @returns {import('./event-emitter').EventEmitter} The EventEmitter instance to allow chaining.
      * @throws {TypeError} If the listener is not a function.
      */
-    on(type: string | RegExp, listener: Function): import('./event-emitter').EventEmitter;
+    on(type: string | RegExp, listener: Function, index?: number): import('./event-emitter').EventEmitter;
     /**
      * Adds a one-time listener function to the specified event type.
      * @param {string|RegExp} type - The event type to listen for.
      * @param {Function} listener - The listener function to be called once when the event is emitted.
+     * @param {number} [index] - The index at which to insert the listener. If not specified, the listener will be added at the end of the listeners array.
      * @returns {import('./event-emitter').EventEmitter} The EventEmitter instance to allow chaining.
      * @throws {TypeError} If the listener is not a function.
      */
-    once(type: string | RegExp, listener: Function): import('./event-emitter').EventEmitter;
+    once(type: string | RegExp, listener: Function, index?: number): import('./event-emitter').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.

package/lib/default-methods.js

@@ -21,10 +21,11 @@ function getEventableMethods(aClass) {
      * Adds a listener function to the specified event type.
      * @param {string|RegExp} type - The event type to listen for.
      * @param {Function} listener - The listener function to be called when the event is emitted.
+     * @param {number} [index] - The index at which to insert the listener. If not specified, the listener will be added at the end of the listeners array.
      * @returns {import('./event-emitter').EventEmitter} The EventEmitter instance to allow chaining.
      * @throws {TypeError} If the listener is not a function.
      */
-    on(type, listener) {
+    on(type, listener, index) {
       if (!(0, _utilEx.isFunction)(listener)) {
         throw new TypeError(listener + ' is not a function');
       }
@@ -46,7 +47,11 @@ function getEventableMethods(aClass) {
       if (!data[type]) {
         data[type] = listener;
       } else if ((0, _utilEx.isObject)(data[type])) {
-        data[type].push(listener);
+        if (typeof index === 'number') {
+          data[type].splice(index, 0, listener);
+        } else {
+          data[type].push(listener);
+        }
       } else {
         data[type] = [data[type], listener];
       }
@@ -69,10 +74,11 @@ function getEventableMethods(aClass) {
      * Adds a one-time listener function to the specified event type.
      * @param {string|RegExp} type - The event type to listen for.
      * @param {Function} listener - The listener function to be called once when the event is emitted.
+     * @param {number} [index] - The index at which to insert the listener. If not specified, the listener will be added at the end of the listeners array.
      * @returns {import('./event-emitter').EventEmitter} The EventEmitter instance to allow chaining.
      * @throws {TypeError} If the listener is not a function.
      */
-    once(type, listener) {
+    once(type, listener, index) {
       if (!(0, _utilEx.isFunction)(listener)) {
         throw new TypeError(listener + ' is not a function');
       }
@@ -86,7 +92,7 @@ function getEventableMethods(aClass) {
         }
       }
       _once.listener = listener;
-      this.on(type, _once);
+      this.on(type, _once, index);
       return this;
     },
     /**

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.0.1",
+  "version": "2.1.1",
   "description": "Browser-friendly enhanced events most compatible with standard node.js, it's powerful eventable ability.",
   "contributors": [
     {

package/src/default-methods.js

@@ -17,10 +17,11 @@ export function getEventableMethods(aClass) {
      * Adds a listener function to the specified event type.
      * @param {string|RegExp} type - The event type to listen for.
      * @param {Function} listener - The listener function to be called when the event is emitted.
+     * @param {number} [index] - The index at which to insert the listener. If not specified, the listener will be added at the end of the listeners array.
      * @returns {import('./event-emitter').EventEmitter} The EventEmitter instance to allow chaining.
      * @throws {TypeError} If the listener is not a function.
      */
-    on(type, listener) {
+    on(type, listener, index) {
       if (!isFunction(listener)) {throw new TypeError(listener + ' is not a function')}
       let data
       if (!this.hasOwnProperty('_events')) {
@@ -40,7 +41,11 @@ export function getEventableMethods(aClass) {
       if  (!data[type]) {
         data[type] = listener
       } else if (isObject(data[type])) {
-        data[type].push(listener)
+        if (typeof index === 'number') {
+          data[type].splice(index, 0, listener)
+        } else {
+          data[type].push(listener)
+        }
       } else {
         data[type] = [data[type], listener]
       }
@@ -69,10 +74,11 @@ export function getEventableMethods(aClass) {
      * Adds a one-time listener function to the specified event type.
      * @param {string|RegExp} type - The event type to listen for.
      * @param {Function} listener - The listener function to be called once when the event is emitted.
+     * @param {number} [index] - The index at which to insert the listener. If not specified, the listener will be added at the end of the listeners array.
      * @returns {import('./event-emitter').EventEmitter} The EventEmitter instance to allow chaining.
      * @throws {TypeError} If the listener is not a function.
      */
-    once(type, listener) {
+    once(type, listener, index) {
       if (!isFunction(listener)) {throw new TypeError(listener + ' is not a function' )}
       let fired = false
       const self = this
@@ -85,7 +91,7 @@ export function getEventableMethods(aClass) {
         }
       }
       _once.listener = listener
-      this.on(type, _once)
+      this.on(type, _once, index)
       return this
     },
 

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.