fastevent 2.0.2 → 2.1.0

package/dist/index.d.ts

@@ -3,7 +3,6 @@ type FastListenerPipe = (listener: FastEventListener) => FastEventListener;
 interface FaseEventMessageExtends {
 }
 interface FastEventMeta {
-    priority?: number;
 }
 type FastEventMessage<Events extends Record<string, any> = Record<string, any>, M = any> = ({
     [K in keyof Events]: {
@@ -16,7 +15,7 @@ type FastEventEmitMessage<Events extends Record<string, any> = Record<string, an
     [K in keyof Events]: {
         type: Exclude<K, number | symbol>;
         payload?: Events[K];
-        meta?: FastEventMeta & M & Record<string, any>;
+        meta?: Partial<FastEventMeta> & M & Record<string, any>;
     };
 }[Exclude<keyof Events, number | symbol>]) & FaseEventMessageExtends;
 type FastEventListener<T extends string = string, P = any, M = any, C = any> = (this: C, message: FastEventMessage<{
@@ -35,7 +34,7 @@ type FastListenerNode = {
 type FastEventSubscriber = {
     off: () => void;
     /**
-     * 为什么要有一个listener引用? 主要用于移除侦听器时使用
+     * 为什么要有一个listener引用? 主要用于移除监听器时使用
      *
      *  - 正常情况下
      *  const subscriber = emitter.on('event', listener)
@@ -51,11 +50,11 @@ type FastEventSubscriber = {
      *  subscriber.off()        可以正常生效
      *  scope.off('event', listener)    // 无法生效
      *  scope.off(listener) // 无法生效
-     *  因为在scope中，为了让侦听器可以处理scope的逻辑，对listener进行了包装，
-     *  因此在事件注册表中登记的不是listener，而是经过包装的侦听器
+     *  因为在scope中，为了让监听器可以处理scope的逻辑，对listener进行了包装，
+     *  因此在事件注册表中登记的不是listener，而是经过包装的监听器
      *  subscriber.off()        可以正常生效
      *  如果要使用scope.off或emitter.off
-     *  需要使用subscriber.listener， subscriber.listener记录了原始的侦听器引用
+     *  需要使用subscriber.listener， subscriber.listener记录了原始的监听器引用
      *   subscriber.listener===listener
      *
      *  scope.off('event', subscriber.listener)    // 生效
@@ -66,26 +65,24 @@ type FastEventSubscriber = {
 };
 type FastListeners = FastListenerNode;
 type FastEventOptions<Meta = Record<string, any>, Context = any> = {
-    id?: string;
-    debug?: boolean;
-    delimiter?: string;
-    context?: Context;
-    ignoreErrors?: boolean;
-    meta?: Meta;
-    onAddListener?: (type: string[], listener: FastEventListener) => void;
-    onRemoveListener?: (type: string[], listener: FastEventListener) => void;
+    id: string;
+    debug: boolean;
+    delimiter: string;
+    context: Context;
+    ignoreErrors: boolean;
+    meta: Meta;
+    onAddListener?: (type: string, listener: FastEventListener, options: FastEventListenOptions<Record<string, any>, Meta>) => boolean | FastEventSubscriber | void;
+    onRemoveListener?: (type: string, listener: FastEventListener) => void;
     onClearListeners?: () => void;
-    onListenerError?: ((listener: FastEventListener, error: Error, message: FastEventMessage<any, Meta>, args: FastEventListenerArgs<Meta> | undefined) => void);
-    onBeforeExecuteListener?: (message: FastEventMessage<any, Meta>, args: FastEventListenerArgs<Meta>) => boolean | void;
+    onListenerError?: ((error: Error, listener: FastEventListener, message: FastEventMessage<any, Meta>, args: FastEventListenerArgs<Meta> | undefined) => void);
+    onBeforeExecuteListener?: (message: FastEventMessage<any, Meta>, args: FastEventListenerArgs<Meta>) => boolean | void | any[];
     onAfterExecuteListener?: (message: FastEventMessage<any, Meta>, returns: any[], listeners: FastListenerNode[]) => void;
     /**
      * 全局执行器
-     * allSettled: 使用Promise.allSettled()执行所有监听器
-     * race: 使用Promise.race()执行所有监听器，只有第一个执行完成就返回,其他监听器执行结果会被忽略
-     * balance: 尽可能平均执行各个侦听器
-     * sequence: 按照侦听器添加顺序依次执行
      */
-    executor?: FastListenerExecutorArgs;
+    executor?: FastListenerExecutor;
+    onMessage?: FastEventListener;
+    expandEmitResults?: boolean;
 };
 interface FastEvents {
 }
@@ -100,7 +97,6 @@ type FastEventListenOptions<Events extends Record<string, any> = Record<string,
     off?: (message: FastEventMessage<Events, Meta>, args: FastEventListenerArgs<Meta>) => boolean;
     pipes?: FastListenerPipe[];
 };
-type FastListenerExecutorArgs = 'default' | 'allSettled' | 'race' | 'balance' | 'first' | 'last' | 'random' | IFastListenerExecutor;
 type FastEventListenerArgs<M = Record<string, any>> = {
     retain?: boolean;
     meta?: Partial<M> & Record<string, any>;
@@ -109,10 +105,14 @@ type FastEventListenerArgs<M = Record<string, any>> = {
      *
      * allSettled: 使用Promise.allSettled()执行所有监听器
      * race: 使用Promise.race()执行所有监听器，只有第一个执行完成就返回,其他监听器执行结果会被忽略
-     * balance: 尽可能平均执行各个侦听器
-     * sequence: 按照侦听器添加顺序依次执行
+     * balance: 尽可能平均执行各个监听器
+     * sequence: 按照监听器添加顺序依次执行
+     */
+    executor?: FastListenerExecutor;
+    /**
+     * 当emit参数解析完成后的回调，用于修改emit参数
      */
-    executor?: FastListenerExecutorArgs;
+    parseArgs?: (message: FastEventMessage, args: FastEventListenerArgs) => void;
 };
 type Merge<T extends object, U extends object> = {
     [K in keyof T | keyof U]: K extends keyof U ? U[K] : K extends keyof T ? T[K] : never;
@@ -120,26 +120,155 @@ type Merge<T extends object, U extends object> = {
 type RequiredItems<T extends object, Items extends string[]> = Omit<T, Items[number]> & {
     [K in Items[number] & keyof T]-?: Exclude<T[K], undefined>;
 };
+type Expand<T> = T extends infer O ? {
+    [K in keyof O]: O[K];
+} : never;
+type OptionalItems<T, K extends keyof T> = Expand<Omit<T, K> & {
+    [P in K]?: T[P];
+}>;
+type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
 type Fallback<T, F> = [
     T
 ] extends [never] ? F : T extends undefined ? F : T;
-type IFastListenerExecutor = (listeners: FastListenerMeta[], message: FastEventMessage, args: FastEventListenerArgs | undefined, execute: (listener: FastEventListener, message: FastEventMessage, args?: FastEventListenerArgs) => Promise<any> | any) => Promise<any[]> | any[];
+type ChangeFieldType<Record, Name extends string, Type = any> = Expand<Omit<Record, Name> & {
+    [K in Name]: Type;
+}>;
+type OverrideOptions<T> = ChangeFieldType<Required<T>, 'context', never>;
+type ObjectKeys<T, I = string> = {
+    [P in keyof T]: P extends I ? P : never;
+}[keyof T];
+/**
+ * 从类型数组中移除重复项，返回保留唯一类型的元组
+ * @template T - 输入的任意类型数组（元组）
+ * @template Result - 内部使用的累积结果数组（默认空数组）
+ * @returns {any[]} 去重后的类型元组，保留首次出现的顺序
+ *
+ * @example
+ * type T1 = Unique<[number, string, number]>;  // [number, string]
+ * type T2 = Unique<[1, 2, 2, 3]>;              // [1, 2, 3]
+ * type T3 = Unique<['a', 'b', 'a']>;           // ['a', 'b']
+ */
+type Unique<T extends any[], Result extends any[] = []> = T extends [infer First, ...infer Rest] ? First extends Result[number] ? Unique<Rest, Result> : Unique<Rest, [...Result, First]> : Result;
+type Overloads<T> = Unique<T extends {
+    (...args: infer A1): infer R1;
+    (...args: infer A2): infer R2;
+    (...args: infer A3): infer R3;
+    (...args: infer A4): infer R4;
+    (...args: infer A5): infer R5;
+    (...args: infer A6): infer R6;
+    (...args: infer A7): infer R7;
+    (...args: infer A8): infer R8;
+} ? [
+    (...args: A1) => R1,
+    ((...args: A2) => R2),
+    ((...args: A3) => R3),
+    ((...args: A4) => R4),
+    ((...args: A5) => R5),
+    ((...args: A6) => R6),
+    ((...args: A7) => R7),
+    ((...args: A8) => R8)
+] : T extends {
+    (...args: infer A1): infer R1;
+    (...args: infer A2): infer R2;
+    (...args: infer A3): infer R3;
+    (...args: infer A4): infer R4;
+    (...args: infer A5): infer R5;
+    (...args: infer A6): infer R6;
+    (...args: infer A7): infer R7;
+} ? [
+    (...args: A1) => R1,
+    ((...args: A2) => R2),
+    ((...args: A3) => R3),
+    ((...args: A4) => R4),
+    ((...args: A5) => R5),
+    ((...args: A6) => R6),
+    ((...args: A7) => R7)
+] : T extends {
+    (...args: infer A1): infer R1;
+    (...args: infer A2): infer R2;
+    (...args: infer A3): infer R3;
+    (...args: infer A4): infer R4;
+    (...args: infer A5): infer R5;
+    (...args: infer A6): infer R6;
+} ? [
+    (...args: A1) => R1,
+    ((...args: A2) => R2),
+    ((...args: A3) => R3),
+    ((...args: A4) => R4),
+    ((...args: A5) => R5),
+    ((...args: A6) => R6)
+] : T extends {
+    (...args: infer A1): infer R1;
+    (...args: infer A2): infer R2;
+    (...args: infer A3): infer R3;
+    (...args: infer A4): infer R4;
+    (...args: infer A5): infer R5;
+} ? [
+    (...args: A1) => R1,
+    ((...args: A2) => R2),
+    ((...args: A3) => R3),
+    ((...args: A4) => R4),
+    ((...args: A5) => R5)
+] : T extends {
+    (...args: infer A1): infer R1;
+    (...args: infer A2): infer R2;
+    (...args: infer A3): infer R3;
+    (...args: infer A4): infer R4;
+} ? [
+    (...args: A1) => R1,
+    ((...args: A2) => R2),
+    ((...args: A3) => R3),
+    ((...args: A4) => R4)
+] : T extends {
+    (...args: infer A1): infer R1;
+    (...args: infer A2): infer R2;
+    (...args: infer A3): infer R3;
+} ? [
+    ((...args: A1) => R1),
+    ((...args: A2) => R2),
+    ((...args: A3) => R3)
+] : T extends {
+    (...args: infer A1): infer R1;
+    (...args: infer A2): infer R2;
+} ? [
+    ((...args: A1) => R1),
+    ((...args: A2) => R2)
+] : T extends {
+    (...args: infer A1): infer R1;
+} ? [
+    (...args: A1) => R1
+] : [
+    T
+]>;
+type Dict<V = any> = Record<Exclude<string, number | symbol>, V>;
+
+type FastListenerExecutor = (listeners: FastListenerMeta[], message: FastEventMessage, args: FastEventListenerArgs, execute: (listener: FastEventListener, message: FastEventMessage, args: FastEventListenerArgs, catchErrors?: boolean) => Promise<any> | any) => Promise<any[]> | any[];
 
-type FastEventScopeOptions<Meta, Context> = {
-    meta?: FastEventMeta & Meta;
-    context?: Context;
-    executor?: FastListenerExecutorArgs;
+type FastEventScopeOptions<Meta = Record<string, any>, Context = any> = {
+    meta: FastEventScopeMeta & FastEventMeta & Meta;
+    context: Context;
+    executor?: FastListenerExecutor;
+    onMessage?: FastEventListener;
 };
 type FastEventScopeMeta = {
     scope: string;
 };
-declare class FastEventScope<Events extends Record<string, any> = Record<string, any>, Meta extends Record<string, any> = Record<string, any>, Context = any, Types extends keyof Events = keyof Events, FinalMeta extends Record<string, any> = Meta & FastEventScopeMeta> {
-    emitter: FastEvent<Events>;
+declare class FastEventScope<Events extends Record<string, any> = Record<string, any>, Meta extends Record<string, any> = Record<string, any>, Context = never, Types extends keyof Events = keyof Events, FinalMeta extends Record<string, any> = FastEventMeta & FastEventScopeMeta & Meta> {
+    __FastEventScope__: boolean;
+    private _options;
+    types: {
+        events: Events;
+        meta: FinalMeta;
+        context: Fallback<Context, typeof this>;
+    };
     prefix: string;
-    options: Required<FastEventScopeOptions<FinalMeta, Context>>;
-    events: Events;
-    constructor(emitter: FastEvent<Events>, prefix: string, options?: FastEventScopeOptions<Meta, Context>);
-    get context(): Context;
+    emitter: FastEvent<Events>;
+    constructor(options?: DeepPartial<FastEventScopeOptions<FinalMeta, Context>>);
+    get context(): Fallback<Context, typeof this>;
+    get options(): FastEventScopeOptions<FinalMeta, Context>;
+    bind(emitter: FastEvent<any>, prefix: string, options?: DeepPartial<FastEventScopeOptions<FinalMeta, Context>>): void;
     /**
      * 获取作用域监听器
      * 当启用作用域时,对原始监听器进行包装,添加作用域前缀处理逻辑
@@ -150,14 +279,20 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
     private _getScopeListener;
     private _getScopeType;
     private _fixScopeType;
-    on<T extends Types = Types>(type: T, listener: FastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Context>, options?: FastEventListenOptions): FastEventSubscriber;
-    on<T extends string>(type: T, listener: FastEventListener<string, any, FinalMeta, Context>, options?: FastEventListenOptions): FastEventSubscriber;
-    on(type: '**', listener: FastEventAnyListener<Events, FinalMeta, Context>, options?: FastEventListenOptions): FastEventSubscriber;
-    once<T extends Types = Types>(type: T, listener: FastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Context>, options?: FastEventListenOptions): FastEventSubscriber;
-    once<T extends string>(type: T, listener: FastEventListener<string, any, FinalMeta, Context>, options?: FastEventListenOptions): FastEventSubscriber;
+    on<T extends Types = Types>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
+    on<T extends string>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
+    on(type: '**', options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
+    on<T extends Types = Types>(type: T, listener: FastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    on<T extends string>(type: T, listener: FastEventListener<string, any, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    on(type: '**', listener: FastEventAnyListener<Events, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    once<T extends Types = Types>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
+    once<T extends string>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
+    once<T extends Types = Types>(type: T, listener: FastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    once<T extends string>(type: T, listener: FastEventListener<string, any, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    onAny(options?: Pick<FastEventListenOptions, 'prepend'>): FastEventSubscriber;
     onAny<P = any>(listener: FastEventAnyListener<{
         [K: string]: P;
-    }, FinalMeta, Context>, options?: Pick<FastEventListenOptions, 'prepend'>): FastEventSubscriber;
+    }, FinalMeta, Fallback<Context, typeof this>>, 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;
@@ -165,6 +300,8 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
     off(type: Types): void;
     offAll(): void;
     clear(): void;
+    emit(type: Types, directive: symbol): void;
+    emit(type: string, directive: symbol): void;
     emit<R = any>(type: Types, payload?: Events[Types], options?: FastEventListenerArgs<FinalMeta>): R[];
     emit<R = any, T extends string = string>(type: T, payload?: T extends Types ? Events[Types] : any, options?: FastEventListenerArgs<FinalMeta>): R[];
     emit<R = any>(message: FastEventEmitMessage<Events, FinalMeta>, options?: FastEventListenerArgs<FinalMeta>): R[];
@@ -215,7 +352,13 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
      * profileScope.emit('update', { name: 'John' });
      * ```
      */
-    scope<E extends Record<string, any> = Record<string, any>, P extends string = string, M extends Record<string, any> = Record<string, any>, C = Context>(prefix: P, options?: FastEventScopeOptions<Partial<FinalMeta> & M, C>): FastEventScope<PickScopeEvents<Events, P> & E, FinalMeta & M, C, keyof PickScopeEvents<Events, P> | keyof E, FinalMeta & M & FastEventScopeMeta>;
+    scope<E extends Record<string, any> = Record<string, any>, P extends string = string, M extends Record<string, any> = Record<string, any>, C = Context>(prefix: P, options?: DeepPartial<FastEventScopeOptions<Partial<FinalMeta> & M, C>>): FastEventScope<ScopeEvents<Events, P> & E, FinalMeta & M, C>;
+    scope<E extends Record<string, any> = Record<string, any>, P extends string = string, M extends Record<string, any> = Record<string, any>, C = Context, ScopeInstance extends FastEventScope<any, any, any> = FastEventScope<ScopeEvents<ScopeEvents<Events, P> & E, P> & E, FinalMeta & M, C>>(prefix: P, scopeObj: ScopeInstance, options?: DeepPartial<FastEventScopeOptions<Partial<FinalMeta> & M, C>>): ScopeInstance;
+    /**
+     * 当on/once/onAny未指定监听器时,此为默认监听器
+     * @param message
+     */
+    onMessage(message: FastEventMessage<Events, FinalMeta>, args: FastEventListenerArgs<FinalMeta>): void;
 }
 
 /**
@@ -225,7 +368,8 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
  * @template Meta - 事件元数据类型，默认为任意键值对对象
  * @template Types - 事件类型的键名类型，默认为Events的键名类型
  */
-declare class FastEvent<Events extends Record<string, any> = Record<string, any>, Meta extends Record<string, any> = Record<string, any>, Context = never, AllEvents extends Record<string, any> = Events & FastEvents, Types extends keyof AllEvents = Exclude<keyof (AllEvents), number | symbol>> {
+declare class FastEvent<Events extends Record<string, any> = Record<string, any>, Meta extends Record<string, any> = Record<string, any>, Context = never, AllEvents extends Record<string, any> = Events & FastEvents, Types extends keyof AllEvents = Expand<Exclude<keyof (AllEvents), number | symbol>>> {
+    __FastEvent__: boolean;
     /** 事件监听器树结构，存储所有注册的事件监听器 */
     listeners: FastListeners;
     /** 事件发射器的配置选项 */
@@ -234,11 +378,15 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
     private _delimiter;
     /** 事件监听器执行时的上下文对象 */
     private _context;
-    /** 保留的事件消息映射，用于新订阅者 */
+    /** 保留的事件消息映射，Key是事件名称，Value是保留的事件消息 */
     retainedMessages: Map<string, any>;
     /** 当前注册的监听器总数 */
     listenerCount: number;
-    events: Events;
+    types: {
+        events: AllEvents;
+        meta: Expand<FastEventMeta & Meta & Record<string, any>>;
+        context: Expand<Fallback<Context, typeof this>>;
+    };
     /**
      * 创建FastEvent实例
      * @param options - 事件发射器的配置选项
@@ -250,17 +398,28 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      * - context: null - 监听器执行上下文
      * - ignoreErrors: true - 是否忽略监听器执行错误
      */
-    constructor(options?: FastEventOptions<Meta, Context>);
+    constructor(options?: Partial<FastEventOptions<Meta, Context>>);
     /** 获取事件发射器的配置选项 */
-    get options(): RequiredItems<FastEventOptions<Meta, Context>, ["meta", "context"]>;
-    get context(): Context;
+    get options(): FastEventOptions<Meta, Context>;
+    get context(): Fallback<Context, typeof this>;
+    get meta(): Meta;
     /** 获取事件发射器的唯一标识符 */
     get id(): string;
+    /**
+     * 添加事件监听器到事件树中
+     * @param parts - 事件路径数组
+     * @param listener - 事件监听器函数
+     * @param options - 监听器配置选项
+     * @param options.count - 监听器触发次数限制
+     * @param options.prepend - 是否将监听器添加到监听器列表开头
+     * @returns [节点, 监听器索引] - 返回监听器所在节点和在节点监听器列表中的索引
+     * @private
+     */
     private _addListener;
     private _enableDevTools;
     /**
      *
-     * 根据parts路径遍历侦听器树，并在最后的节点上执行回调函数
+     * 根据parts路径遍历监听器树，并在最后的节点上执行回调函数
      *
      * @param parts
      * @param callback
@@ -354,7 +513,7 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      * 此方法供子类继承
      *
      */
-    onMessage(message: FastEventMessage): void;
+    onMessage(message: FastEventMessage<AllEvents, Meta>, args: FastEventListenerArgs<Meta>): void;
     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;
@@ -368,7 +527,7 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      * - 如果没有提供prefix,则清除所有监听器
      * - 同时会清空保留的事件(_retainedEvents)
      * - 重置监听器对象为空
- 
+     
     * @example
      *
      * ```ts
@@ -386,7 +545,19 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      */
     private _removeRetainedEvents;
     clear(prefix?: string): void;
-    private _emitForLastEvent;
+    /**
+     * 发送最后一次事件的消息给对应的监听器
+     *
+     * @param type - 事件类型,支持通配符(*)匹配
+     * @private
+     *
+     * 处理流程:
+     * 1. 如果事件类型包含通配符,则遍历所有保留的消息,匹配符合模式的事件
+     * 2. 如果是普通事件类型,则直接获取对应的保留消息
+     * 3. 遍历匹配到的消息,查找对应路径的监听器节点
+     * 4. 执行所有匹配到的监听器
+     */
+    private _emitRetainMessage;
     /**
      * 遍历监听器节点树
      * @param node 当前遍历的监听器节点
@@ -408,6 +579,8 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      * 执行单个监听器函数
      * @param listener - 要执行的监听器函数或包装过的监听器对象
      * @param message - 事件消息对象，包含type、payload和meta
+     * @param args - 监听器参数
+     * @param catchErrors - 是否捕获并处理执行过程中的错误
      * @returns 监听器的执行结果或错误对象（如果配置了ignoreErrors）
      * @private
      *
@@ -424,23 +597,18 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
     private _executeListener;
     private _getListenerExecutor;
     /**
-     * 触发事件并执行对应的监听器
-     * @param type - 事件类型字符串或包含事件信息的对象
-     * @param payload - 事件携带的数据负载
-        return
-    }
-    /**
-     * 执行监听器节点中的所有监听函数
-     * @param node - FastListenerNode类型的监听器节点
-     * @param payload - 事件携带的数据
-     * @param type - 事件类型
-     * @returns 返回所有监听函数的执行结果数组
+     * 执行监听器节点列表中的所有监听器函数
+     * @param nodes 监听器节点列表
+     * @param message 事件消息对象
+     * @param args 监听器参数
+     * @param args 监听器参数
+     * @returns 所有监听器函数的执行结果数组
      * @private
      *
-     * @description
-     * 遍历执行节点中的所有监听函数:
-     * - 对于普通监听器，直接执行并收集结果
-     * - 对于带次数限制的监听器(数组形式)，执行后递减次数，当次数为0时移除该监听器
+     * 执行流程:
+     * 1. 将所有节点中的监听器函数展平为一维数组
+     * 2. 通过执行器执行所有监听器函数
+     * 3. 更新监听器的执行次数,并移除达到执行次数限制的监听器
      */
     private _executeListeners;
     /**
@@ -495,8 +663,14 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      *   payload: { userId: 123 },
      *   meta: { time: Date.now() }
      * }, true);
+     *
+     * // 清除保留事件
+     * emitter.emit("user/login")
+     *
      * ```
      */
+    emit<T extends Types = Types>(type: T, directive: symbol): any[];
+    emit(type: string, directive: symbol): any[];
     emit<R = any, T extends Types = Types>(type: T, payload?: AllEvents[T], retain?: boolean): R[];
     emit<R = any, T extends string = string>(type: T, payload?: T extends Types ? AllEvents[Types] : any, retain?: boolean): R[];
     emit<R = any, T extends string = string>(message: FastEventEmitMessage<{
@@ -631,90 +805,27 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      * userEvents.offAll();  // 清理 'user' 前缀下的所有事件
      * ```
      */
-    scope<E extends Record<string, any> = Record<string, any>, P extends string = string, M extends Record<string, any> = Record<string, any>, C = Context>(prefix: P, options?: FastEventScopeOptions<M, C>): FastEventScope<PickScopeEvents<AllEvents, P> & E, Meta & M, C, keyof PickScopeEvents<AllEvents, P> | keyof E, Meta & M & FastEventScopeMeta>;
-}
-
-interface FastEventListenerDecorators {
-    queue: string;
-}
-type FastQueuePriority = 'none';
-type FastQueueOverflows = "drop" | "expand" | 'slide' | 'throw';
-type QueueListenerPipeOptions = {
-    size?: number;
-    maxExpandSize?: number;
-    expandOverflow?: Omit<FastQueueOverflows, 'expand'>;
-    overflow?: FastQueueOverflows;
-    lifetime?: number;
-    onEnter?: (newMessage: FastEventMessage, messages: [FastEventMessage, number][]) => void;
-    onDrop?: (message: FastEventMessage) => void;
-};
-declare const queue: (options?: QueueListenerPipeOptions) => FastListenerPipe;
-declare const dropping: (size?: number) => FastListenerPipe;
-declare const sliding: (size?: number) => FastListenerPipe;
-declare const expanding: (options?: Omit<QueueListenerPipeOptions, "overflow">) => FastListenerPipe;
-
-interface RetryListenerPipeOptions {
-    interval?: number;
-    drop?: (message: FastEventMessage, error: Error) => void;
-}
-/**
- * 创建一个重试管道，在监听器执行失败时自动重试
- * @param count 最大重试次数
- * @param options 配置选项
- * @returns FastListenerPipe
- */
-declare const retry: (count: number, options?: RetryListenerPipeOptions) => FastListenerPipe;
-
-/**
- * 创建一个超时装饰器，限制监听器函数的执行时间
- * @param ms 超时时间（毫秒）
- * @param defaultValue 可选的默认返回值，如果提供则超时时返回此值，否则抛出TimeoutError
- * @returns 装饰器函数
- */
-declare const timeout: <T = any>(ms: number, defaultValue?: T) => FastListenerPipe;
-
-interface DebounceOptions {
-    /**
-     * 当消息被丢弃时的回调函数
-     */
-    drop?: (message: FastEventMessage) => void;
+    scope<E extends Record<string, any> = Record<string, any>, P extends string = string, M extends Record<string, any> = Record<string, any>, C = Context>(prefix: P, options?: DeepPartial<FastEventScopeOptions<Meta & M, C>>): FastEventScope<ScopeEvents<AllEvents, P> & E, Meta & M, C>;
+    scope<E extends Record<string, any> = Record<string, any>, P extends string = string, M extends Record<string, any> = Record<string, any>, C = Context, ScopeObject extends FastEventScope<any, any, any> = FastEventScope<ScopeEvents<AllEvents, P> & E, Meta & M, C>>(prefix: P, scopeObj: ScopeObject, options?: DeepPartial<FastEventScopeOptions<Meta & M, C>>): ScopeObject;
 }
-/**
- * 创建一个防抖动装饰器，限制监听器函数的执行频率
- * @param ms 防抖动时间（毫秒）
- * @param options 可选的配置项
- * @returns 装饰器函数
- */
-declare const debounce: (ms: number, options?: DebounceOptions) => FastListenerPipe;
-
-interface ThrottleOptions {
-    /**
-     * 当消息被丢弃时的回调函数
-     */
-    drop?: (message: FastEventMessage) => void;
-}
-/**
- * 创建一个节流装饰器，限制监听器函数的执行频率
- * @param interval 节流时间间隔（毫秒）
- * @param options 可选的配置项
- * @returns 装饰器函数
- */
-declare const throttle: (interval: number, options?: ThrottleOptions) => FastListenerPipe;
-
-/**
- * 创建一个memorize pipe，用于缓存上一次的返回值
- * @param predicate 可选的判断函数，用于决定是否使用缓存
- * @returns FastListenerPipe
- */
-declare function memorize(predicate?: (message: FastEventMessage, args: FastEventListenerArgs) => boolean | Promise<boolean>): FastListenerPipe;
 
+declare const __FastEvent__: unique symbol;
+declare const __FastEventScope__: unique symbol;
 declare class FastEventError extends Error {
+    constructor(message?: string);
 }
 declare class TimeoutError extends FastEventError {
 }
+declare class UnboundError extends FastEventError {
+}
 declare class AbortError extends FastEventError {
 }
+declare class CancelError extends FastEventError {
+}
 declare class QueueOverflowError extends FastEventError {
 }
+declare const FastEventDirectives: {
+    clearRetain: symbol;
+};
 
-export { AbortError, type DebounceOptions, type Fallback, type FaseEventMessageExtends, FastEvent, type FastEventAnyListener, type FastEventEmitMessage, FastEventError, type FastEventListenOptions, type FastEventListener, type FastEventListenerArgs, type FastEventListenerDecorators, type FastEventMessage, type FastEventMeta, type FastEventOptions, FastEventScope, type FastEventScopeMeta, type FastEventScopeOptions, type FastEventSubscriber, type FastEvents, type FastListenerExecutorArgs, type FastListenerMeta, type FastListenerNode, type FastListenerPipe, type FastListeners, type FastQueueOverflows, type FastQueuePriority, type IFastListenerExecutor, type Merge, type PickScopeEvents, type QueueListenerPipeOptions, QueueOverflowError, type RequiredItems, type RetryListenerPipeOptions, type ScopeEvents, type ThrottleOptions, TimeoutError, debounce, dropping, expanding, memorize, queue, retry, sliding, throttle, timeout };
+export { AbortError, CancelError, type ChangeFieldType, type DeepPartial, type Dict, type Expand, type Fallback, type FaseEventMessageExtends, FastEvent, type FastEventAnyListener, FastEventDirectives, type FastEventEmitMessage, FastEventError, type FastEventListenOptions, type FastEventListener, type FastEventListenerArgs, type FastEventMessage, type FastEventMeta, type FastEventOptions, FastEventScope, type FastEventScopeMeta, type FastEventScopeOptions, type FastEventSubscriber, type FastEvents, type FastListenerMeta, type FastListenerNode, type FastListeners, type Merge, type ObjectKeys, type OptionalItems, type Overloads, type OverrideOptions, type PickScopeEvents, QueueOverflowError, type RequiredItems, type ScopeEvents, TimeoutError, UnboundError, type Unique, __FastEventScope__, __FastEvent__ };

package/dist/index.js

@@ -1,2 +1,2 @@
-'use strict';var O=Object.defineProperty;var B=(s,t,e)=>t in s?O(s,t,{enumerable:true,configurable:true,writable:true,value:e}):s[t]=e;var c=(s,t)=>O(s,"name",{value:t,configurable:true});var V=(s,t)=>{for(var e in t)O(s,e,{get:t[e],enumerable:true});};var h=(s,t,e)=>B(s,typeof t!="symbol"?t+"":t,e);function y(s,t,e,i){let n,r,o,l={};typeof s[0]=="object"?(n=s[0].type,r=s[0].payload,l=typeof s[1]=="boolean"?{retain:s[1]}:s[1]||{},o=s[0].meta):(n=s[0],r=s[1],l=typeof s[2]=="boolean"?{retain:s[2]}:s[2]||{}),o=Object.assign({},t,e,l.meta,o),Object.keys(o).length===0&&(o=void 0);let u={type:n,payload:r,meta:o};return l.executor===void 0&&(l.executor=i),[u,l]}c(y,"handleEmitArgs");function _(s,t){return Object.defineProperty(s,"name",{value:t||"anonymous",configurable:true}),s}c(_,"renameFn");var L=class L{constructor(t,e,i){h(this,"emitter");h(this,"prefix");h(this,"options");h(this,"events");this.emitter=t,this.prefix=e,this.options=Object.assign({},{scope:e},i),e.length>0&&!e.endsWith(t.options.delimiter)&&(this.prefix=e+t.options.delimiter);}get context(){return this.options.context}_getScopeListener(t){let e=this.prefix;if(e.length===0)return t;let i=this;return _(function(r,o){if(r.type.startsWith(e))return t.call(i.context||i.emitter.context,Object.assign({},r,{type:r.type.substring(e.length)}),o)},t.name)}_getScopeType(t){return t===void 0?void 0:this.prefix+t}_fixScopeType(t){return t.startsWith(this.prefix)?t.substring(this.prefix.length):t}on(){let t=[...arguments];return t[0]=this._getScopeType(t[0]),t[1]=this._getScopeListener(t[1]),this.emitter.on(...t)}once(){return this.on(arguments[0],arguments[1],Object.assign({},arguments[2],{count:1}))}onAny(t,e){return this.on("**",t,e)}off(){let t=arguments;typeof t[0]=="string"&&(t[0]=this._getScopeType(t[0])),this.emitter.off(...t);}offAll(){this.emitter.offAll(this.prefix.substring(0,this.prefix.length-1));}clear(){this.emitter.clear(this.prefix.substring(0,this.prefix.length-1));}emit(){let[t,e]=y(arguments,this.emitter.options.meta,this.options.meta,this.options.executor);return t.type=this._getScopeType(t.type),this.emitter.emit(t,e)}async emitAsync(){return (await Promise.allSettled(this.emit.apply(this,arguments))).map(e=>e.status==="fulfilled"?e.value:e.reason)}async waitFor(){let t=arguments[0],e=arguments[1],i=await this.emitter.waitFor(this._getScopeType(t),e);return Object.assign({},i,{type:this._fixScopeType(i.type)})}scope(t,e){let i=Object.assign({},this.options.meta,e?.meta),n=e?.context!==void 0?e.context:this.context,r=Object.assign({},this.options,e,{meta:Object.keys(i).length===0?void 0:i,context:n});return new L(this.emitter,this.prefix+t,r)}};c(L,"FastEventScope");var w=L;function R(s,t){if(s.length!==t.length&&s.length>0&&t[t.length-1]!=="**")return  false;let e=[...t];t.length>0&&t[t.length-1]==="**"&&e.splice(t.length-1,1,...Array.from({length:s.length-t.length+1}).fill("*"));for(let i=0;i<s.length;i++)if(e[i]!=="*"&&e[i]!==s[i])return  false;return  true}c(R,"isPathMatched");function N(s,t){let e=[];for(;;){let i=s.findIndex(n=>t(n));if(i===-1){e.push(i);break}s.splice(i,1);}return e}c(N,"removeItem");var v={};V(v,{allSettled:()=>k,balance:()=>$,first:()=>q,last:()=>H,race:()=>X,random:()=>G});var k=c((s,t,e,i)=>Promise.allSettled(s.map(n=>i(n[0],t,e))),"allSettled"),X=c((s,t,e,i)=>{let n,r;return (!e||e&&!e.abortSignal)&&(r=new AbortController,e||(e={}),e.abortSignal=r.signal),[Promise.race(s.map(l=>(l[2]--,Promise.resolve(i(l[0],t,e)).then(u=>(n||(n=l,l[2]++),r?.abort(),u)))))]},"race"),$=c((s,t,e,i)=>{let n,r=0;return s.forEach((o,l)=>{o[2]--,(n===void 0||n>o[2])&&(n=o[2],r=l);}),s[r][2]++,[i(s[r][0],t,e)]},"balance"),q=c((s,t,e,i)=>(s.forEach(n=>n[2]--),s[0][2]++,[i(s[0][0],t,e)]),"first"),H=c((s,t,e,i)=>(s.forEach(n=>n[2]--),s[s.length-1][2]++,[i(s[s.length-1][0],t,e)]),"last"),G=c((s,t,e,i)=>{let n=Math.floor(Math.random()*s.length);return s.forEach(r=>r[2]--),s[n][2]++,[i(s[n][0],t,e)]},"random");function a(s){return s&&typeof s=="function"}c(a,"isFunction");var M=class M extends Error{};c(M,"FastEventError");var x=M,A=class A extends x{};c(A,"TimeoutError");var b=A,j=class j extends x{};c(j,"AbortError");var E=j,C=class C extends x{};c(C,"QueueOverflowError");var T=C;var F=class F{constructor(t){h(this,"listeners",{__listeners:[]});h(this,"_options");h(this,"_delimiter","/");h(this,"_context");h(this,"retainedMessages",new Map);h(this,"listenerCount",0);h(this,"events");this._options=Object.assign({debug:false,id:Math.random().toString(36).substring(2),delimiter:"/",context:null,ignoreErrors:true,meta:void 0},t),this._delimiter=this._options.delimiter,this._context=this._options.context,this._enableDevTools();}get options(){return this._options}get context(){return this._context}get id(){return this._options.id}_addListener(t,e,i){let{count:n,prepend:r}=i;return this._forEachNodes(t,o=>{let l=[e,n,0];r?o.__listeners.splice(0,0,l):o.__listeners.push(l),this.listenerCount++,a(this._options.onAddListener)&&this._options.onAddListener(t,e);})}_enableDevTools(){this.options.debug&&globalThis.__FLEXEVENT_DEVTOOLS__&&globalThis.__FLEXEVENT_DEVTOOLS__.add(this);}_forEachNodes(t,e){if(t.length===0)return;let i=this.listeners;for(let n=0;n<t.length;n++){let r=t[n];if(r in i||(i[r]={__listeners:[]}),n===t.length-1){let o=i[r];return e(o,i),o}else i=i[r];}}_removeListener(t,e,i){i&&N(t.__listeners,n=>{n=Array.isArray(n)?n[0]:n;let r=n===i;return r&&(this.listenerCount--,a(this._options.onRemoveListener)&&this._options.onRemoveListener(e,i)),r});}_pipeListener(t,e){return e.forEach(i=>{t=_(i(t),t.name);}),t}on(){let t=arguments[0],e=a(arguments[1])?arguments[1]:this.onMessage.bind(this),i=Object.assign({count:0,prepend:false},a(arguments[1])?arguments[2]:arguments[1]);if(t.length===0)throw new Error("event type cannot be empty");let n=t.split(this._delimiter);if(i.pipes&&i.pipes.length>0&&(e=this._pipeListener(e,i.pipes)),a(i.filter)||a(i.off)){let l=e;e=_(function(u,f){if(a(i.off)&&i.off.call(this,u,f)){o();return}if(a(i.filter)){if(i.filter.call(this,u,f))return l.call(this,u,f)}else return l.call(this,u,f)},e.name);}let r=this._addListener(n,e,i),o=c(()=>r&&this._removeListener(r,n,e),"off");return r&&!t.includes("*")&&this._emitForLastEvent(t),{off:o,listener:e}}once(){return a(arguments[1])?this.on(arguments[0],arguments[1],Object.assign({},arguments[2],{count:1})):this.on(arguments[0],Object.assign({},arguments[2],{count:1}))}onAny(){return this.on("**",arguments[0],arguments[1])}onMessage(t){}off(){let t=arguments,e=a(t[0])?void 0:t[0],i=a(t[0])?t[0]:t[1],n=e?e.split(this._delimiter):[],r=e?e.includes("*"):false;if(e&&!r)this._traverseToPath(this.listeners,n,o=>{i?this._removeListener(o,n,i):e&&(o.__listeners=[]);});else {let o=r?[]:n;this._traverseListeners(this.listeners,o,(l,u)=>{(i!==void 0||r&&R(l,n))&&(i?this._removeListener(u,n,i):u.__listeners=[]);});}}offAll(t){if(t){let e=t.split(this._delimiter),i=0;this._traverseListeners(this.listeners,e,(n,r)=>{i+=r.__listeners.length,r.__listeners=[];}),this.listenerCount-=i,this._removeRetainedEvents(t);}else {let e=0;this._traverseListeners(this.listeners,[],(i,n)=>{e+=n.__listeners.length;}),this.listenerCount-=e,this.retainedMessages.clear(),this.listeners={__listeners:[]};}a(this._options.onClearListeners)&&this._options.onClearListeners.call(this);}_removeRetainedEvents(t){t||this.retainedMessages.clear(),t?.endsWith(this._delimiter)&&(t+=this._delimiter),this.retainedMessages.delete(t);for(let e of this.retainedMessages.keys())e.startsWith(t)&&this.retainedMessages.delete(e);}clear(t){this.offAll(t),this._removeRetainedEvents(t);}_emitForLastEvent(t){if(this.retainedMessages.has(t)){let e=this.retainedMessages.get(t),i=t.split(this._delimiter),n=[];this._traverseToPath(this.listeners,i,r=>{n.push(r);}),this._executeListeners(n,e);}}_traverseToPath(t,e,i,n=0,r){if(n>=e.length){i(t);return}let o=e[n];if(r===true){this._traverseToPath(t,e,i,n+1,true);return}"*"in t&&this._traverseToPath(t["*"],e,i,n+1),"**"in t&&this._traverseToPath(t["**"],e,i,n+1,true),o in t&&this._traverseToPath(t[o],e,i,n+1);}_traverseListeners(t,e,i){let n=t;e&&e.length>0&&this._traverseToPath(t,e,o=>{n=o;});let r=c((o,l,u)=>{l(u,o);for(let[f,m]of Object.entries(o))f.startsWith("__")||m&&r(m,l,[...u,f]);},"traverseNodes");r(n,i,[]);}_onListenerError(t,e,i,n){if(n instanceof Error&&(n._emitter=`${t.name||"anonymous"}:${e.type}`),a(this._options.onListenerError))try{this._options.onListenerError.call(this,t,n,e,i);}catch{}if(this._options.ignoreErrors)return n;throw n}_executeListener(t,e,i){try{if(i&&i.abortSignal&&i.abortSignal.aborted)return this._onListenerError(t,e,i,new E(t.name));let n=t.call(this._context||this,e,i);return n&&n instanceof Promise&&(n=n.catch(r=>this._onListenerError(t,e,i,r))),n}catch(n){return this._onListenerError(t,e,i,n)}}_getListenerExecutor(t){if(!t)return;let e=t.executor||this._options.executor;if(a(e))return e;if(e&&e in v)return v[e]}_executeListeners(t,e,i){if(!t||t.length===0)return [];let n=t.reduce((r,o)=>r.concat(o.__listeners.map((l,u)=>[l,u,o.__listeners])),[]);try{let r=this._getListenerExecutor(i);return r?r(n.map(o=>o[0]),e,i,this._executeListener.bind(this)):n.map(o=>this._executeListener(o[0][0],e,i))}finally{for(let r=n.length-1;r>=0;r--){let o=n[r][0];o[2]++,o[1]>0&&o[1]<=o[2]&&n[r][2].splice(r,1);}}}emit(){let[t,e]=y(arguments,this.options.meta),i=t.type.split(this._delimiter);e.retain&&this.retainedMessages.set(t.type,t);let n=[],r=[];if(this._traverseToPath(this.listeners,i,o=>{r.push(o);}),a(this._options.onBeforeExecuteListener)&&this._options.onBeforeExecuteListener.call(this,t,e)===false)throw new Error("emit "+t.type+" is aborted");return n.push(...this._executeListeners(r,t,e)),a(this._options.onAfterExecuteListener)&&this._options.onAfterExecuteListener.call(this,t,n,r),n}async emitAsync(){return (await Promise.allSettled(this.emit.apply(this,arguments))).map(e=>e.status==="fulfilled"?e.value:e.reason)}waitFor(){let t=arguments[0],e=arguments[1];return new Promise((i,n)=>{let r,o,l=c(u=>{clearTimeout(r),o.off(),i(u);},"listener");e&&e>0&&(r=setTimeout(()=>{o&&o.off(),n(new Error("wait for event<"+t+"> is timeout"));},e)),o=this.on(t,l);})}scope(t,e){return new w(this,t,e)}};c(F,"FastEvent");var W=F;var D=c(s=>{let{lifetime:t,size:e,overflow:i,maxExpandSize:n,expandOverflow:r,onEnter:o,onDrop:l}=Object.assign({size:10,maxExpandSize:100,overflow:"expand",expandOverflow:"slide",lifetime:0},s),u=[],f=e,m=false,P=c(p=>{a(o)?o(p,u):u.push(t>0?[p,Date.now()]:[p,0]);},"pushMessage"),z=c(p=>{switch(u.length>=n&&i==="expand"?r:i){case "drop":return a(l)&&l(p),false;case "expand":return f=Math.min(f+e,n),P(p),true;case "slide":let d=u.shift();return a(l)&&d&&l(d[0]),P(p),true;case "throw":throw a(l)&&l(p),new T;default:return  false}},"handleOverflow");return p=>async function(g,d){if(m){u.length<f?P(g):z(g);return}m=true;try{for(await p.call(this,g,d);u.length>0;){let[S,I]=u.shift()||[void 0,0];if(S){if(t>0&&Date.now()-I>t){a(l)&&l(S);continue}await p.call(this,S,d);}}}finally{m=false;}}},"queue"),bt=c((s=10)=>D({size:s,overflow:"drop"}),"dropping"),Et=c((s=10)=>D({size:s,overflow:"slide"}),"sliding"),Tt=c(s=>D(Object.assign({},s,{overflow:"expand"})),"expanding");var Mt=c((s,t)=>{let{interval:e=1e3,drop:i}=t||{};return n=>async function(r,o){let l=0,u;for(;l<=s;)try{return await n.call(this,r,o)}catch(f){if(u=f,l<s)await new Promise(m=>{setTimeout(m,e);}),l++;else throw a(i)&&i(r,u),u}}},"retry");var Ft=c((s,t)=>e=>async function(i,n){let r,o=new Promise((u,f)=>{r=setTimeout(()=>{t!==void 0?u(t):f(new b);},s);}),l=Promise.resolve(e.call(this,i,n));try{return await Promise.race([l,o])}finally{clearTimeout(r);}},"timeout");var Nt=c((s,t)=>e=>{let i=false,n=null;return async function(r,o){if(i){t?.drop&&t.drop(r);return}try{i=!0;let l=await e.call(this,r,o);return n=setTimeout(()=>{i=!1,n=null;},s),l}catch(l){throw i=false,n&&(clearTimeout(n),n=null),l}}},"debounce");var It=c((s,t)=>e=>{let i=0;return async function(n,r){let o=Date.now();if(o-i<s){t?.drop&&t.drop(n);return}return i=o,await e.call(this,n,r)}},"throttle");function kt(s){let t,e=false,i,n=typeof s=="function";return function(r){return async function(o,l){if(e){if(typeof s=="function"){if(await s(o,l))return t}else if(o.payload===i)return t}let u=await r.call(this,o,l);return t=u,n||(i=o.payload),e=true,u}}}c(kt,"memorize");exports.AbortError=E;exports.FastEvent=W;exports.FastEventError=x;exports.FastEventScope=w;exports.QueueOverflowError=T;exports.TimeoutError=b;exports.debounce=Nt;exports.dropping=bt;exports.expanding=Tt;exports.memorize=kt;exports.queue=D;exports.retry=Mt;exports.sliding=Et;exports.throttle=It;exports.timeout=Ft;//# sourceMappingURL=index.js.map
+'use strict';var R=Object.defineProperty;var $=(r,e,t)=>e in r?R(r,e,{enumerable:true,configurable:true,writable:true,value:t}):r[e]=t;var a=(r,e)=>R(r,"name",{value:e,configurable:true});var f=(r,e,t)=>$(r,typeof e!="symbol"?e+"":e,t);var G=Symbol.for("__FastEvent__"),H=Symbol.for("__FastEventScope__"),S=class S extends Error{constructor(e){super(e);}};a(S,"FastEventError");var m=S,A=class A extends m{};a(A,"TimeoutError");var F=A,M=class M extends m{};a(M,"UnboundError");var d=M,T=class T extends m{};a(T,"AbortError");var _=T,j=class j extends m{};a(j,"CancelError");var x=j,w=class w extends m{};a(w,"QueueOverflowError");var C=w,y={clearRetain:Symbol.for("ClearRetain")};function b(r,e,t,s){let i,n={},o={};return typeof r[0]=="object"?(Object.assign(o,r[0]),n=typeof r[1]=="boolean"?{retain:r[1]}:r[1]||{},i=r[0].meta):(o.type=r[0],o.payload=r[1],n=typeof r[2]=="boolean"?{retain:r[2]}:r[2]||{}),i=Object.assign({},e,t,n.meta,i),Object.keys(i).length===0&&(i=void 0),o.meta=i,n.executor===void 0&&(n.executor=s),[o,n]}a(b,"parseEmitArgs");function D(r){return r?typeof r=="object"&&"__FastEventScope__"in r:false}a(D,"isFastEventScope");function L(r,e,t){let s=r[0],i=D(r[1])?r[1]:void 0,n=(i?r[2]:r[1])||{};return n.meta=Object.assign({},e,n?.meta),n.context=n.context!==void 0?n.context:t,[s,i,n]}a(L,"parseScopeArgs");function g(r,e){return Object.defineProperty(r,"name",{value:e||"anonymous",configurable:true}),r}a(g,"renameFn");var v=class v{constructor(e){f(this,"__FastEventScope__",true);f(this,"_options",{});f(this,"types",{events:void 0,meta:void 0,context:void 0});f(this,"prefix","");f(this,"emitter");this._options=Object.assign({},e);}get context(){return this.options.context||this}get options(){return this._options}bind(e,t,s){this.emitter=e,this._options=Object.assign(this._options,{scope:t},s),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;e||(e=(this._options.onMessage||this.onMessage).bind(this));let s=this;return g(function(n,o){if(n.type.startsWith(t))return e.call(s.context,Object.assign({},n,{type:n.type.substring(t.length)}),o)},e.name)}_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(){if(!this.emitter)throw new d;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(){return this.on("**",...arguments)}off(){let e=arguments;typeof e[0]=="string"&&(e[0]=this._getScopeType(e[0])),this.emitter.off(...e);}offAll(){this.emitter.offAll(this.prefix.substring(0,this.prefix.length-1));}clear(){this.emitter.clear(this.prefix.substring(0,this.prefix.length-1));}emit(){if(arguments.length===2&&typeof arguments[0]=="string"&&arguments[1]===y.clearRetain)return this.emitter.emit(this._getScopeType(arguments[0]));let[e,t]=b(arguments,this.emitter.options.meta,this.options.meta,this.options.executor);return e.type=this._getScopeType(e.type),this.emitter.emit(e,t)}async emitAsync(){return (await Promise.allSettled(this.emit.apply(this,arguments))).map(t=>t.status==="fulfilled"?t.value:t.reason)}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(){let[e,t,s]=L(arguments,this.options.meta,this.options.context),i;return t?i=t:i=new v,i.bind(this.emitter,this.prefix+e,s),i}onMessage(e,t){}};a(v,"FastEventScope");var E=v;function O(r,e){if(r.length!==e.length&&r.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:r.length-e.length+1}).fill("*"));for(let s=0;s<r.length;s++)if(t[s]!=="*"&&t[s]!==r[s])return  false;return  true}a(O,"isPathMatched");function W(r,e){let t=[];for(;;){let s=r.findIndex(i=>e(i));if(s===-1){t.push(s);break}r.splice(s,1);}return t}a(W,"removeItem");function h(r){return r&&typeof r=="function"}a(h,"isFunction");var q=Symbol.for("__expandable__");function N(r){return r&&r[q]}a(N,"isExpandable");function V(r){for(let e=0;e<r.length;e++){let t=r[e];Array.isArray(t)&&N(t)&&(r.splice(e,1,...t),e+=t.length-1);}return r}a(V,"expandEmitResults");function I(r){return r&&typeof r=="object"&&"off"in r&&"listener"in r}a(I,"isSubsctiber");function B(r,e){return r.catch(t=>(e&&e(t),Promise.resolve(t)))}a(B,"tryReturnError");var P=class P{constructor(e){f(this,"__FastEvent__",true);f(this,"listeners",{__listeners:[]});f(this,"_options");f(this,"_delimiter","/");f(this,"_context");f(this,"retainedMessages",new Map);f(this,"listenerCount",0);f(this,"types",{events:void 0,meta:void 0,context:void 0});this._options=Object.assign({debug:false,id:Math.random().toString(36).substring(2),delimiter:"/",context:null,ignoreErrors:true,meta:void 0,expandEmitResults:true},e),this._delimiter=this._options.delimiter,this._context=this._options.context,this._enableDevTools();}get options(){return this._options}get context(){return this.options.context||this}get meta(){return this.options.meta}get id(){return this._options.id}_addListener(e,t,s){let{count:i,prepend:n}=s,o=0;return [this._forEachNodes(e,u=>{let l=[t,i,0];n?(u.__listeners.splice(0,0,l),o=0):(u.__listeners.push(l),o=u.__listeners.length-1),this.listenerCount++;}),o]}_enableDevTools(){this.options.debug&&globalThis.__FLEXEVENT_DEVTOOLS__&&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 n=e[i];if(n in s||(s[n]={__listeners:[]}),i===e.length-1){let o=s[n];return t(o,s),o}else s=s[n];}}_removeListener(e,t,s){s&&W(e.__listeners,i=>{i=Array.isArray(i)?i[0]:i;let n=i===s;return n&&(this.listenerCount--,h(this._options.onRemoveListener)&&this._options.onRemoveListener(t.join(this._delimiter),s)),n});}_pipeListener(e,t){return t.forEach(s=>{e=g(s(e),e.name);}),e}on(){let e=arguments[0],t=h(arguments[1])?arguments[1]:(this._options.onMessage||this.onMessage).bind(this),s=Object.assign({count:0,prepend:false},h(arguments[1])?arguments[2]:arguments[1]);if(e.length===0)throw new Error("event type cannot be empty");if(h(this._options.onAddListener)){let u=this._options.onAddListener(e,t,s);if(u===false)throw new x;if(I(u))return u}let i=e.split(this._delimiter);if(s.pipes&&s.pipes.length>0&&(t=this._pipeListener(t,s.pipes)),h(s.filter)||h(s.off)){let u=t;t=g(function(l,p){if(h(s.off)&&s.off.call(this,l,p)){c();return}if(h(s.filter)){if(s.filter.call(this,l,p))return u.call(this,l,p)}else return u.call(this,l,p)},t.name);}let[n,o]=this._addListener(i,t,s),c=a(()=>n&&this._removeListener(n,i,t),"off");return this._emitRetainMessage(e,n,o),{off:c,listener:t}}once(){return h(arguments[1])?this.on(arguments[0],arguments[1],Object.assign({},arguments[2],{count:1})):this.on(arguments[0],Object.assign({},arguments[2],{count:1}))}onAny(){return this.on("**",arguments[0],arguments[1])}onMessage(e,t){}off(){let e=arguments,t=h(e[0])?void 0:e[0],s=h(e[0])?e[0]:e[1],i=t?t.split(this._delimiter):[],n=t?t.includes("*"):false;if(t&&!n)this._traverseToPath(this.listeners,i,o=>{s?this._removeListener(o,i,s):t&&(o.__listeners=[]);});else {let o=n?[]:i;this._traverseListeners(this.listeners,o,(c,u)=>{(s!==void 0||n&&O(c,i))&&(s?this._removeListener(u,i,s):u.__listeners=[]);});}}offAll(e){if(e){let t=e.split(this._delimiter),s=0;this._traverseListeners(this.listeners,t,(i,n)=>{s+=n.__listeners.length,n.__listeners=[];}),this.listenerCount-=s,this._removeRetainedEvents(e);}else {let t=0;this._traverseListeners(this.listeners,[],(s,i)=>{t+=i.__listeners.length;}),this.listenerCount-=t,this.retainedMessages.clear(),this.listeners={__listeners:[]};}h(this._options.onClearListeners)&&this._options.onClearListeners.call(this);}_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(e){this.offAll(e),this._removeRetainedEvents(e);}_emitRetainMessage(e,t,s){let i=[];if(e.includes("*")){let n=e.split(this._delimiter);this.retainedMessages.forEach((o,c)=>{let u=c.split(this._delimiter);O(u,n)&&i.push(o);});}else this.retainedMessages.has(e)&&i.push(this.retainedMessages.get(e));t&&i.forEach(n=>{this._executeListeners([t],n,{},o=>o[0]===t.__listeners[s][0]);});}_traverseToPath(e,t,s,i=0,n){if(i>=t.length){s(e);return}let o=t[i];if(n===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),o in e&&this._traverseToPath(e[o],t,s,i+1);}_traverseListeners(e,t,s){let i=e;t&&t.length>0&&this._traverseToPath(e,t,o=>{i=o;});let n=a((o,c,u)=>{c(u,o);for(let[l,p]of Object.entries(o))l.startsWith("__")||p&&n(p,c,[...u,l]);},"traverseNodes");n(i,s,[]);}_onListenerError(e,t,s,i){if(i instanceof Error&&(i._emitter=`${e.name||"anonymous"}:${t.type}`),h(this._options.onListenerError))try{this._options.onListenerError.call(this,i,e,t,s);}catch{}if(this._options.ignoreErrors)return i;throw i}_executeListener(e,t,s,i=false){try{if(s&&s.abortSignal&&s.abortSignal.aborted)return this._onListenerError(e,t,s,new _(e.name));let n=e.call(this.context,t,s);return i&&n&&n instanceof Promise&&(n=B(n,o=>this._onListenerError(e,t,s,o))),n}catch(n){return this._onListenerError(e,t,s,n)}}_getListenerExecutor(e){if(!e)return;let t=e.executor||this._options.executor;if(h(t))return t}_executeListeners(e,t,s,i){if(!e||e.length===0)return [];let n=e.reduce((o,c)=>o.concat(c.__listeners.filter(u=>h(i)?i(u,c):true).map((u,l)=>[u,l,c.__listeners])),[]);try{let o=this._getListenerExecutor(s);if(o){let c=o(n.map(u=>u[0]),t,s,this._executeListener.bind(this));return Array.isArray(c)?c:[c]}else return n.map(c=>this._executeListener(c[0][0],t,s,!0))}finally{for(let o=n.length-1;o>=0;o--){let c=n[o][0];c[2]++,c[1]>0&&c[1]<=c[2]&&n[o][2].splice(o,1);}}}emit(){if(arguments.length===2&&typeof arguments[0]=="string"&&arguments[1]===y.clearRetain)return this.retainedMessages.delete(arguments[0]),[];let[e,t]=b(arguments,this.options.meta);h(t.parseArgs)&&t.parseArgs(e,t);let s=e.type.split(this._delimiter);t.retain&&this.retainedMessages.set(e.type,e);let i=[],n=[];if(this._traverseToPath(this.listeners,s,o=>{n.push(o);}),h(this._options.onBeforeExecuteListener)){let o=this._options.onBeforeExecuteListener.call(this,e,t);if(Array.isArray(o))return o;if(o===false)throw new _(e.type)}return i.push(...this._executeListeners(n,e,t)),h(this._options.onAfterExecuteListener)&&this._options.onAfterExecuteListener.call(this,e,i,n),this._options.expandEmitResults&&V(i),i}async emitAsync(){return (await Promise.allSettled(this.emit.apply(this,arguments))).map(t=>t.status==="fulfilled"?t.value:t.reason)}waitFor(){let e=arguments[0],t=arguments[1];return new Promise((s,i)=>{let n,o,c=a(u=>{clearTimeout(n),o.off(),s(u);},"listener");t&&t>0&&(n=setTimeout(()=>{o&&o.off(),i(new Error("wait for event<"+e+"> is timeout"));},t)),o=this.on(e,c);})}scope(){let[e,t,s]=L(arguments,this.options.meta,this.options.context),i;return t?i=t:i=new E,i.bind(this,e,s),i}};a(P,"FastEvent");var X=P;exports.AbortError=_;exports.CancelError=x;exports.FastEvent=X;exports.FastEventDirectives=y;exports.FastEventError=m;exports.FastEventScope=E;exports.QueueOverflowError=C;exports.TimeoutError=F;exports.UnboundError=d;exports.__FastEventScope__=H;exports.__FastEvent__=G;//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map