fastevent 1.1.0 → 1.1.2

package/dist/index.d.ts

@@ -3,7 +3,7 @@ type FastEventMessage<T = string, P = any, M = unknown> = {
     payload: P;
     meta: M;
 };
-type FastEventListener<T = string, P = any, M = unknown> = (message: FastEventMessage<T, P, M>) => any | Promise<any>;
+type FastEventListener<T = string, P = any, M = unknown, C = any> = (this: C, message: FastEventMessage<T, P, M>) => any | Promise<any>;
 type FastListenerNode = {
     __listeners: (FastEventListener<any, any, any> | [FastEventListener<any, any>, number])[];
 } & {
@@ -16,7 +16,9 @@ interface FastEventListenerMeta {
     emitter?: string;
 }
 type FastListeners = FastListenerNode;
-type FastEventOptions<M = unknown> = {
+type FastEventOptions<M = Record<string, any>> = {
+    id?: string;
+    debug?: boolean;
     delimiter?: string;
     context?: any;
     ignoreErrors?: boolean;
@@ -24,6 +26,8 @@ type FastEventOptions<M = unknown> = {
     meta?: M;
     onAddListener?: (type: string[], listener: FastEventListener) => void;
     onRemoveListener?: (type: string[], listener: FastEventListener) => void;
+    onClearListeners?: () => void;
+    onExecuteListener?: (message: FastEventMessage, returns: any[], listeners: (FastEventListener<any, any, any> | [FastEventListener<any, any>, number])[]) => void;
 };
 type FastEvents = Record<string, any>;
 type ScopeEvents<T extends Record<string, any>, Prefix extends string> = {
@@ -34,18 +38,19 @@ type FastEventListenOptions = {
     prepend?: boolean;
 };
 
-declare class FastEventScope<Events extends FastEvents = FastEvents, Meta extends Record<string, any> = Record<string, any>, Types extends keyof Events = keyof Events> {
+declare class FastEventScope<Events extends FastEvents = FastEvents, Meta extends Record<string, any> = Record<string, any>, Context = any, Types extends keyof Events = keyof Events> {
     emitter: FastEvent<Events, Meta, Types>;
     prefix: string;
     constructor(emitter: FastEvent<Events, Meta, Types>, prefix: string);
     private _getScopeListener;
     private _getScopeType;
-    on<T extends string>(type: T, listener: FastEventListener<T, Events[T], Meta>, options?: FastEventListenOptions): FastEventSubscriber;
-    on<T extends Types = Types>(type: T, listener: FastEventListener<T, Events[T], Meta>, options?: FastEventListenOptions): FastEventSubscriber;
-    on(type: '**', listener: FastEventListener<any, any, Meta>): FastEventSubscriber;
-    once<T extends string>(type: T, listener: FastEventListener<T, Events[T], Meta>, options?: FastEventListenOptions): FastEventSubscriber;
-    once<T extends Types = Types>(type: T, listener: FastEventListener<Types, Events[T], Meta>, options?: FastEventListenOptions): FastEventSubscriber;
-    onAny<P = any>(listener: FastEventListener<Types, P, Meta>, options?: FastEventListenOptions): FastEventSubscriber;
+    private _fixScopeType;
+    on<T extends Types = Types>(type: T, listener: FastEventListener<T, Events[T], Meta, Context>, options?: FastEventListenOptions): FastEventSubscriber;
+    on<T extends string>(type: T, listener: FastEventListener<T, Events[T], Meta, Context>, options?: FastEventListenOptions): FastEventSubscriber;
+    on(type: '**', listener: FastEventListener<any, any, Meta, Context>): FastEventSubscriber;
+    once<T extends string>(type: T, listener: FastEventListener<T, Events[T], Meta, Context>, options?: FastEventListenOptions): FastEventSubscriber;
+    once<T extends Types = Types>(type: T, listener: FastEventListener<Types, Events[T], Meta, Context>, options?: FastEventListenOptions): FastEventSubscriber;
+    onAny<P = any>(listener: FastEventListener<Types, P, Meta, Context>, options?: FastEventListenOptions): FastEventSubscriber;
     offAll(): void;
     off(listener: FastEventListener<any, any, any>): void;
     off(type: string, listener: FastEventListener<any, any, any>): void;
@@ -53,22 +58,83 @@ declare class FastEventScope<Events extends FastEvents = FastEvents, Meta extend
     off(type: string): void;
     off(type: Types): void;
     clear(): void;
-    emit<R = any>(type: string, payload?: any, retain?: boolean): R[];
     emit<R = any>(type: Types, payload?: Events[Types], retain?: boolean): R[];
-    waitFor<R = any>(type: string, timeout?: number): Promise<R>;
-    waitFor<R = any>(type: Types, timeout?: number): Promise<R>;
-    scope(prefix: string): FastEventScope<ScopeEvents<Events, string>, Record<string, any>, keyof ScopeEvents<Events, string>>;
+    emit<R = any>(type: string, payload?: any, retain?: boolean): R[];
+    waitFor<T extends Types, P = Events[T], M = Meta>(type: T, timeout?: number): Promise<FastEventMessage<T, P, M>>;
+    waitFor<T extends string, P = Events[T], M = Meta>(type: string, timeout?: number): Promise<FastEventMessage<T, P, M>>;
+    /**
+     * 创建一个新的作用域实例
+     * @param prefix - 作用域前缀
+     * @returns 新的FastEventScope实例
+     *
+     * @description
+     * 基于当前作用域创建一个新的子作用域。新作用域会继承当前作用域的所有特性，
+     * 并在事件类型前添加额外的前缀。这允许创建层级化的事件命名空间。
+     *
+     * 作用域的特性：
+     * - 自动为所有事件类型添加前缀
+     * - 在触发事件时自动添加前缀
+     * - 在接收事件时自动移除前缀
+     * - 支持多层级的作用域嵌套
+     *
+     * @example
+     * ```ts
+     * const emitter = new FastEvent();
+     * const userScope = emitter.scope('user');
+     * const profileScope = userScope.scope('profile');
+     *
+     * // 在profileScope中监听'update'事件
+     * // 实际监听的是'user/profile/update'
+     * profileScope.on('update', (data) => {
+     *   console.log('Profile updated:', data);
+     * });
+     *
+     * // 在profileScope中触发'update'事件
+     * // 实际触发的是'user/profile/update'
+     * profileScope.emit('update', { name: 'John' });
+     * ```
+     */
+    scope(prefix: string): FastEventScope<ScopeEvents<Events, string>, Record<string, any>, any, keyof ScopeEvents<Events, string>>;
 }
 
-declare class FastEvent<Events extends FastEvents = FastEvents, Meta extends Record<string, any> = Record<string, any>, Types extends keyof Events = keyof Events> {
+/**
+ * FastEvent 事件发射器类
+ *
+ * @template Events - 事件类型定义，继承自FastEvents接口
+ * @template Meta - 事件元数据类型，默认为任意键值对对象
+ * @template Types - 事件类型的键名类型，默认为Events的键名类型
+ */
+declare class FastEvent<Events extends FastEvents = FastEvents, Meta extends Record<string, any> = Record<string, any>, Context = any, Types extends keyof Events = keyof Events> {
+    /** 事件监听器树结构，存储所有注册的事件监听器 */
     listeners: FastListeners;
+    /** 事件发射器的配置选项 */
     private _options;
+    /** 事件名称的分隔符，默认为'/' */
     private _delimiter;
+    /** 事件监听器执行时的上下文对象 */
     private _context;
-    private _retainedEvents;
+    /** 保留的事件消息映射，用于新订阅者 */
+    retainedMessages: Map<string, any>;
+    /** 当前注册的监听器总数 */
+    listenerCount: number;
+    /**
+     * 创建FastEvent实例
+     * @param options - 事件发射器的配置选项
+     *
+     * 默认配置：
+     * - debug: false - 是否启用调试模式
+     * - id: 随机字符串 - 实例唯一标识符
+     * - delimiter: '/' - 事件名称分隔符
+     * - context: null - 监听器执行上下文
+     * - ignoreErrors: true - 是否忽略监听器执行错误
+     */
     constructor(options?: FastEventOptions<Meta>);
+    /** 获取事件发射器的配置选项 */
     get options(): FastEventOptions;
+    /** 获取事件发射器的唯一标识符 */
+    get id(): string;
     private _addListener;
+    private _enableDevTools;
     /**
      *
      * 根据parts路径遍历侦听器树，并在最后的节点上执行回调函数
@@ -86,11 +152,56 @@ declare class FastEvent<Events extends FastEvents = FastEvents, Meta extends Rec
      * @description 遍历节点的监听器列表,移除所有匹配的监听器。支持移除普通函数和数组形式的监听器
      */
     private _removeListener;
-    on<T extends string>(type: T, listener: FastEventListener<T, Events[T], Meta>, options?: FastEventListenOptions): FastEventSubscriber;
-    on<T extends Types = Types>(type: T, listener: FastEventListener<Types, Events[T], Meta>, options?: FastEventListenOptions): FastEventSubscriber;
-    on<P = any>(type: '**', listener: FastEventListener<Types, P, Meta>): FastEventSubscriber;
-    once<T extends string>(type: T, listener: FastEventListener<T, Events[T], Meta>): FastEventSubscriber;
-    once<T extends Types = Types>(type: T, listener: FastEventListener<Types, Events[T], Meta>): FastEventSubscriber;
+    /**
+     * 注册事件监听器
+     * @param type - 事件类型，支持以下格式：
+     *   - 普通字符串：'user/login'
+     *   - 通配符：'user/*'（匹配单层）或'user/**'（匹配多层）
+     *   - 全局监听：'**'（监听所有事件）
+     * @param listener - 事件监听器函数
+     * @param options - 监听器配置选项：
+     *   - count: 触发次数限制，0表示无限制
+     *   - prepend: 是否将监听器添加到监听器队列开头
+     * @returns 返回订阅者对象，包含off方法用于取消监听
+     *
+     * @example
+     * ```ts
+     * // 监听特定事件
+     * emitter.on('user/login', (data) => console.log(data));
+     *
+     * // 使用通配符
+     * emitter.on('user/*', (data) => console.log(data));
+     *
+     * // 限制触发次数
+     * emitter.on('event', handler, { count: 3 });
+     * ```
+     */
+    on<T extends string>(type: T, listener: FastEventListener<T, Events[T], Meta, Context>, options?: FastEventListenOptions): FastEventSubscriber;
+    on<T extends Types = Types>(type: T, listener: FastEventListener<Types, Events[T], Meta, Context>, options?: FastEventListenOptions): FastEventSubscriber;
+    on<P = any>(type: '**', listener: FastEventListener<Types, P, Meta, Context>): FastEventSubscriber;
+    /**
+     * 注册一次性事件监听器
+     * @param type - 事件类型，支持与on方法相同的格式：
+     *   - 普通字符串：'user/login'
+     *   - 通配符：'user/*'（匹配单层）或'user/**'（匹配多层）
+     * @param listener - 事件监听器函数
+     * @returns 返回订阅者对象，包含off方法用于取消监听
+     *
+     * @description
+     * 监听器只会在事件首次触发时被调用一次，之后会自动解除注册。
+     * 这是on方法的特例，相当于设置options.count = 1。
+     * 如果事件有保留消息，新注册的监听器会立即收到最近一次的保留消息并解除注册。
+     *
+     * @example
+     * ```ts
+     * // 只监听一次登录事件
+     * emitter.once('user/login', (data) => {
+     *   console.log('用户登录:', data);
+     * });
+     * ```
+     */
+    once<T extends Types = Types>(type: T, listener: FastEventListener<T, Events[T], Meta, Context>): FastEventSubscriber;
+    once<T extends string>(type: T, listener: FastEventListener<T, Events[T], Meta, Context>): FastEventSubscriber;
     /**
      * 注册一个监听器，用于监听所有事件
      * @param listener 事件监听器函数，可以接收任意类型的事件数据
@@ -105,7 +216,7 @@ declare class FastEvent<Events extends FastEvents = FastEvents, Meta extends Rec
      * subscriber.off();
      * ```
      */
-    onAny<P = any>(listener: FastEventListener<string, P, Meta>, options?: Pick<FastEventListenOptions, 'prepend'>): FastEventSubscriber;
+    onAny<P = any>(listener: FastEventListener<string, P, Meta, Context>, options?: Pick<FastEventListenOptions, 'prepend'>): FastEventSubscriber;
     off(listener: FastEventListener<any, any, any>): void;
     off(type: string, listener: FastEventListener<any, any, any>): void;
     off(type: Types, listener: FastEventListener<any, any, any>): void;
@@ -156,6 +267,23 @@ declare class FastEvent<Events extends FastEvents = FastEvents, Meta extends Rec
      */
     private _traverseToPath;
     private _traverseListeners;
+    /**
+     * 执行单个监听器函数
+     * @param listener - 要执行的监听器函数或包装过的监听器对象
+     * @param message - 事件消息对象，包含type、payload和meta
+     * @returns 监听器的执行结果或错误对象（如果配置了ignoreErrors）
+     * @private
+     *
+     * @description
+     * 执行单个监听器函数，处理以下情况：
+     * - 如果监听器是包装过的（有__wrappedListener属性），调用包装的函数
+     * - 否则直接调用监听器函数
+     * - 使用配置的上下文（_context）作为this
+     * - 捕获并处理执行过程中的错误：
+     *   - 如果有onListenerError回调，调用它
+     *   - 如果配置了ignoreErrors，返回错误对象
+     *   - 否则抛出错误
+     */
     private _executeListener;
     /**
      * 执行监听器节点中的所有监听函数
@@ -187,39 +315,156 @@ declare class FastEvent<Events extends FastEvents = FastEvents, Meta extends Rec
      * // 方式2: 对象形式
      * emit({ type: 'user.login', payload: { id: 1 } ,meta:{...}}}, true)
      */
+    /**
+     * 同步触发事件
+     * @param type - 事件类型，可以是字符串或预定义的事件类型
+     * @param payload - 事件数据负载
+     * @param retain - 是否保留该事件，用于后续新的订阅者
+     * @param meta - 事件元数据
+     * @returns 所有监听器的执行结果数组
+     *
+     * @description
+     * 同步触发指定类型的事件，支持两种调用方式：
+     * 1. 参数形式：emit(type, payload, retain, meta)
+     * 2. 对象形式：emit({ type, payload, meta }, retain)
+     *
+     * 特性：
+     * - 支持通配符匹配，一个事件可能触发多个监听器
+     * - 如果设置了retain为true，会保存最后一次的事件数据
+     * - 按照注册顺序同步调用所有匹配的监听器
+     * - 如果配置了ignoreErrors，监听器抛出的错误会被捕获并返回
+     *
+     * @example
+     * ```ts
+     * // 简单事件触发
+     * emitter.emit('user/login', { userId: 123 });
+     *
+     * // 带保留的事件触发
+     * emitter.emit('status/change', { online: true }, true);
+     *
+     * // 带元数据的事件触发
+     * emitter.emit('data/update', newData, false, { timestamp: Date.now() });
+     *
+     * // 使用对象形式触发
+     * emitter.emit({
+     *   type: 'user/login',
+     *   payload: { userId: 123 },
+     *   meta: { time: Date.now() }
+     * }, true);
+     * ```
+     */
     emit<R = any>(type: string, payload?: any, retain?: boolean, meta?: Meta): R[];
     emit<R = any>(type: Types, payload?: Events[Types], retain?: boolean, meta?: Meta): R[];
     emit<R = any>(message: FastEventMessage<Types, Events[Types], Meta>, retain?: boolean): R[];
     emit<R = any>(message: FastEventMessage<string, any, Meta>, retain?: boolean): R[];
+    /**
+     * 异步触发事件
+     * @param type - 事件类型，可以是字符串或预定义的事件类型
+     * @param payload - 事件数据负载
+     * @param retain - 是否保留该事件，用于后续新的订阅者
+     * @param meta - 事件元数据
+     * @returns Promise，解析为所有监听器的执行结果数组
+     *
+     * @description
+     * 异步触发指定类型的事件，与emit方法类似，但有以下区别：
+     * - 返回Promise，等待所有异步监听器执行完成
+     * - 使用Promise.allSettled处理监听器的执行结果
+     * - 即使某些监听器失败，也会等待所有监听器执行完成
+     * - 返回结果包含成功值或错误信息
+     *
+     * @example
+     * ```ts
+     * // 异步事件处理
+     * const results = await emitter.emitAsync('data/process', rawData);
+     *
+     * // 处理结果包含成功和失败的情况
+     * results.forEach(result => {
+     *   if (result instanceof Error) {
+     *     console.error('处理失败:', result);
+     *   } else {
+     *     console.log('处理成功:', result);
+     *   }
+     * });
+     *
+     * // 带元数据的异步事件
+     * await emitter.emitAsync('batch/process', items, false, {
+     *   batchId: 'batch-001',
+     *   timestamp: Date.now()
+     * });
+     * ```
+     */
     emitAsync<R = any>(type: string, payload?: any, retain?: boolean, meta?: Meta): Promise<[R | Error][]>;
     emitAsync<R = any>(type: Types, payload?: Events[Types], retain?: boolean, meta?: Meta): Promise<[R | Error][]>;
     /**
-     * 等待指定事件发生
+     * 等待指定事件发生，返回一个Promise
+     * @param type - 要等待的事件类型
+     * @param timeout - 超时时间（毫秒），默认为0表示永不超时
+     * @returns Promise，解析为事件消息对象，包含type、payload和meta
+     *
+     * @description
+     * 创建一个Promise，在指定事件发生时解析。
+     * - 当事件触发时，Promise会解析为事件消息对象
+     * - 如果设置了timeout且超时，Promise会被拒绝
+     * - 一旦事件发生或超时，会自动取消事件监听
      *
-     * @param type
-     * @param timeout  超时时间，单位毫秒，默认为 0，表示无限等待
+     * @example
+     * ```ts
+     * try {
+     *   // 等待登录事件，最多等待5秒
+     *   const event = await emitter.waitFor('user/login', 5000);
+     *   console.log('用户登录成功:', event.payload);
+     * } catch (error) {
+     *   console.error('等待登录超时');
+     * }
+     *
+     * // 无限等待事件
+     * const event = await emitter.waitFor('server/ready');
+     * console.log('服务器就绪');
+     * ```
      */
-    waitFor<R = any>(type: string, timeout?: number): Promise<R>;
-    waitFor<R = any>(type: Types, timeout?: number): Promise<R>;
+    waitFor<T extends Types, P = Events[T], M = Meta>(type: T, timeout?: number): Promise<FastEventMessage<T, P, M>>;
+    waitFor<T extends string, P = Events[T], M = Meta>(type: string, timeout?: number): Promise<FastEventMessage<T, P, M>>;
     /**
-     * 创建事件域
+     * 创建一个新的事件作用域
+     * @param prefix - 作用域前缀，将自动添加到该作用域下所有事件名称前
+     * @returns 新的FastEventScope实例
      *
-     * 注意：
+     * @description
+     * 创建一个新的事件作用域，用于在特定命名空间下管理事件。
      *
-     *  事件域与当前事件对象共享相同的侦听器表
-     *  也就是说，如果在事件域中触发事件，当前事件对象也会触发该事件
-     *  两者工不是完全隔离的,仅是事件侦听和触发时的事件类型不同而已
+     * 重要特性：
+     * - 作用域与父事件发射器共享同一个监听器表
+     * - 作用域中的事件会自动添加前缀
+     * - 作用域的所有操作都会映射到父事件发射器上
+     * - 作用域不是完全隔离的，只是提供了事件名称的命名空间
      *
-     * const emitter = new FastEvent()
+     * @example
+     * ```ts
+     * const emitter = new FastEvent();
      *
-     * const scope= emitter.scope("a/b")
+     * // 创建用户相关事件的作用域
+     * const userEvents = emitter.scope('user');
      *
-     * scope.on("x",()=>{})   == emitter.on("a/b/x",()=>{})
-     * scope.emit("x",1)      == emitter.emit("a/b/x",1)
-     * scope.offAll()         == emitter.offAll("a/b")
+     * // 在作用域中监听事件
+     * userEvents.on('login', (data) => {
+     *   // 实际监听的是 'user/login'
+     *   console.log('用户登录:', data);
+     * });
+     *
+     * // 在作用域中触发事件
+     * userEvents.emit('login', { userId: 123 });
+     * // 等同于 emitter.emit('user/login', { userId: 123 })
      *
+     * // 创建嵌套作用域
+     * const profileEvents = userEvents.scope('profile');
+     * profileEvents.emit('update', { name: 'John' });
+     * // 等同于 emitter.emit('user/profile/update', { name: 'John' })
+     *
+     * // 清理作用域
+     * userEvents.offAll();  // 清理 'user' 前缀下的所有事件
+     * ```
      */
-    scope<T extends string>(prefix: T): FastEventScope<ScopeEvents<Events, T>, Record<string, any>, keyof ScopeEvents<Events, T>>;
+    scope<T extends string>(prefix: T): FastEventScope<ScopeEvents<Events, T>, Record<string, any>, any, keyof ScopeEvents<Events, T>>;
 }
 
 export { FastEvent, type FastEventListenOptions, type FastEventListener, type FastEventListenerMeta, type FastEventMessage, type FastEventOptions, FastEventScope, type FastEventSubscriber, type FastEvents, type FastListenerNode, type FastListeners, type ScopeEvents };

package/dist/index.js

@@ -1,2 +1,2 @@
-'use strict';var g=Object.defineProperty;var L=(h,e,t)=>e in h?g(h,e,{enumerable:true,configurable:true,writable:true,value:t}):h[e]=t;var u=(h,e)=>g(h,"name",{value:e,configurable:true});var c=(h,e,t)=>L(h,typeof e!="symbol"?e+"":e,t);var a=class a{constructor(e,t){c(this,"emitter");c(this,"prefix");this.emitter=e,this.prefix=t,t.length>0&&!t.endsWith(e.options.delimiter)&&(this.prefix=t+e.options.delimiter);}_getScopeListener(e){let t=this.prefix;if(t.length===0)return e;let s=u(function(i){if(i.type.startsWith(t))return e(Object.assign({},i,{type:i.type.substring(t.length)}))},"scopeListener");return e.__wrappedListener=s,e}_getScopeType(e){return e===void 0?void 0:this.prefix+e}on(){let e=[...arguments];return e[0]=this._getScopeType(e[0]),e[1]=this._getScopeListener(e[1]),this.emitter.on(...e)}once(){return this.on(arguments[0],arguments[1],Object.assign({},arguments[2],{count:1}))}onAny(e,t){let s=this.prefix+"**";return this.on(s,e,t)}offAll(){this.emitter.offAll(this.prefix);}off(){let e=arguments;typeof e[0]=="string"&&(e[0]=this._getScopeType(e[0])),this.emitter.off(...e);}clear(){this.offAll();}emit(){let e=arguments[0],t=arguments[1],s=arguments[2];return this.emitter.emit(this._getScopeType(e),t,s)}waitFor(){let e=arguments[0],t=arguments[1];return this.emitter.waitFor(this._getScopeType(e),t)}scope(e){return this.emitter.scope(this._getScopeType(e))}};u(a,"FastEventScope");var f=a;function d(h,e){if(h.length!==e.length&&h.length>0&&e[e.length-1]!=="**")return  false;let t=[...e];e.length>0&&e[e.length-1]==="**"&&t.splice(e.length-1,1,...Array.from({length:h.length-e.length+1}).fill("*"));for(let s=0;s<h.length;s++)if(t[s]!=="*"&&t[s]!==h[s])return  false;return  true}u(d,"isPathMatched");function y(h,e){let t=[];for(;;){let s=h.findIndex(i=>e(i));if(s===-1){t.push(s);break}h.splice(s,1);}return t}u(y,"removeItem");var _=class _{constructor(e){c(this,"listeners",{__listeners:[]});c(this,"_options");c(this,"_delimiter","/");c(this,"_context");c(this,"_retainedEvents",new Map);this._options=Object.assign({delimiter:"/",context:null,ignoreErrors:true},e),this._delimiter=this._options.delimiter,this._context=this._options.context||this;}get options(){return this._options}_addListener(e,t,s){let{count:i,prepend:r}=s;return this._forEachNodes(e,n=>{let o=i>0?[t,i]:t;r?n.__listeners.splice(0,0,o):n.__listeners.push(o),typeof this._options.onAddListener=="function"&&this._options.onAddListener(e,t);})}_forEachNodes(e,t){if(e.length===0)return;let s=this.listeners;for(let i=0;i<e.length;i++){let r=e[i];if(r in s||(s[r]={__listeners:[]}),i===e.length-1){let n=s[r];return t(n,s),n}else s=s[r];}}_removeListener(e,t,s){s&&y(e.__listeners,i=>{i=Array.isArray(i)?i[0]:i;let r=i===s;return r&&typeof this._options.onRemoveListener=="function"&&this._options.onRemoveListener(t,s),r});}on(){let e=arguments[0],t=arguments[1],s=Object.assign({count:0,prepend:false},arguments[2]);if(e.length===0)throw new Error("event type cannot be empty");if(e==="**")return this.onAny(t);let i=e.split(this._delimiter),r=this._addListener(i,t,s);return r&&!e.includes("*")&&this._emitForLastEvent(e),{off:u(()=>r&&this._removeListener(r,i,t),"off")}}once(){return this.on(arguments[0],arguments[1],{count:1})}onAny(e,t){let s=this.listeners.__listeners;return t&&t.prepend?s.splice(0,0,e):s.push(e),{off:u(()=>this._removeListener(this.listeners,[],e),"off")}}off(){let e=arguments,t=typeof e[0]=="function"?void 0:e[0],s=typeof e[0]=="function"?e[0]:e[1],i=t?t.split(this._delimiter):[],r=t?t.includes("*"):false;if(t&&!r)this._traverseToPath(this.listeners,i,n=>{s?this._removeListener(n,i,s):t&&(n.__listeners=[]);});else {let n=r?[]:i;this._traverseListeners(this.listeners,n,(o,l)=>{(s!==void 0||r&&d(o,i))&&(s?this._removeListener(l,i,s):l.__listeners=[]);});}}offAll(e){if(e){let t=this._getListenerNode(e.split(this._delimiter));t&&(t.__listeners=[]),this._removeRetainedEvents(e);}else this._retainedEvents.clear(),this.listeners={__listeners:[]};}_getListenerNode(e){let t;return this._forEachNodes(e,s=>{t=s;}),t}_removeRetainedEvents(e){e||this._retainedEvents.clear(),e?.endsWith(this._delimiter)&&(e+=this._delimiter),this._retainedEvents.delete(e);for(let t of this._retainedEvents.keys())t.startsWith(e)&&this._retainedEvents.delete(t);}clear(){this.offAll();}_createMeta(e){return this._options.meta?Object.assign({},this._options.meta,e):e}_emitForLastEvent(e){if(this._retainedEvents.has(e)){let t=this._retainedEvents.get(e),s=e.split(this._delimiter);this._traverseToPath(this.listeners,s,i=>{this._executeListeners(i,t);}),this._executeListeners(this.listeners,t);}}_traverseToPath(e,t,s,i=0,r){if(i>=t.length){s(e);return}let n=t[i];if(r===true){this._traverseToPath(e,t,s,i+1,true);return}"*"in e&&this._traverseToPath(e["*"],t,s,i+1),"**"in e&&this._traverseToPath(e["**"],t,s,i+1,true),n in e&&this._traverseToPath(e[n],t,s,i+1);}_traverseListeners(e,t,s){let i=e;t&&t.length>0&&this._traverseToPath(e,t,n=>{i=n;});let r=u((n,o,l)=>{o(l,n);for(let[m,p]of Object.entries(n))m.startsWith("__")||p&&r(p,o,[...l,m]);},"traverseNodes");r(i,s,[]);}_executeListener(e,t){try{return typeof e.__wrappedListener=="function"?e.__wrappedListener.call(this._context,t):e.call(this._context,t)}catch(s){if(s._emitter=t.type,typeof this._options.onListenerError=="function"&&this._options.onListenerError.call(this,t.type,s),this._options.ignoreErrors)return s;throw s}}_executeListeners(e,t){if(!e||!e.__listeners)return [];let s=0,i=e.__listeners,r=[];for(;s<i.length;){let n=i[s];Array.isArray(n)?(r.push(this._executeListener(n[0],t)),n[1]--,n[1]===0&&(i.splice(s,1),s--)):r.push(this._executeListener(n,t)),s++;}return r}emit(){let e,t,s,i;typeof arguments[0]=="object"?(e=arguments[0].type,t=arguments[0].payload,i=this._createMeta(arguments[0].meta),s=arguments[1]):(e=arguments[0],t=arguments[1],s=arguments[2],i=this._createMeta(arguments[3]));let r={type:e,payload:t,meta:i},n=e.split(this._delimiter);s&&this._retainedEvents.set(e,r);let o=[];return o.push(...this._executeListeners(this.listeners,r)),this._traverseToPath(this.listeners,n,l=>{o.push(...this._executeListeners(l,r));}),o}async emitAsync(){let e=arguments[0],t=arguments[1],s=arguments[2],i=this._createMeta(arguments[3]),r={type:e,payload:t,meta:i};return (await Promise.allSettled(this.emit(r,s))).map(o=>o.status==="fulfilled"?o.value:o.reason)}waitFor(){let e=arguments[0],t=arguments[1];return new Promise((s,i)=>{let r,n,o=u(l=>{clearTimeout(r),n.off(),s(l);},"listener");t&&t>0&&(r=setTimeout(()=>{n&&n.off(),i(new Error("wait for event<"+e+"> is timeout"));},t)),n=this.on(e,o);})}scope(e){return new f(this,e)}};u(_,"FastEvent");var v=_;exports.FastEvent=v;exports.FastEventScope=f;//# sourceMappingURL=index.js.map
+'use strict';var m=Object.defineProperty;var v=(h,e,t)=>e in h?m(h,e,{enumerable:true,configurable:true,writable:true,value:t}):h[e]=t;var l=(h,e)=>m(h,"name",{value:e,configurable:true});var u=(h,e,t)=>v(h,typeof e!="symbol"?e+"":e,t);var f=class f{constructor(e,t){u(this,"emitter");u(this,"prefix");this.emitter=e,this.prefix=t,t.length>0&&!t.endsWith(e.options.delimiter)&&(this.prefix=t+e.options.delimiter);}_getScopeListener(e){let t=this.prefix;if(t.length===0)return e;let s=l(function(i){if(i.type.startsWith(t))return e(Object.assign({},i,{type:i.type.substring(t.length)}))},"scopeListener");return e.__wrappedListener=s,e}_getScopeType(e){return e===void 0?void 0:this.prefix+e}_fixScopeType(e){return e.startsWith(this.prefix)?e.substring(this.prefix.length):e}on(){let e=[...arguments];return e[0]=this._getScopeType(e[0]),e[1]=this._getScopeListener(e[1]),this.emitter.on(...e)}once(){return this.on(arguments[0],arguments[1],Object.assign({},arguments[2],{count:1}))}onAny(e,t){let s=this.prefix+"**";return this.on(s,e,t)}offAll(){this.emitter.offAll(this.prefix);}off(){let e=arguments;typeof e[0]=="string"&&(e[0]=this._getScopeType(e[0])),this.emitter.off(...e);}clear(){this.offAll();}emit(){let e=arguments[0],t=arguments[1],s=arguments[2];return this.emitter.emit(this._getScopeType(e),t,s)}async waitFor(){let e=arguments[0],t=arguments[1],s=await this.emitter.waitFor(this._getScopeType(e),t);return Object.assign({},s,{type:this._fixScopeType(s.type)})}scope(e){return this.emitter.scope(this._getScopeType(e))}};l(f,"FastEventScope");var c=f;function d(h,e){if(h.length!==e.length&&h.length>0&&e[e.length-1]!=="**")return  false;let t=[...e];e.length>0&&e[e.length-1]==="**"&&t.splice(e.length-1,1,...Array.from({length:h.length-e.length+1}).fill("*"));for(let s=0;s<h.length;s++)if(t[s]!=="*"&&t[s]!==h[s])return  false;return  true}l(d,"isPathMatched");function y(h,e){let t=[];for(;;){let s=h.findIndex(i=>e(i));if(s===-1){t.push(s);break}h.splice(s,1);}return t}l(y,"removeItem");var _=class _{constructor(e){u(this,"listeners",{__listeners:[]});u(this,"_options");u(this,"_delimiter","/");u(this,"_context");u(this,"retainedMessages",new Map);u(this,"listenerCount",0);this._options=Object.assign({debug:false,id:Math.random().toString(36).substring(2),delimiter:"/",context:null,ignoreErrors:true},e),this._delimiter=this._options.delimiter,this._context=this._options.context||this,this._enableDevTools();}get options(){return this._options}get id(){return this._options.id}_addListener(e,t,s){let{count:i,prepend:r}=s;return this._forEachNodes(e,n=>{let o=i>0?[t,i]:t;r?n.__listeners.splice(0,0,o):n.__listeners.push(o),typeof this._options.onAddListener=="function"&&(this.listenerCount++,this._options.onAddListener(e,t));})}_enableDevTools(){this.options.debug&&globalThis.__FLEXEVENT_DEVTOOLS__.add(this);}_forEachNodes(e,t){if(e.length===0)return;let s=this.listeners;for(let i=0;i<e.length;i++){let r=e[i];if(r in s||(s[r]={__listeners:[]}),i===e.length-1){let n=s[r];return t(n,s),n}else s=s[r];}}_removeListener(e,t,s){s&&y(e.__listeners,i=>{i=Array.isArray(i)?i[0]:i;let r=i===s;return r&&typeof this._options.onRemoveListener=="function"&&(this.listenerCount--,this._options.onRemoveListener(t,s)),r});}on(){let e=arguments[0],t=arguments[1],s=Object.assign({count:0,prepend:false},arguments[2]);if(e.length===0)throw new Error("event type cannot be empty");if(e==="**")return this.onAny(t);let i=e.split(this._delimiter),r=this._addListener(i,t,s);return r&&!e.includes("*")&&this._emitForLastEvent(e),{off:l(()=>r&&this._removeListener(r,i,t),"off")}}once(){return this.on(arguments[0],arguments[1],{count:1})}onAny(e,t){let s=this.listeners.__listeners;return t&&t.prepend?s.splice(0,0,e):s.push(e),{off:l(()=>this._removeListener(this.listeners,[],e),"off")}}off(){let e=arguments,t=typeof e[0]=="function"?void 0:e[0],s=typeof e[0]=="function"?e[0]:e[1],i=t?t.split(this._delimiter):[],r=t?t.includes("*"):false;if(t&&!r)this._traverseToPath(this.listeners,i,n=>{s?this._removeListener(n,i,s):t&&(n.__listeners=[]);});else {let n=r?[]:i;this._traverseListeners(this.listeners,n,(o,a)=>{(s!==void 0||r&&d(o,i))&&(s?this._removeListener(a,i,s):a.__listeners=[]);});}}offAll(e){if(e){let t=this._getListenerNode(e.split(this._delimiter));t&&(t.__listeners=[]),this._removeRetainedEvents(e);}else this.retainedMessages.clear(),this.listeners={__listeners:[]};typeof this._options.onClearListeners=="function"&&this._options.onClearListeners.call(this);}_getListenerNode(e){let t;return this._forEachNodes(e,s=>{t=s;}),t}_removeRetainedEvents(e){e||this.retainedMessages.clear(),e?.endsWith(this._delimiter)&&(e+=this._delimiter),this.retainedMessages.delete(e);for(let t of this.retainedMessages.keys())t.startsWith(e)&&this.retainedMessages.delete(t);}clear(){this.offAll();}_createMeta(e){return this._options.meta?Object.assign({},this._options.meta,e):e}_emitForLastEvent(e){if(this.retainedMessages.has(e)){let t=this.retainedMessages.get(e),s=e.split(this._delimiter);this._traverseToPath(this.listeners,s,i=>{this._executeListeners(i,t);}),this._executeListeners(this.listeners,t);}}_traverseToPath(e,t,s,i=0,r){if(i>=t.length){s(e);return}let n=t[i];if(r===true){this._traverseToPath(e,t,s,i+1,true);return}"*"in e&&this._traverseToPath(e["*"],t,s,i+1),"**"in e&&this._traverseToPath(e["**"],t,s,i+1,true),n in e&&this._traverseToPath(e[n],t,s,i+1);}_traverseListeners(e,t,s){let i=e;t&&t.length>0&&this._traverseToPath(e,t,n=>{i=n;});let r=l((n,o,a)=>{o(a,n);for(let[p,g]of Object.entries(n))p.startsWith("__")||g&&r(g,o,[...a,p]);},"traverseNodes");r(i,s,[]);}_executeListener(e,t){try{return typeof e.__wrappedListener=="function"?e.__wrappedListener.call(this._context,t):e.call(this._context,t)}catch(s){if(s._emitter=t.type,typeof this._options.onListenerError=="function"&&this._options.onListenerError.call(this,t.type,s),this._options.ignoreErrors)return s;throw s}}_executeListeners(e,t){if(!e||!e.__listeners)return [];let s=0,i=e.__listeners,r=[];for(;s<i.length;){let n=i[s];Array.isArray(n)?(r.push(this._executeListener(n[0],t)),n[1]--,n[1]===0&&(i.splice(s,1),s--)):r.push(this._executeListener(n,t)),s++;}return r}emit(){let e,t,s,i;typeof arguments[0]=="object"?(e=arguments[0].type,t=arguments[0].payload,i=this._createMeta(arguments[0].meta),s=arguments[1]):(e=arguments[0],t=arguments[1],s=arguments[2],i=this._createMeta(arguments[3]));let r={type:e,payload:t,meta:i},n=e.split(this._delimiter);s&&this.retainedMessages.set(e,r);let o=[];return o.push(...this._executeListeners(this.listeners,r)),this._traverseToPath(this.listeners,n,a=>{o.push(...this._executeListeners(a,r)),this._options.debug&&typeof this._options.onExecuteListener=="function"&&(s&&(r.meta||(r.meta={retain:true})),this._options.onExecuteListener.call(this,r,o,[...this.listeners.__listeners,...a.__listeners]));}),o}async emitAsync(){let e=arguments[0],t=arguments[1],s=arguments[2],i=this._createMeta(arguments[3]),r={type:e,payload:t,meta:i};return (await Promise.allSettled(this.emit(r,s))).map(o=>o.status==="fulfilled"?o.value:o.reason)}waitFor(){let e=arguments[0],t=arguments[1];return new Promise((s,i)=>{let r,n,o=l(a=>{clearTimeout(r),n.off(),s(a);},"listener");t&&t>0&&(r=setTimeout(()=>{n&&n.off(),i(new Error("wait for event<"+e+"> is timeout"));},t)),n=this.on(e,o);})}scope(e){return new c(this,e)}};l(_,"FastEvent");var L=_;exports.FastEvent=L;exports.FastEventScope=c;//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map