events-ex 2.2.0 → 2.3.1

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 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.3.1](https://github.com/snowyu/events-ex.js/compare/v2.3.0...v2.3.1) (2026-04-17)
+
+
+### Performance
+
+* minor optimition for index ([f6c4415](https://github.com/snowyu/events-ex.js/commit/f6c44157ffda17957fad5ad2e0aedbb8ec521be7))
+
+## [2.3.0](https://github.com/snowyu/events-ex.js/compare/v2.2.0...v2.3.0) (2026-04-17)
+
+
+### Features
+
+* support special index values 'first' and 'last' for listener ordering ([53cfb5b](https://github.com/snowyu/events-ex.js/commit/53cfb5bb3f7229cb549e99d410c0d6d39665eb0a))
+
+## [2.3.0](https://github.com/snowyu/events-ex.js/compare/v2.2.0...v2.3.0) (2025-05-15)
+
+### Features
+
+* **index:** support special index values 'first' and 'last' in on/once methods to maintain regional ordering.
+
 ## [2.2.0](https://github.com/snowyu/events-ex.js/compare/v2.1.1...v2.2.0) (2026-03-10)
 
 

package/README.cn.md

@@ -7,7 +7,7 @@
 * **模块化 Event-able 能力**：通过 `eventable(MyClass)` 将事件功能注入任何类，无需强制继承。
 * **核心事件增强**：
   * **冒泡与中断**：全面支持事件传播控制及中途取消。
-  * **监听器排序**：通过 `on()` 和 `once()` 的可选 `index` 参数精确控制执行顺序。
+  * **监听器排序**：通过 `on()` 和 `once()` 的可选 `index` 参数精确控制执行顺序。支持特殊值 `'first'` 和 `'last'` 以确保监听器始终保持在边界。
   * **正则表达式订阅**：支持使用正则表达式订阅多个匹配的事件。
   * **可挂载(Hook-able)系统**：允许在核心层面拦截并修改事件行为。
 * **高级异步特性 (仅针对 `emitAsync`)**：
@@ -38,8 +38,11 @@
       * `first`: 返回第一个成功的非 undefined 结果（自动跳过错误）。
       * `collect`: 按注册顺序以数组形式返回所有结果。
   * **流式配置**: 使用 `.parallel()` 或 `.configure({...})` 进行单次定制化异步发射。
-  * **事件监听器 API**: `on/once(event: string|RegExp, listener, index?:number)`
-    * 📌 **Index 参数** (可选): 允许在监听器数组中指定插入位置。
+  * **事件监听器 API**: `on/once(event: string|RegExp, listener, index?: number|'first'|'last')`
+    * 📌 **Index 参数** (可选): 在监听器数组中指定插入位置。 
+      * `'first'` (`-Infinity`): 始终保持在 **Head** 区。先注册的 `'first'` 监听器排在最前面。
+      * `'last'` (`Infinity`): 始终保持在 **Tail** 区。先注册为 `'last'` 的监听器将始终位于数组的绝对末尾。
+      * `number`: 常规 **Body** 区内的相对索引。
     * 🧪 **正则事件匹配**: 允许使用正则表达式绑定多个相关事件。
 
 * **与 [event-emitter](https://github.com/medikoo/event-emitter) 的区别**
@@ -59,13 +62,17 @@
 
 ```js
 const ee = new EventEmitter();
-ee.on('test', () => console.log('second'), 1);
-ee.on('test', () => console.log('first'), 0); // 在索引 0 处插入
+ee.on('test', () => console.log('third'));
+ee.on('test', () => console.log('first'), 'first'); // 始终在最前
+ee.on('test', () => console.log('last'), 'last');   // 始终在最后
+ee.on('test', () => console.log('second'), 1);      // 常规区域索引 1 (相对于 Head)
 
 ee.emit('test');
 // 输出:
 // first
 // second
+// third
+// last
 ```
 
 #### 核心特性：正则表达式订阅

package/README.md

@@ -7,7 +7,7 @@ Browser-friendly enhanced event emitter [ability][Ability] and class. It's modif
 * **Modular Event-able Ability**: Inject event capabilities into any class using `eventable(MyClass)` without forced inheritance.
 * **Core Event Enhancements**:
   * **Bubbling & Interruption**: Full support for event propagation and mid-stream cancellation.
-  * **Listener Ordering**: Precise control via the optional `index` parameter in `on()` and `once()`.
+  * **Listener Ordering**: Precise control via the optional `index` parameter in `on()` and `once()`. Supports special values `'first'` and `'last'` to ensure listeners stay at the boundaries.
   * **Regex Subscription**: Subscribe to multiple events using Regular Expressions.
   * **Hook-able System**: Intercept and modify event behavior at the core level.
 * **Advanced Asynchronous Features (Specific to `emitAsync`)**:
@@ -38,8 +38,11 @@ Browser-friendly enhanced event emitter [ability][Ability] and class. It's modif
       * `first`: Returns the first successful non-undefined result (skips errors).
       * `collect`: Returns an array of all results in registration order.
   * **Fluent Configuration**: Use `.parallel()` or `.configure({...})` for one-time customized async emits.
-  * **Listener APIs**: `on/once(event: string|RegExp, listener, index?: number)`
-    * 📌 **Index Parameter** (Optional): Allows specifying the insertion position in the listener array.
+  * **Listener APIs**: `on/once(event: string|RegExp, listener, index?: number|'first'|'last')`
+    * 📌 **Index Parameter** (Optional): Insertion position in the listener array. 
+      * `'first'` (`-Infinity`): Stays in the **Head** zone. The first listener added as `'first'` is placed at the very front.
+      * `'last'` (`Infinity`): Stays in the **Tail** zone. The first listener added as `'last'` will always remain at the absolute end.
+      * `number`: Relative index within the **Body** zone.
     * 🧪 **Regex Event Matching**: Listeners can bind to multiple events via regex patterns.
 
 * **Difference with [event-emitter](https://github.com/medikoo/event-emitter)**
@@ -89,13 +92,17 @@ eventable(MyClass);
 
 ```js
 const ee = new EventEmitter();
-ee.on('test', () => console.log('second'), 1);
-ee.on('test', () => console.log('first'), 0); // Insert at index 0
+ee.on('test', () => console.log('third'));
+ee.on('test', () => console.log('first'), 'first'); // Always at the front
+ee.on('test', () => console.log('last'), 'last');   // Always at the end
+ee.on('test', () => console.log('second'), 1);      // Body index 1 (relative to Head)
 
 ee.emit('test');
 // Output:
 // first
 // second
+// third
+// last
 ```
 
 #### Core Feature: Regex Subscription

package/docs/README.md

@@ -11,7 +11,7 @@ Browser-friendly enhanced event emitter [ability][Ability] and class. It's modif
 * **Modular Event-able Ability**: Inject event capabilities into any class using `eventable(MyClass)` without forced inheritance.
 * **Core Event Enhancements**:
   * **Bubbling & Interruption**: Full support for event propagation and mid-stream cancellation.
-  * **Listener Ordering**: Precise control via the optional `index` parameter in `on()` and `once()`.
+  * **Listener Ordering**: Precise control via the optional `index` parameter in `on()` and `once()`. Supports special values `'first'` and `'last'` to ensure listeners stay at the boundaries.
   * **Regex Subscription**: Subscribe to multiple events using Regular Expressions.
   * **Hook-able System**: Intercept and modify event behavior at the core level.
 * **Advanced Asynchronous Features (Specific to `emitAsync`)**:
@@ -42,8 +42,11 @@ Browser-friendly enhanced event emitter [ability][Ability] and class. It's modif
       * `first`: Returns the first successful non-undefined result (skips errors).
       * `collect`: Returns an array of all results in registration order.
   * **Fluent Configuration**: Use `.parallel()` or `.configure({...})` for one-time customized async emits.
-  * **Listener APIs**: `on/once(event: string|RegExp, listener, index?: number)`
-    * 📌 **Index Parameter** (Optional): Allows specifying the insertion position in the listener array.
+  * **Listener APIs**: `on/once(event: string|RegExp, listener, index?: number|'first'|'last')`
+    * 📌 **Index Parameter** (Optional): Insertion position in the listener array. 
+      * `'first'` (`-Infinity`): Stays in the **Head** zone. The first listener added as `'first'` is placed at the very front.
+      * `'last'` (`Infinity`): Stays in the **Tail** zone. The first listener added as `'last'` will always remain at the absolute end.
+      * `number`: Relative index within the **Body** zone.
     * 🧪 **Regex Event Matching**: Listeners can bind to multiple events via regex patterns.
 
 * **Difference with [event-emitter](https://github.com/medikoo/event-emitter)**
@@ -93,13 +96,17 @@ eventable(MyClass);
 
 ```js
 const ee = new EventEmitter();
-ee.on('test', () => console.log('second'), 1);
-ee.on('test', () => console.log('first'), 0); // Insert at index 0
+ee.on('test', () => console.log('third'));
+ee.on('test', () => console.log('first'), 'first'); // Always at the front
+ee.on('test', () => console.log('last'), 'last');   // Always at the end
+ee.on('test', () => console.log('second'), 1);      // Body index 1 (relative to Head)
 
 ee.emit('test');
 // Output:
 // first
 // second
+// third
+// last
 ```
 
 #### Core Feature: Regex Subscription

package/docs/all-off/functions/allOff.md

@@ -8,7 +8,7 @@
 
 > **allOff**(`emitter`, `type?`): [`EventEmitter`](../../event-emitter/classes/EventEmitter.md)
 
-Defined in: [src/all-off.js:12](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/all-off.js#L12)
+Defined in: [src/all-off.js:12](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/all-off.js#L12)
 
 Removes all listeners for a specific event or all events from an event emitter.
 

package/docs/consts/variables/RegExpEventSymbol.md

@@ -8,4 +8,4 @@
 
 > `const` **RegExpEventSymbol**: `symbol` \| `"@@RegExpEvent"`
 
-Defined in: [src/consts.js:13](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/consts.js#L13)
+Defined in: [src/consts.js:13](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/consts.js#L13)

package/docs/consts/variables/states.md

@@ -8,7 +8,7 @@
 
 > `const` **states**: `object`
 
-Defined in: [src/consts.js:6](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/consts.js#L6)
+Defined in: [src/consts.js:6](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/consts.js#L6)
 
 ## Type Declaration
 

package/docs/default-methods/functions/getEventableMethods.md

@@ -8,7 +8,7 @@
 
 > **getEventableMethods**(`aClass`): `object`
 
-Defined in: [src/default-methods.js:15](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/default-methods.js#L15)
+Defined in: [src/default-methods.js:15](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/default-methods.js#L15)
 
 ## Parameters
 
@@ -172,9 +172,13 @@ The listener function to be called when the event is emitted.
 
 ##### index?
 
-`number`
+The index at which to insert the listener.
+       - 'first' or -Infinity: Adds to the "Head" zone. The first listener added as 'first' is placed at the very front.
+       - 'last' or Infinity: Adds to the "Tail" zone. The first listener added as 'last' will always be the very last one to execute.
+       - number: Inserts at the specified index within the "Body" (normal) zone.
+       If not specified, the listener is added to the end of the "Body" zone.
 
-The index at which to insert the listener. If not specified, the listener will be added at the end of the listeners array.
+`number` | `"first"` | `"last"`
 
 #### Returns
 
@@ -208,9 +212,13 @@ The listener function to be called once when the event is emitted.
 
 ##### index?
 
-`number`
+The index at which to insert the listener.
+       - 'first' or -Infinity: Adds to the "Head" zone. The first listener added as 'first' is placed at the very front.
+       - 'last' or Infinity: Adds to the "Tail" zone. The first listener added as 'last' will always be the very last one to execute.
+       - number: Inserts at the specified index within the "Body" (normal) zone.
+       If not specified, the listener is added to the end of the "Body" zone.
 
-The index at which to insert the listener. If not specified, the listener will be added at the end of the listeners array.
+`number` | `"first"` | `"last"`
 
 #### Returns
 

package/docs/event/classes/Event.md

@@ -6,7 +6,7 @@
 
 # Class: Event
 
-Defined in: [src/event.js:8](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event.js#L8)
+Defined in: [src/event.js:8](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event.js#L8)
 
 Creates a new Event object instance that contains information about the event, such as the target element and the return value of the event.
 
@@ -24,7 +24,7 @@ Who trigger the event
 
 > **new Event**(`target`, `type`): `Event`
 
-Defined in: [src/event.js:8](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event.js#L8)
+Defined in: [src/event.js:8](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event.js#L8)
 
 Creates a new Event object instance that contains information about the event, such as the target element and the return value of the event.
 
@@ -56,7 +56,7 @@ Event Object that contains information about the event, such as the target eleme
 
 > **resolved**: `boolean`
 
-Defined in: [src/event.js:38](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event.js#L38)
+Defined in: [src/event.js:38](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event.js#L38)
 
 Whether a result has been resolved (for 'first' result mode)
 
@@ -66,7 +66,7 @@ Whether a result has been resolved (for 'first' result mode)
 
 > **result**: `any`
 
-Defined in: [src/event.js:44](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event.js#L44)
+Defined in: [src/event.js:44](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event.js#L44)
 
 Keep your event result here if any.
 
@@ -76,7 +76,7 @@ Keep your event result here if any.
 
 > **stopped**: `boolean`
 
-Defined in: [src/event.js:32](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event.js#L32)
+Defined in: [src/event.js:32](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event.js#L32)
 
 Whether stop the bubbling event
 
@@ -86,7 +86,7 @@ Whether stop the bubbling event
 
 > **target**: `any`
 
-Defined in: [src/event.js:26](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event.js#L26)
+Defined in: [src/event.js:26](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event.js#L26)
 
 Who trigger the event
 
@@ -96,7 +96,7 @@ Who trigger the event
 
 > **type**: `string`
 
-Defined in: [src/event.js:50](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event.js#L50)
+Defined in: [src/event.js:50](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event.js#L50)
 
 The type of the event.
 
@@ -106,7 +106,7 @@ The type of the event.
 
 > **end**(): `any`
 
-Defined in: [src/event.js:57](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event.js#L57)
+Defined in: [src/event.js:57](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event.js#L57)
 
 Ends the event and returns the result.
 
@@ -122,7 +122,7 @@ The result of the event.
 
 > **init**(`target`, `type`): `void`
 
-Defined in: [src/event.js:20](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event.js#L20)
+Defined in: [src/event.js:20](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event.js#L20)
 
 Initializes the event with the target object.
 

package/docs/event-emitter/classes/EventEmitter-1.md

@@ -6,7 +6,7 @@
 
 # Class: EventEmitter
 
-Defined in: [src/event-emitter.js:8](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event-emitter.js#L8)
+Defined in: [src/event-emitter.js:8](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.js#L8)
 
 ## Classdesc
 
@@ -18,7 +18,7 @@ Class that represents an event emitter.
 
 > **new EventEmitter**(): `EventEmitter`
 
-Defined in: [src/event-emitter.js:8](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event-emitter.js#L8)
+Defined in: [src/event-emitter.js:8](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.js#L8)
 
 #### Returns
 

package/docs/event-emitter/classes/EventEmitter.md

@@ -6,7 +6,7 @@
 
 # Class: EventEmitter
 
-Defined in: [src/event-emitter.d.ts:6](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event-emitter.d.ts#L6)
+Defined in: [src/event-emitter.d.ts:6](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L6)
 
 Class that represents an event emitter.
 
@@ -26,7 +26,7 @@ Class that represents an event emitter.
 
 > `static` **defaultMaxListeners**: `number`
 
-Defined in: [src/event-emitter.d.ts:7](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event-emitter.d.ts#L7)
+Defined in: [src/event-emitter.d.ts:7](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L7)
 
 ## Methods
 
@@ -34,7 +34,7 @@ Defined in: [src/event-emitter.d.ts:7](https://github.com/snowyu/events-ex.js/bl
 
 > **emit**(`eventName`, ...`args`): `any`
 
-Defined in: [src/event-emitter.d.ts:48](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event-emitter.d.ts#L48)
+Defined in: [src/event-emitter.d.ts:58](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L58)
 
 Emits the specified event type with the given arguments.
 
@@ -62,7 +62,7 @@ The result of the event.
 
 > **emitAsync**(`eventName`, ...`args`): `Promise`\<`any`\>
 
-Defined in: [src/event-emitter.d.ts:54](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event-emitter.d.ts#L54)
+Defined in: [src/event-emitter.d.ts:64](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L64)
 
 Asynchronously emits the specified event type with the given arguments.
 
@@ -90,7 +90,7 @@ A promise that resolves with the result of the event.
 
 > **listenerCount**(`eventName`): `number`
 
-Defined in: [src/event-emitter.d.ts:83](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event-emitter.d.ts#L83)
+Defined in: [src/event-emitter.d.ts:93](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L93)
 
 Returns the count of listeners that are registered to listen for the specified event.
 
@@ -114,7 +114,7 @@ The name of the event to get the listeners for.
 
 > **listeners**(`eventName`): `Function`[]
 
-Defined in: [src/event-emitter.d.ts:76](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event-emitter.d.ts#L76)
+Defined in: [src/event-emitter.d.ts:86](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L86)
 
 Returns an array of functions that are registered to listen for the specified event.
 
@@ -138,7 +138,7 @@ The name of the event to get the listeners for.
 
 > **off**(`eventName`, `listener`): `EventEmitter`
 
-Defined in: [src/event-emitter.d.ts:33](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event-emitter.d.ts#L33)
+Defined in: [src/event-emitter.d.ts:43](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L43)
 
 Removes a listener function from the specified event type.
 
@@ -172,9 +172,9 @@ If the listener is not a function.
 
 ### on()
 
-> **on**(`eventName`, `listener`): `EventEmitter`
+> **on**(`eventName`, `listener`, `index?`): `EventEmitter`
 
-Defined in: [src/event-emitter.d.ts:16](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event-emitter.d.ts#L16)
+Defined in: [src/event-emitter.d.ts:21](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L21)
 
 Adds a listener function to the specified event type.
 
@@ -190,6 +190,16 @@ Adds a listener function to the specified event type.
 
 The listener function to be called when the event is emitted.
 
+##### index?
+
+The index at which to insert the listener.
+       - 'first' or -Infinity: adds to the beginning of the listeners (stay at the front).
+       - 'last' or Infinity: adds to the end of the listeners (stay at the back).
+       - number: inserts at the specified index within the normal listeners zone.
+       If not specified, the listener will be added at the end of the normal listeners.
+
+`number` | `"first"` | `"last"`
+
 #### Returns
 
 `EventEmitter`
@@ -204,9 +214,9 @@ If the listener is not a function.
 
 ### once()
 
-> **once**(`eventName`, `listener`): `EventEmitter`
+> **once**(`eventName`, `listener`, `index?`): `EventEmitter`
 
-Defined in: [src/event-emitter.d.ts:24](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event-emitter.d.ts#L24)
+Defined in: [src/event-emitter.d.ts:34](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L34)
 
 Adds a one-time listener function to the specified event type.
 
@@ -222,6 +232,16 @@ Adds a one-time listener function to the specified event type.
 
 The listener function to be called once when the event is emitted.
 
+##### index?
+
+The index at which to insert the listener.
+       - 'first' or -Infinity: adds to the beginning of the listeners (stay at the front).
+       - 'last' or Infinity: adds to the end of the listeners (stay at the back).
+       - number: inserts at the specified index within the normal listeners zone.
+       If not specified, the listener will be added at the end of the normal listeners.
+
+`number` | `"first"` | `"last"`
+
 #### Returns
 
 `EventEmitter`
@@ -238,7 +258,7 @@ If the listener is not a function.
 
 > **removeAllListeners**(`eventName?`): `EventEmitter`
 
-Defined in: [src/event-emitter.d.ts:61](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event-emitter.d.ts#L61)
+Defined in: [src/event-emitter.d.ts:71](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L71)
 
 Removes all listeners for a specific event or all events from an event emitter.
 
@@ -262,7 +282,7 @@ The event to remove listeners for. If not provided, all listeners for all events
 
 > **removeListener**(`eventName`, `listener`): `EventEmitter`
 
-Defined in: [src/event-emitter.d.ts:42](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event-emitter.d.ts#L42)
+Defined in: [src/event-emitter.d.ts:52](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L52)
 
 Removes a listener function from the specified event type.
 
@@ -298,7 +318,7 @@ If the listener is not a function.
 
 > **setMaxListeners**(`n`): `EventEmitter`
 
-Defined in: [src/event-emitter.d.ts:69](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event-emitter.d.ts#L69)
+Defined in: [src/event-emitter.d.ts:79](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L79)
 
 Sets the maximum number of listeners allowed for the event emitter.
 
@@ -326,7 +346,7 @@ If `n` is not a positive integer.
 
 > `static` **listenerCount**(`emitter`, `eventName`): `number`
 
-Defined in: [src/event-emitter.d.ts:91](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/event-emitter.d.ts#L91)
+Defined in: [src/event-emitter.d.ts:101](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/event-emitter.d.ts#L101)
 
 Returns the count of listeners that are registered to listen for the specified event.
 

package/docs/eventable/functions/eventable.md

@@ -8,7 +8,7 @@
 
 > **eventable**\<`T`\>(`targetClass?`, `options?`): `EnhancedClass`\<`T`, (`aClass?`) => `Function`\>
 
-Defined in: [src/eventable.js:89](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/eventable.js#L89)
+Defined in: [src/eventable.js:89](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/eventable.js#L89)
 
 Adds event-emitting capabilities to a class by injecting necessary methods and properties.
 

package/docs/has-listeners/functions/hasListeners.md

@@ -8,7 +8,7 @@
 
 > **hasListeners**(`obj`, `type?`): `boolean`
 
-Defined in: [src/has-listeners.js:20](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/has-listeners.js#L20)
+Defined in: [src/has-listeners.js:20](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/has-listeners.js#L20)
 
 Checks if an object has event listeners.
 

package/docs/pipe/functions/pipe.md

@@ -8,7 +8,7 @@
 
 > **pipe**(`e1`, `e2`, ...`args`): `any`
 
-Defined in: [src/pipe.js:21](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/pipe.js#L21)
+Defined in: [src/pipe.js:21](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/pipe.js#L21)
 
 Creates a pipeline between two event emitters, so that any events emitted by the first emitter are also emitted by the second emitter.
 

package/docs/pipe-async/functions/pipeAsync.md

@@ -8,7 +8,7 @@
 
 > **pipeAsync**(`e1`, `e2`, ...`args`): `any`
 
-Defined in: [src/pipe-async.js:24](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/pipe-async.js#L24)
+Defined in: [src/pipe-async.js:24](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/pipe-async.js#L24)
 
 Creates a pipeline between two event emitters, so that any events emitted by the first emitter are also emitted by the second emitter.
 

package/docs/unify/functions/unify.md

@@ -8,7 +8,7 @@
 
 > **unify**(`e1`, `e2`): `void`
 
-Defined in: [src/unify.js:17](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/unify.js#L17)
+Defined in: [src/unify.js:17](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/unify.js#L17)
 
 Unifies the event listeners of two event emitter objects so that they share the same set of listeners for each event.
 

package/docs/util/array-remove/functions/remove.md

@@ -8,7 +8,7 @@
 
 > **remove**(...`args`): `void`
 
-Defined in: [src/util/array-remove.js:5](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/util/array-remove.js#L5)
+Defined in: [src/util/array-remove.js:5](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/util/array-remove.js#L5)
 
 ## Parameters
 

package/docs/util/object-for-each/functions/forEach.md

@@ -8,7 +8,7 @@
 
 > **forEach**(`obj`, `cb`, ...`args`): `void`
 
-Defined in: [src/util/object-for-each.js:6](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/util/object-for-each.js#L6)
+Defined in: [src/util/object-for-each.js:6](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/util/object-for-each.js#L6)
 
 ## Parameters
 

package/docs/util/string-pad/functions/pad.md

@@ -8,7 +8,7 @@
 
 > **pad**(`fill`, ...`args`): `string`
 
-Defined in: [src/util/string-pad.js:8](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/util/string-pad.js#L8)
+Defined in: [src/util/string-pad.js:8](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/util/string-pad.js#L8)
 
 ## Parameters
 

package/docs/util/to-int/functions/toInt.md

@@ -8,7 +8,7 @@
 
 > **toInt**(`value`): `any`
 
-Defined in: [src/util/to-int.js:2](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/util/to-int.js#L2)
+Defined in: [src/util/to-int.js:2](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/util/to-int.js#L2)
 
 ## Parameters
 

package/docs/util/valid-callable/functions/validCallable.md

@@ -8,7 +8,7 @@
 
 > **validCallable**(`fn`): `any`
 
-Defined in: [src/util/valid-callable.js:1](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/util/valid-callable.js#L1)
+Defined in: [src/util/valid-callable.js:1](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/util/valid-callable.js#L1)
 
 ## Parameters
 

package/docs/util/valid-object/functions/validObject.md

@@ -8,7 +8,7 @@
 
 > **validObject**(`value`): `any`
 
-Defined in: [src/util/valid-object.js:3](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/util/valid-object.js#L3)
+Defined in: [src/util/valid-object.js:3](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/util/valid-object.js#L3)
 
 ## Parameters
 

package/docs/wrap-event-emitter/functions/wrapEventEmitter.md

@@ -8,7 +8,7 @@
 
 > **wrapEventEmitter**(`o?`, `options?`): `any`
 
-Defined in: [src/wrap-event-emitter.js:37](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/wrap-event-emitter.js#L37)
+Defined in: [src/wrap-event-emitter.js:37](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/wrap-event-emitter.js#L37)
 
 Create or inject the eventable instance into the object
 

package/docs/wrap-event-emitter/variables/methods.md

@@ -8,4 +8,4 @@
 
 > `const` **methods**: `any`
 
-Defined in: [src/wrap-event-emitter.js:7](https://github.com/snowyu/events-ex.js/blob/fb077063a0ea7231fa89bf74a09be2f52f8401e4/src/wrap-event-emitter.js#L7)
+Defined in: [src/wrap-event-emitter.js:7](https://github.com/snowyu/events-ex.js/blob/f6c44157ffda17957fad5ad2e0aedbb8ec521be7/src/wrap-event-emitter.js#L7)

package/lib/default-methods.d.ts

@@ -26,20 +26,28 @@ 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.
+     * @param {number|'first'|'last'} [index] - The index at which to insert the listener.
+     *        - 'first' or -Infinity: Adds to the "Head" zone. The first listener added as 'first' is placed at the very front.
+     *        - 'last' or Infinity: Adds to the "Tail" zone. The first listener added as 'last' will always be the very last one to execute.
+     *        - number: Inserts at the specified index within the "Body" (normal) zone.
+     *        If not specified, the listener is added to the end of the "Body" zone.
      * @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, index?: number): import("./event-emitter").EventEmitter;
+    on(type: string | RegExp, listener: Function, index?: number | "first" | "last"): 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.
+     * @param {number|'first'|'last'} [index] - The index at which to insert the listener.
+     *        - 'first' or -Infinity: Adds to the "Head" zone. The first listener added as 'first' is placed at the very front.
+     *        - 'last' or Infinity: Adds to the "Tail" zone. The first listener added as 'last' will always be the very last one to execute.
+     *        - number: Inserts at the specified index within the "Body" (normal) zone.
+     *        If not specified, the listener is added to the end of the "Body" zone.
      * @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, index?: number): import("./event-emitter").EventEmitter;
+    once(type: string | RegExp, listener: Function, index?: number | "first" | "last"): 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

@@ -68,7 +68,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.
+     * @param {number|'first'|'last'} [index] - The index at which to insert the listener.
+     *        - 'first' or -Infinity: Adds to the "Head" zone. The first listener added as 'first' is placed at the very front.
+     *        - 'last' or Infinity: Adds to the "Tail" zone. The first listener added as 'last' will always be the very last one to execute.
+     *        - number: Inserts at the specified index within the "Body" (normal) zone.
+     *        If not specified, the listener is added to the end of the "Body" zone.
      * @returns {import('./event-emitter').EventEmitter} The EventEmitter instance to allow chaining.
      * @throws {TypeError} If the listener is not a function.
      */
@@ -91,16 +95,35 @@ function getEventableMethods(aClass) {
       if (isRegExp(type)) {
         data = data[_consts.RegExpEventSymbol] || (data[_consts.RegExpEventSymbol] = create(null));
       }
+      const isFirst = index === -Infinity || index === 'first';
+      const isLast = index === Infinity || index === 'last';
       if (!data[type]) {
-        data[type] = listener;
-      } else if ((0, _utilEx.isObject)(data[type])) {
-        if (typeof index === 'number') {
-          data[type].splice(index, 0, listener);
+        if (isFirst || isLast || typeof index === 'number') {
+          data[type] = [listener];
+          if (isFirst) data[type]._headCount = 1;
+          if (isLast) data[type]._tailCount = 1;
         } else {
-          data[type].push(listener);
+          data[type] = listener;
         }
       } else {
-        data[type] = [data[type], listener];
+        if ((0, _utilEx.isFunction)(data[type])) {
+          data[type] = [data[type]];
+        }
+        const listeners = data[type];
+        const headCount = listeners._headCount || 0;
+        const tailCount = listeners._tailCount || 0;
+        if (isFirst) {
+          listeners.splice(headCount, 0, listener);
+          listeners._headCount = headCount + 1;
+        } else if (isLast) {
+          listeners.splice(listeners.length - tailCount, 0, listener);
+          listeners._tailCount = tailCount + 1;
+        } else if (typeof index === 'number' && !isNaN(index)) {
+          const pos = Math.min(Math.max(headCount + index, headCount), listeners.length - tailCount);
+          listeners.splice(pos, 0, listener);
+        } else {
+          listeners.splice(listeners.length - tailCount, 0, listener);
+        }
       }
       // Check for listener leak
       if ((0, _utilEx.isObject)(data[type]) && !data[type].warned) {
@@ -121,7 +144,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.
+     * @param {number|'first'|'last'} [index] - The index at which to insert the listener.
+     *        - 'first' or -Infinity: Adds to the "Head" zone. The first listener added as 'first' is placed at the very front.
+     *        - 'last' or Infinity: Adds to the "Tail" zone. The first listener added as 'last' will always be the very last one to execute.
+     *        - number: Inserts at the specified index within the "Body" (normal) zone.
+     *        If not specified, the listener is added to the end of the "Body" zone.
      * @returns {import('./event-emitter').EventEmitter} The EventEmitter instance to allow chaining.
      * @throws {TypeError} If the listener is not a function.
      */
@@ -295,10 +322,14 @@ function getEventableMethods(aClass) {
         if (i < 0) {
           return this;
         }
+        if (listeners._headCount && i < listeners._headCount) {
+          listeners._headCount--;
+        } else if (listeners._tailCount && i >= listeners.length - listeners._tailCount) {
+          listeners._tailCount--;
+        }
         if (listeners.length === 1) {
-          listeners.length = 0;
           delete data[type];
-        } else if (listeners.length === 2) {
+        } else if (listeners.length === 2 && !listeners._headCount && !listeners._tailCount) {
           data[type] = listeners[i ? 0 : 1];
           listeners.length = 1;
         } else {

package/lib/event-emitter.d.ts

@@ -10,18 +10,28 @@ export class EventEmitter {
    * 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|'first'|'last'} [index] - The index at which to insert the listener.
+   *        - 'first' or -Infinity: adds to the beginning of the listeners (stay at the front).
+   *        - 'last' or Infinity: adds to the end of the listeners (stay at the back).
+   *        - number: inserts at the specified index within the normal listeners zone.
+   *        If not specified, the listener will be added at the end of the normal listeners.
    * @returns {EventEmitter} The EventEmitter instance to allow chaining.
    * @throws {TypeError} If the listener is not a function.
    */
-  on(eventName: string|RegExp, listener: ListenerCallbackFunc): EventEmitter;
+  on(eventName: string|RegExp, listener: ListenerCallbackFunc, index?: number|'first'|'last'): 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|'first'|'last'} [index] - The index at which to insert the listener.
+   *        - 'first' or -Infinity: adds to the beginning of the listeners (stay at the front).
+   *        - 'last' or Infinity: adds to the end of the listeners (stay at the back).
+   *        - number: inserts at the specified index within the normal listeners zone.
+   *        If not specified, the listener will be added at the end of the normal listeners.
    * @returns {EventEmitter} The EventEmitter instance to allow chaining.
    * @throws {TypeError} If the listener is not a function.
    */
-  once(eventName: string|RegExp, listener: ListenerCallbackFunc): EventEmitter;
+  once(eventName: string|RegExp, listener: ListenerCallbackFunc, index?: number|'first'|'last'): EventEmitter;
   /**
    * Removes a listener function from the specified event type.
    * @param {string|RegExp} type - The event type to remove the listener from.

package/package.json

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

package/src/default-methods.js

@@ -62,7 +62,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.
+     * @param {number|'first'|'last'} [index] - The index at which to insert the listener.
+     *        - 'first' or -Infinity: Adds to the "Head" zone. The first listener added as 'first' is placed at the very front.
+     *        - 'last' or Infinity: Adds to the "Tail" zone. The first listener added as 'last' will always be the very last one to execute.
+     *        - number: Inserts at the specified index within the "Body" (normal) zone.
+     *        If not specified, the listener is added to the end of the "Body" zone.
      * @returns {import('./event-emitter').EventEmitter} The EventEmitter instance to allow chaining.
      * @throws {TypeError} If the listener is not a function.
      */
@@ -83,16 +87,38 @@ export function getEventableMethods(aClass) {
       if (isRegExp(type)) {
         data = data[RegExpEventSymbol] || (data[RegExpEventSymbol] = create(null))
       }
-      if  (!data[type]) {
-        data[type] = listener
-      } else if (isObject(data[type])) {
-        if (typeof index === 'number') {
-          data[type].splice(index, 0, listener)
+
+      const isFirst = index === -Infinity || index === 'first'
+      const isLast = index === Infinity || index === 'last'
+
+      if (!data[type]) {
+        if (isFirst || isLast || typeof index === 'number') {
+          data[type] = [listener]
+          if (isFirst) data[type]._headCount = 1
+          if (isLast) data[type]._tailCount = 1
         } else {
-          data[type].push(listener)
+          data[type] = listener
         }
       } else {
-        data[type] = [data[type], listener]
+        if (isFunction(data[type])) {
+          data[type] = [data[type]]
+        }
+        const listeners = data[type]
+        const headCount = listeners._headCount || 0
+        const tailCount = listeners._tailCount || 0
+
+        if (isFirst) {
+          listeners.splice(headCount, 0, listener)
+          listeners._headCount = headCount + 1
+        } else if (isLast) {
+          listeners.splice(listeners.length - tailCount, 0, listener)
+          listeners._tailCount = tailCount + 1
+        } else if (typeof index === 'number' && !isNaN(index)) {
+          const pos = Math.min(Math.max(headCount + index, headCount), listeners.length - tailCount)
+          listeners.splice(pos, 0, listener)
+        } else {
+          listeners.splice(listeners.length - tailCount, 0, listener)
+        }
       }
       // Check for listener leak
       if (isObject(data[type]) && !data[type].warned) {
@@ -119,7 +145,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.
+     * @param {number|'first'|'last'} [index] - The index at which to insert the listener.
+     *        - 'first' or -Infinity: Adds to the "Head" zone. The first listener added as 'first' is placed at the very front.
+     *        - 'last' or Infinity: Adds to the "Tail" zone. The first listener added as 'last' will always be the very last one to execute.
+     *        - number: Inserts at the specified index within the "Body" (normal) zone.
+     *        If not specified, the listener is added to the end of the "Body" zone.
      * @returns {import('./event-emitter').EventEmitter} The EventEmitter instance to allow chaining.
      * @throws {TypeError} If the listener is not a function.
      */
@@ -275,10 +305,16 @@ export function getEventableMethods(aClass) {
           if (candidate === listener || candidate.listener === listener) {break}
         }
         if (i < 0) {return this}
+
+        if (listeners._headCount && i < listeners._headCount) {
+          listeners._headCount--
+        } else if (listeners._tailCount && i >= listeners.length - listeners._tailCount) {
+          listeners._tailCount--
+        }
+
         if (listeners.length === 1) {
-          listeners.length = 0
           delete data[type]
-        } else if (listeners.length === 2) {
+        } else if (listeners.length === 2 && !listeners._headCount && !listeners._tailCount) {
           data[type] = listeners[(i ? 0 : 1)]
           listeners.length = 1
         } else {

package/src/event-emitter.d.ts

@@ -10,18 +10,28 @@ export class EventEmitter {
    * 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|'first'|'last'} [index] - The index at which to insert the listener.
+   *        - 'first' or -Infinity: adds to the beginning of the listeners (stay at the front).
+   *        - 'last' or Infinity: adds to the end of the listeners (stay at the back).
+   *        - number: inserts at the specified index within the normal listeners zone.
+   *        If not specified, the listener will be added at the end of the normal listeners.
    * @returns {EventEmitter} The EventEmitter instance to allow chaining.
    * @throws {TypeError} If the listener is not a function.
    */
-  on(eventName: string|RegExp, listener: ListenerCallbackFunc): EventEmitter;
+  on(eventName: string|RegExp, listener: ListenerCallbackFunc, index?: number|'first'|'last'): 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|'first'|'last'} [index] - The index at which to insert the listener.
+   *        - 'first' or -Infinity: adds to the beginning of the listeners (stay at the front).
+   *        - 'last' or Infinity: adds to the end of the listeners (stay at the back).
+   *        - number: inserts at the specified index within the normal listeners zone.
+   *        If not specified, the listener will be added at the end of the normal listeners.
    * @returns {EventEmitter} The EventEmitter instance to allow chaining.
    * @throws {TypeError} If the listener is not a function.
    */
-  once(eventName: string|RegExp, listener: ListenerCallbackFunc): EventEmitter;
+  once(eventName: string|RegExp, listener: ListenerCallbackFunc, index?: number|'first'|'last'): EventEmitter;
   /**
    * Removes a listener function from the specified event type.
    * @param {string|RegExp} type - The event type to remove the listener from.

package/.npmrcx

@@ -1,5 +0,0 @@
-//registry.npmjs.org/:_authToken=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 // riceball
-registry=https://registry.npmjs.org/
-# 只支持http代理,所以需要 yarn global add http-proxy-to-socks, 将socks代理转为http代理
-# hpts -s localhost:1081 -p 8880
-# https-proxy=http://localhost:8880