fastevent 2.2.12 → 2.3.0

package/dist/eventbus/index.d.mts

@@ -2,6 +2,18 @@ type FastListenerExecutor = (listeners: FastListenerMeta[], message: TypedFastEv
 
 type FastListenerPipe = (listener: TypedFastEventListener) => TypedFastEventListener;
 
+type Expand$1<T> = T extends infer O ? {
+    [K in keyof O]: O[K];
+} : never;
+type ContainsWildcard<T extends string> = T extends `${string}/*/${string}` ? true : T extends `${string}/*` ? true : T extends `*/${string}` ? true : T extends `*` ? true : false;
+type ReplaceWildcard<T extends string> = T extends `*${infer Rest}` ? `${string}${ReplaceWildcard<Rest>}` : T extends `${infer Head}*${infer Rest}` ? `${Head}${string}${ReplaceWildcard<Rest>}` : T;
+type WildcardKeys<T> = {
+    [K in keyof T]: K extends string ? (ContainsWildcard<K> extends true ? K : never) : never;
+}[keyof T];
+type ExpandWildcard<T extends Record<string, any>> = Expand$1<T & {
+    [K in WildcardKeys<T> as ReplaceWildcard<K>]: T[K];
+}>;
+
 type MergeUnion<T> = (T extends any ? (x: T) => void : never) extends (x: infer U) => void ? {
     [K in keyof U]: U[K];
 } : never;
@@ -16,9 +28,10 @@ type MatchEventType<T extends string, Events extends Record<string, any>> = Merg
     [K in keyof Events]: MatchPattern<T, K & string> extends never ? never : {
         [P in K]: Events[K];
     };
-}[keyof Events] extends infer Result ? Result extends Record<string, any> ? Result : any : any, {
+}[keyof Events] extends infer Result ? Result extends Record<string, any> ? Result : Record<string, any> : Record<string, any>, {
     [K in T]: any;
 }>>;
+type MatchEventPayload<Events extends Record<string, any>, T> = T extends keyof Events ? Events[T] : T extends string ? T extends keyof MatchEventType<T, Events> ? MatchEventType<T, Events>[T] : any : any;
 
 type Split<S extends string, Delimiter extends string> = S extends `${infer Head}${Delimiter}${infer Tail}` ? [Head, ...Split<Tail, Delimiter>] : [S];
 type MatchPatternAndGetRemainder<KeyParts extends string[], PrefixParts extends string[], Result extends string[] = []> = PrefixParts['length'] extends 0 ? KeyParts['length'] extends 0 ? never : KeyParts : KeyParts['length'] extends 0 ? never : KeyParts[0] extends PrefixParts[0] | '*' ? MatchPatternAndGetRemainder<Slice<KeyParts, 1>, Slice<PrefixParts, 1>, Result> : never;
@@ -59,9 +72,11 @@ type FastEventEmitMessage<Events extends Record<string, any> = Record<string, an
         meta?: DeepPartial<FastEventMeta & M & Record<string, any>>;
     };
 }[Exclude<keyof Events, number | symbol>] & FastEventMessageExtends;
-type TypedFastEventListener<T extends string = string, P = any, M = any, C = any> = (this: C, message: TypedFastEventMessage<{
-    [K in T]: P;
-}, M>, args: FastEventListenerArgs<M>) => any | Promise<any>;
+type FastMessagePayload<P = any> = {
+    type: P;
+    __IS_FAST_MESSAGE__: true;
+};
+type TypedFastEventListener<T extends string = string, P = any, M = any, C = any> = (this: C, message: TypedFastEventMessage<Record<T, P>, M>, args: FastEventListenerArgs<M>) => any | Promise<any>;
 type TypedFastEventAnyListener<Events extends Record<string, any> = Record<string, any>, Meta = never, Context = any> = (this: Context, message: TypedFastEventMessage<Events, Meta>, args: FastEventListenerArgs<Meta>) => any | Promise<any>;
 type FastEventListeners<Events extends Record<string, any> = Record<string, any>, M = any, C = any> = {
     [K in keyof Events]: TypedFastEventListener<Exclude<K, number | symbol>, Events[K], M, C>;
@@ -134,6 +149,16 @@ type FastEventOptions<Meta = Record<string, any>, Context = never> = {
     executor?: FastListenerExecutor;
     onMessage?: TypedFastEventListener;
     expandEmitResults?: boolean;
+    /**
+     * 对接收到的消息进行转换，用于将消息转换成其他格式
+     *
+     * new FastEvent({
+     *    transform:(message)=>{
+     *        message.payload
+     *    }
+     * })
+     */
+    transform?: (message: FastEventMessage) => any;
 };
 interface FastEvents {
 }
@@ -151,6 +176,9 @@ type FastEventListenOptions<Events extends Record<string, any> = Record<string,
      */
     tag?: string;
 };
+declare enum FastEventListenerFlags {
+    Transformed = 1
+}
 type FastEventListenerArgs<M = Record<string, any>> = {
     retain?: boolean;
     meta?: DeepPartial<M> & Record<string, any>;
@@ -167,6 +195,17 @@ type FastEventListenerArgs<M = Record<string, any>> = {
      * 当emit参数解析完成后的回调，用于修改emit参数
      */
     parseArgs?: (message: TypedFastEventMessage, args: FastEventListenerArgs) => void;
+    /**
+     * 额外的标识
+     *
+     * - 1: transformed 当消息是经过transform转换后的消息时的标识
+     *
+     */
+    flags?: FastEventListenerFlags;
+    /**
+     * 如果消息经过转换前的原主题
+     */
+    rawEventType?: string;
 };
 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;
@@ -256,6 +295,52 @@ type RecordValues<R extends Record<string, any>> = R[keyof R];
 type RecordPrefix<P extends string, R extends Record<string, any>> = {
     [K in keyof R as K extends `${P}/${infer S}` ? S : never]: R[K];
 };
+/**
+ * 声明事件类型时，一般情况下，K=事件名称，V=事件Payload参数类型
+ *
+ * AssertFastMessage用于声明V是一个FastMessage类型，而不是Payload类型
+ *
+ * 一般配合transform参数使用
+ *
+ * 例如：
+ * type CustomEvents = {
+       click: { x: number; y: number };
+    }
+    const emitter = new FastEvent<CustomEvents>();
+    emitter.on('click', (message) => {
+        // typeof message.payload === { x: number; y: number }
+    })
+    const emitter = new FastEvent<CustomEvents>({
+        transform:(message)=>{
+            if(message.type === 'click'){
+                return message.payload
+            }else{
+                return message
+            }
+        }
+    });
+    emitter.on('click', (message) => {
+        // typeof message === { x: number; y: number }
+    }
+ */
+type AssertFastMessage<M> = {
+    type: M;
+    __IS_FAST_MESSAGE__: true;
+};
+type NotPayload<M> = AssertFastMessage<M>;
+type PickPayload<M> = M extends FastMessagePayload ? M['type'] : M;
+type AtPayloads<Events extends Record<string, any>> = {
+    [K in keyof Events]: PickPayload<Events[K]>;
+};
+type PickTransformedEvents<T extends Record<string, any>> = ExpandWildcard<{
+    [key in keyof T as T[key] extends FastMessagePayload ? key : never]: T[key];
+}>;
+type OmitTransformedEvents<T extends Record<string, any>> = {
+    [key in keyof T as T[key] extends FastMessagePayload ? never : key]: T[key];
+};
+type TransformedEvents<Events extends Record<string, any>> = {
+    [K in keyof Events]: NotPayload<Events[K]>;
+};
 
 type FastEventBusMessage<Events extends Record<string, any> = Record<string, any>, M = any> = FastEventEmitMessage<Events, M> & {
     from?: string;
@@ -318,15 +403,17 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
     private _getScopeType;
     private _fixScopeType;
     on<T extends Types = Types>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
-    on<T extends string>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
+    on<T extends Exclude<string, Types>>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
     on(type: '**', options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
-    on<T extends Types = Types>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
-    on<T extends string>(type: T, listener: TypedFastEventListener<Exclude<keyof MatchEventType<T, Events>, number | symbol>, RecordValues<MatchEventType<T, Events>>, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    on<T extends keyof OmitTransformedEvents<Events>>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    on<T extends keyof PickTransformedEvents<Events>>(type: T, listener: (message: PickPayload<RecordValues<MatchEventType<Exclude<T, number | symbol>, Events>>>, args: FastEventListenerArgs<Meta>) => any | Promise<any>, options?: FastEventListenOptions<Events, Meta>): FastEventSubscriber;
+    on<T extends Exclude<string, Types>>(type: T, listener: TypedFastEventAnyListener<MatchEventType<T, Events>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
     on(type: '**', listener: TypedFastEventAnyListener<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: TypedFastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
-    once<T extends string>(type: T, listener: TypedFastEventListener<string, any, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    once<T extends Exclude<string, Types>>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
+    once<T extends keyof OmitTransformedEvents<Events>>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    once<T extends keyof PickTransformedEvents<Events>>(type: T, listener: (message: PickPayload<RecordValues<MatchEventType<Exclude<T, number | symbol>, Events>>>, args: FastEventListenerArgs<Meta>) => any | Promise<any>, options?: FastEventListenOptions<Events, Meta>): FastEventSubscriber;
+    once<T extends Exclude<string, Types>>(type: T, listener: TypedFastEventAnyListener<MatchEventType<T, Events>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
     onAny(options?: Pick<FastEventListenOptions, 'prepend'>): FastEventSubscriber;
     onAny<P = any>(listener: TypedFastEventAnyListener<{
         [K: string]: P;
@@ -340,19 +427,20 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
     clear(): void;
     emit(type: Types, directive: symbol): void;
     emit(type: string, directive: symbol): void;
-    emit<R = any, T extends Types = Types>(type: T, payload?: Events[T], retain?: boolean): R[];
-    emit<R = any, T extends string = string>(type: T, payload?: T extends Types ? Events[T] : RecordValues<MatchEventType<T, Events>>, retain?: boolean): R[];
-    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[T] : RecordValues<MatchEventType<T, Events>>, options?: FastEventListenerArgs<FinalMeta>): R[];
-    emit<R = any>(message: FastEventEmitMessage<Events, FinalMeta>, options?: FastEventListenerArgs<FinalMeta>): R[];
+    emit<R = any, T extends Types = Types>(type: T, payload?: PickPayload<Events[T]>, retain?: boolean): R[];
+    emit<R = any, T extends string = string>(type: T, payload?: PickPayload<T extends Types ? Events[T] : RecordValues<MatchEventType<T, Events>>>, retain?: boolean): R[];
+    emit<R = any, T extends string = string>(type: T, payload?: PickPayload<T extends Types ? Events[T] : RecordValues<MatchEventType<T, Events>>>, options?: FastEventListenerArgs<FinalMeta>): R[];
+    emit<R = any>(message: FastEventEmitMessage<AtPayloads<Events>, FinalMeta>, options?: FastEventListenerArgs<FinalMeta>): R[];
     emit<R = any, T extends string = string>(message: FastEventEmitMessage<{
-        [K in T]: K extends Types ? Events[K] : any;
+        [K in T]: PickPayload<K extends Types ? Events[K] : any>;
     }, FinalMeta>, options?: FastEventListenerArgs<FinalMeta>): R[];
-    emitAsync<R = any, T extends Types = Types>(type: T, payload?: Events[T], retain?: boolean): Promise<[R | Error][]>;
-    emitAsync<R = any, T extends string = string>(type: T, payload?: T extends Types ? Events[T] : any, retain?: boolean): Promise<[R | Error][]>;
-    emitAsync<R = any, T extends Types = Types>(type: T, payload?: Events[T], options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
-    emitAsync<R = any, T extends string = string>(type: T, payload?: T extends Types ? Events[T] : any, options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
-    emitAsync<R = any>(message: TypedFastEventMessage<Events, FinalMeta>, options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
+    emitAsync<R = any, T extends Types = Types>(type: T, payload?: PickPayload<Events[T]>, retain?: boolean): Promise<[R | Error][]>;
+    emitAsync<R = any, T extends string = string>(type: T, payload?: PickPayload<T extends Types ? Events[T] : any>, retain?: boolean): Promise<[R | Error][]>;
+    emitAsync<R = any, T extends Types = Types>(type: T, payload?: PickPayload<Events[T]>, options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
+    emitAsync<R = any, T extends string = string>(type: T, payload?: PickPayload<T extends Types ? Events[T] : any>, options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
+    emitAsync<R = any, T extends string = string>(message: FastEventEmitMessage<{
+        [K in T]: PickPayload<K extends Types ? Events[K] : any>;
+    }, FinalMeta>, options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
     waitFor<T extends Types>(type: T, timeout?: number): Promise<TypedFastEventMessage<{
         [key in T]: Events[T];
     }, FinalMeta>>;
@@ -516,8 +604,9 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
     on<T extends Types = Types>(type: T, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     on<T extends string>(type: T, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     on(type: '**', options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
-    on<T extends Types = Types>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, AllEvents[T], Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
-    on<T extends string>(type: T, listener: TypedFastEventAnyListener<MatchEventType<T, AllEvents>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    on<T extends keyof OmitTransformedEvents<AllEvents>>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, AllEvents[T], Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    on<T extends keyof PickTransformedEvents<AllEvents>>(type: T, listener: (message: PickPayload<RecordValues<MatchEventType<Exclude<T, number | symbol>, AllEvents>>>, args: FastEventListenerArgs<Meta>) => any | Promise<any>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    on<T extends Exclude<string, Types>>(type: T, listener: TypedFastEventAnyListener<MatchEventType<T, AllEvents>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     on(type: '**', listener: TypedFastEventAnyListener<Record<string, any>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     /**
      * 注册一次性事件监听器
@@ -542,8 +631,9 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      */
     once<T extends Types = Types>(type: T, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     once<T extends string>(type: T, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
-    once<T extends Types = Types>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, AllEvents[T], Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
-    once<T extends string>(type: T, listener: TypedFastEventAnyListener<MatchEventType<T, AllEvents>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    once<T extends keyof OmitTransformedEvents<AllEvents>>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, AllEvents[T], Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    once<T extends keyof PickTransformedEvents<AllEvents>>(type: T, listener: (message: PickPayload<RecordValues<MatchEventType<Exclude<T, number | symbol>, AllEvents>>>, args: FastEventListenerArgs<Meta>) => any | Promise<any>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    once<T extends Exclude<string, Types>>(type: T, listener: TypedFastEventAnyListener<MatchEventType<T, AllEvents>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     /**
      * 注册一个监听器，用于监听所有事件
      * @param listener 事件监听器函数，可以接收任意类型的事件数据
@@ -629,6 +719,7 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
     private _traverseToPath;
     private _traverseListeners;
     private _onListenerError;
+    private _setListenerFlags;
     /**
      * 执行单个监听器函数
      * @param listener - 要执行的监听器函数或包装过的监听器对象
@@ -731,16 +822,16 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      */
     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[T] : RecordValues<MatchEventType<T, AllEvents>>, retain?: boolean): R[];
+    emit<R = any, T extends Types = Types>(type: T, payload?: PickPayload<AllEvents[T]>, retain?: boolean): R[];
+    emit<R = any, T extends string = string>(type: T, payload: PickPayload<T extends Types ? AllEvents[T] : RecordValues<MatchEventType<T, AllEvents>>>, retain?: boolean): R[];
     emit<R = any, T extends string = string>(message: FastEventEmitMessage<{
         [K in T]: K extends Types ? AllEvents[K] : any;
     }, Meta>, retain?: boolean): R[];
     emit<R = any>(message: FastEventEmitMessage<AllEvents, Meta>, retain?: boolean): R[];
-    emit<R = any, T extends Types = Types>(type: T, payload?: AllEvents[T], options?: FastEventListenerArgs<Meta>): R[];
-    emit<R = any, T extends string = string>(type: T, payload?: T extends Types ? AllEvents[T] : RecordValues<MatchEventType<T, AllEvents>>, options?: FastEventListenerArgs<Meta>): R[];
+    emit<R = any, T extends Types = Types>(type: T, payload?: PickPayload<AllEvents[T]>, options?: FastEventListenerArgs<Meta>): R[];
+    emit<R = any, T extends string = string>(type: T, payload: PickPayload<T extends Types ? AllEvents[T] : RecordValues<MatchEventType<T, AllEvents>>>, options?: FastEventListenerArgs<Meta>): R[];
     emit<R = any, T extends string = string>(message: FastEventEmitMessage<{
-        [K in T]: K extends Types ? AllEvents[K] : any;
+        [K in T]: PickPayload<K extends Types ? AllEvents[K] : any>;
     }, Meta>, options?: FastEventListenerArgs<Meta>): R[];
     emit<R = any>(message: FastEventEmitMessage<AllEvents, Meta>, options?: FastEventListenerArgs<Meta>): R[];
     /**
@@ -779,16 +870,16 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      * });
      * ```
      */
-    emitAsync<R = any, T extends Types = Types>(type: T, payload?: AllEvents[T], retain?: boolean): Promise<[R | Error][]>;
-    emitAsync<R = any, T extends string = string>(type: T, payload?: T extends Types ? AllEvents[T] : any, retain?: boolean): Promise<[R | Error][]>;
+    emitAsync<R = any, T extends Types = Types>(type: T, payload?: PickPayload<AllEvents[T]>, retain?: boolean): Promise<[R | Error][]>;
+    emitAsync<R = any, T extends string = string>(type: T, payload?: PickPayload<T extends Types ? AllEvents[T] : any>, retain?: boolean): Promise<[R | Error][]>;
     emitAsync<R = any, T extends string = string>(message: FastEventEmitMessage<{
-        [K in T]: K extends Types ? AllEvents[K] : any;
+        [K in T]: PickPayload<K extends Types ? AllEvents[K] : any>;
     }, Meta>, retain?: boolean): Promise<[R | Error][]>;
     emitAsync<R = any>(message: FastEventEmitMessage<AllEvents, Meta>, retain?: boolean): Promise<[R | Error][]>;
-    emitAsync<R = any, T extends string = string>(type: T, payload?: T extends Types ? AllEvents[T] : any, options?: FastEventListenerArgs<Meta>): Promise<[R | Error][]>;
-    emitAsync<R = any, T extends Types = Types>(type: T, payload?: AllEvents[T], options?: FastEventListenerArgs<Meta>): Promise<[R | Error][]>;
+    emitAsync<R = any, T extends string = string>(type: T, payload?: PickPayload<T extends Types ? AllEvents[T] : any>, options?: FastEventListenerArgs<Meta>): Promise<[R | Error][]>;
+    emitAsync<R = any, T extends Types = Types>(type: T, payload?: PickPayload<AllEvents[T]>, options?: FastEventListenerArgs<Meta>): Promise<[R | Error][]>;
     emitAsync<R = any, T extends string = string>(message: FastEventEmitMessage<{
-        [K in T]: K extends Types ? AllEvents[K] : any;
+        [K in T]: PickPayload<K extends Types ? AllEvents[K] : any>;
     }, Meta>, options?: FastEventListenerArgs<Meta>): Promise<[R | Error][]>;
     emitAsync<R = any>(message: FastEventEmitMessage<AllEvents, Meta>, options?: FastEventListenerArgs<Meta>): Promise<[R | Error][]>;
     /**
@@ -878,7 +969,7 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
 
 type FastEventBusNodeOptions<Meta = Record<string, any>, Context = any> = FastEventOptions<Meta, Context> & {};
 declare class FastEventBusNode<Events extends Record<string, any> = Record<string, any>, Meta extends Record<string, any> = Record<string, any>, Context = never> extends FastEvent<Events, Meta, Context> {
-    eventbus?: FastEventBus<any, any, any>;
+    eventbus?: FastEventBus<any, any, any, any, any>;
     private _subscribers;
     constructor(options?: DeepPartial<FastEventBusNodeOptions<Meta, Context>>);
     /**
@@ -904,7 +995,7 @@ declare class FastEventBusNode<Events extends Record<string, any> = Record<strin
      * 加入事件总线
      * @param eventBus 要加入的事件总线
      */
-    connect(eventbus: FastEventBus<any, any, any>): void;
+    connect<E extends Record<string, any> = Record<string, any>, M extends Record<string, any> = Record<string, any>, C = any>(eventbus: FastEventBus<E, M, C>): void;
     disconnect(): void;
     /**
      *
@@ -1132,4 +1223,4 @@ declare function isClass(target: unknown): target is new (...args: any[]) => any
 
 declare function isFastEvent(target: any): target is FastEvent;
 
-export { AbortError, BroadcastEvent, CancelError, type ChangeFieldType, type DeepPartial, type Dict, type Expand, type Fallback, FastEvent, FastEventBus, type FastEventBusEventTypes, type FastEventBusEvents, type FastEventBusMessage, FastEventBusNode, type FastEventBusNodeIds, type FastEventBusNodeOptions, type FastEventBusNodes, type FastEventBusOptions, FastEventDirectives, type FastEventEmitMessage, FastEventError, type FastEventListenOptions, type FastEventListener, type FastEventListenerArgs, type FastEventListeners, type FastEventMessage, type FastEventMessageExtends, type FastEventMeta, type FastEventOptions, FastEventScope, type FastEventScopeMeta, type FastEventScopeOptions, type FastEventSubscriber, type FastEvents, type FastListenerMeta, type FastListenerNode, type FastListeners, type MatchEventType, type Merge, type MergeUnion, NamespaceDelimiter, NodeDataEvent, type ObjectKeys, type OptionalItems, type Overloads, type OverrideOptions, QueueOverflowError, type RecordPrefix, type RecordValues, type RequiredItems, type ScopeEvents, TimeoutError, type TypedFastEventAnyListener, type TypedFastEventListener, type TypedFastEventMessage, type TypedFastEventMessageOptional, UnboundError, type Union, type Unique, __FastEventScope__, __FastEvent__, __expandable__, expandable, isClass, isExpandable, isFastEvent, isFastEventMessage, isFastEventScope, isFunction, isPathMatched, isString, isSubsctiber };
+export { AbortError, type AssertFastMessage, type AtPayloads, BroadcastEvent, CancelError, type ChangeFieldType, type DeepPartial, type Dict, type Expand, type ExpandWildcard, type Fallback, FastEvent, FastEventBus, type FastEventBusEventTypes, type FastEventBusEvents, type FastEventBusMessage, FastEventBusNode, type FastEventBusNodeIds, type FastEventBusNodeOptions, type FastEventBusNodes, type FastEventBusOptions, FastEventDirectives, type FastEventEmitMessage, FastEventError, type FastEventListenOptions, type FastEventListener, type FastEventListenerArgs, FastEventListenerFlags, type FastEventListeners, type FastEventMessage, type FastEventMessageExtends, type FastEventMeta, type FastEventOptions, FastEventScope, type FastEventScopeMeta, type FastEventScopeOptions, type FastEventSubscriber, type FastEvents, type FastListenerMeta, type FastListenerNode, type FastListeners, type FastMessagePayload, type MatchEventPayload, type MatchEventType, type Merge, type MergeUnion, NamespaceDelimiter, NodeDataEvent, type NotPayload, type ObjectKeys, type OmitTransformedEvents, type OptionalItems, type Overloads, type OverrideOptions, type PickPayload, type PickTransformedEvents, QueueOverflowError, type RecordPrefix, type RecordValues, type RequiredItems, type ScopeEvents, TimeoutError, type TransformedEvents, type TypedFastEventAnyListener, type TypedFastEventListener, type TypedFastEventMessage, type TypedFastEventMessageOptional, UnboundError, type Union, type Unique, __FastEventScope__, __FastEvent__, __expandable__, expandable, isClass, isExpandable, isFastEvent, isFastEventMessage, isFastEventScope, isFunction, isPathMatched, isString, isSubsctiber };

package/dist/eventbus/index.d.ts

@@ -2,6 +2,18 @@ type FastListenerExecutor = (listeners: FastListenerMeta[], message: TypedFastEv
 
 type FastListenerPipe = (listener: TypedFastEventListener) => TypedFastEventListener;
 
+type Expand$1<T> = T extends infer O ? {
+    [K in keyof O]: O[K];
+} : never;
+type ContainsWildcard<T extends string> = T extends `${string}/*/${string}` ? true : T extends `${string}/*` ? true : T extends `*/${string}` ? true : T extends `*` ? true : false;
+type ReplaceWildcard<T extends string> = T extends `*${infer Rest}` ? `${string}${ReplaceWildcard<Rest>}` : T extends `${infer Head}*${infer Rest}` ? `${Head}${string}${ReplaceWildcard<Rest>}` : T;
+type WildcardKeys<T> = {
+    [K in keyof T]: K extends string ? (ContainsWildcard<K> extends true ? K : never) : never;
+}[keyof T];
+type ExpandWildcard<T extends Record<string, any>> = Expand$1<T & {
+    [K in WildcardKeys<T> as ReplaceWildcard<K>]: T[K];
+}>;
+
 type MergeUnion<T> = (T extends any ? (x: T) => void : never) extends (x: infer U) => void ? {
     [K in keyof U]: U[K];
 } : never;
@@ -16,9 +28,10 @@ type MatchEventType<T extends string, Events extends Record<string, any>> = Merg
     [K in keyof Events]: MatchPattern<T, K & string> extends never ? never : {
         [P in K]: Events[K];
     };
-}[keyof Events] extends infer Result ? Result extends Record<string, any> ? Result : any : any, {
+}[keyof Events] extends infer Result ? Result extends Record<string, any> ? Result : Record<string, any> : Record<string, any>, {
     [K in T]: any;
 }>>;
+type MatchEventPayload<Events extends Record<string, any>, T> = T extends keyof Events ? Events[T] : T extends string ? T extends keyof MatchEventType<T, Events> ? MatchEventType<T, Events>[T] : any : any;
 
 type Split<S extends string, Delimiter extends string> = S extends `${infer Head}${Delimiter}${infer Tail}` ? [Head, ...Split<Tail, Delimiter>] : [S];
 type MatchPatternAndGetRemainder<KeyParts extends string[], PrefixParts extends string[], Result extends string[] = []> = PrefixParts['length'] extends 0 ? KeyParts['length'] extends 0 ? never : KeyParts : KeyParts['length'] extends 0 ? never : KeyParts[0] extends PrefixParts[0] | '*' ? MatchPatternAndGetRemainder<Slice<KeyParts, 1>, Slice<PrefixParts, 1>, Result> : never;
@@ -59,9 +72,11 @@ type FastEventEmitMessage<Events extends Record<string, any> = Record<string, an
         meta?: DeepPartial<FastEventMeta & M & Record<string, any>>;
     };
 }[Exclude<keyof Events, number | symbol>] & FastEventMessageExtends;
-type TypedFastEventListener<T extends string = string, P = any, M = any, C = any> = (this: C, message: TypedFastEventMessage<{
-    [K in T]: P;
-}, M>, args: FastEventListenerArgs<M>) => any | Promise<any>;
+type FastMessagePayload<P = any> = {
+    type: P;
+    __IS_FAST_MESSAGE__: true;
+};
+type TypedFastEventListener<T extends string = string, P = any, M = any, C = any> = (this: C, message: TypedFastEventMessage<Record<T, P>, M>, args: FastEventListenerArgs<M>) => any | Promise<any>;
 type TypedFastEventAnyListener<Events extends Record<string, any> = Record<string, any>, Meta = never, Context = any> = (this: Context, message: TypedFastEventMessage<Events, Meta>, args: FastEventListenerArgs<Meta>) => any | Promise<any>;
 type FastEventListeners<Events extends Record<string, any> = Record<string, any>, M = any, C = any> = {
     [K in keyof Events]: TypedFastEventListener<Exclude<K, number | symbol>, Events[K], M, C>;
@@ -134,6 +149,16 @@ type FastEventOptions<Meta = Record<string, any>, Context = never> = {
     executor?: FastListenerExecutor;
     onMessage?: TypedFastEventListener;
     expandEmitResults?: boolean;
+    /**
+     * 对接收到的消息进行转换，用于将消息转换成其他格式
+     *
+     * new FastEvent({
+     *    transform:(message)=>{
+     *        message.payload
+     *    }
+     * })
+     */
+    transform?: (message: FastEventMessage) => any;
 };
 interface FastEvents {
 }
@@ -151,6 +176,9 @@ type FastEventListenOptions<Events extends Record<string, any> = Record<string,
      */
     tag?: string;
 };
+declare enum FastEventListenerFlags {
+    Transformed = 1
+}
 type FastEventListenerArgs<M = Record<string, any>> = {
     retain?: boolean;
     meta?: DeepPartial<M> & Record<string, any>;
@@ -167,6 +195,17 @@ type FastEventListenerArgs<M = Record<string, any>> = {
      * 当emit参数解析完成后的回调，用于修改emit参数
      */
     parseArgs?: (message: TypedFastEventMessage, args: FastEventListenerArgs) => void;
+    /**
+     * 额外的标识
+     *
+     * - 1: transformed 当消息是经过transform转换后的消息时的标识
+     *
+     */
+    flags?: FastEventListenerFlags;
+    /**
+     * 如果消息经过转换前的原主题
+     */
+    rawEventType?: string;
 };
 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;
@@ -256,6 +295,52 @@ type RecordValues<R extends Record<string, any>> = R[keyof R];
 type RecordPrefix<P extends string, R extends Record<string, any>> = {
     [K in keyof R as K extends `${P}/${infer S}` ? S : never]: R[K];
 };
+/**
+ * 声明事件类型时，一般情况下，K=事件名称，V=事件Payload参数类型
+ *
+ * AssertFastMessage用于声明V是一个FastMessage类型，而不是Payload类型
+ *
+ * 一般配合transform参数使用
+ *
+ * 例如：
+ * type CustomEvents = {
+       click: { x: number; y: number };
+    }
+    const emitter = new FastEvent<CustomEvents>();
+    emitter.on('click', (message) => {
+        // typeof message.payload === { x: number; y: number }
+    })
+    const emitter = new FastEvent<CustomEvents>({
+        transform:(message)=>{
+            if(message.type === 'click'){
+                return message.payload
+            }else{
+                return message
+            }
+        }
+    });
+    emitter.on('click', (message) => {
+        // typeof message === { x: number; y: number }
+    }
+ */
+type AssertFastMessage<M> = {
+    type: M;
+    __IS_FAST_MESSAGE__: true;
+};
+type NotPayload<M> = AssertFastMessage<M>;
+type PickPayload<M> = M extends FastMessagePayload ? M['type'] : M;
+type AtPayloads<Events extends Record<string, any>> = {
+    [K in keyof Events]: PickPayload<Events[K]>;
+};
+type PickTransformedEvents<T extends Record<string, any>> = ExpandWildcard<{
+    [key in keyof T as T[key] extends FastMessagePayload ? key : never]: T[key];
+}>;
+type OmitTransformedEvents<T extends Record<string, any>> = {
+    [key in keyof T as T[key] extends FastMessagePayload ? never : key]: T[key];
+};
+type TransformedEvents<Events extends Record<string, any>> = {
+    [K in keyof Events]: NotPayload<Events[K]>;
+};
 
 type FastEventBusMessage<Events extends Record<string, any> = Record<string, any>, M = any> = FastEventEmitMessage<Events, M> & {
     from?: string;
@@ -318,15 +403,17 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
     private _getScopeType;
     private _fixScopeType;
     on<T extends Types = Types>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
-    on<T extends string>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
+    on<T extends Exclude<string, Types>>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
     on(type: '**', options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
-    on<T extends Types = Types>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
-    on<T extends string>(type: T, listener: TypedFastEventListener<Exclude<keyof MatchEventType<T, Events>, number | symbol>, RecordValues<MatchEventType<T, Events>>, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    on<T extends keyof OmitTransformedEvents<Events>>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    on<T extends keyof PickTransformedEvents<Events>>(type: T, listener: (message: PickPayload<RecordValues<MatchEventType<Exclude<T, number | symbol>, Events>>>, args: FastEventListenerArgs<Meta>) => any | Promise<any>, options?: FastEventListenOptions<Events, Meta>): FastEventSubscriber;
+    on<T extends Exclude<string, Types>>(type: T, listener: TypedFastEventAnyListener<MatchEventType<T, Events>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
     on(type: '**', listener: TypedFastEventAnyListener<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: TypedFastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
-    once<T extends string>(type: T, listener: TypedFastEventListener<string, any, FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    once<T extends Exclude<string, Types>>(type: T, options?: FastEventListenOptions<Events, FinalMeta>): FastEventSubscriber;
+    once<T extends keyof OmitTransformedEvents<Events>>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, Events[T], FinalMeta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
+    once<T extends keyof PickTransformedEvents<Events>>(type: T, listener: (message: PickPayload<RecordValues<MatchEventType<Exclude<T, number | symbol>, Events>>>, args: FastEventListenerArgs<Meta>) => any | Promise<any>, options?: FastEventListenOptions<Events, Meta>): FastEventSubscriber;
+    once<T extends Exclude<string, Types>>(type: T, listener: TypedFastEventAnyListener<MatchEventType<T, Events>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions): FastEventSubscriber;
     onAny(options?: Pick<FastEventListenOptions, 'prepend'>): FastEventSubscriber;
     onAny<P = any>(listener: TypedFastEventAnyListener<{
         [K: string]: P;
@@ -340,19 +427,20 @@ declare class FastEventScope<Events extends Record<string, any> = Record<string,
     clear(): void;
     emit(type: Types, directive: symbol): void;
     emit(type: string, directive: symbol): void;
-    emit<R = any, T extends Types = Types>(type: T, payload?: Events[T], retain?: boolean): R[];
-    emit<R = any, T extends string = string>(type: T, payload?: T extends Types ? Events[T] : RecordValues<MatchEventType<T, Events>>, retain?: boolean): R[];
-    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[T] : RecordValues<MatchEventType<T, Events>>, options?: FastEventListenerArgs<FinalMeta>): R[];
-    emit<R = any>(message: FastEventEmitMessage<Events, FinalMeta>, options?: FastEventListenerArgs<FinalMeta>): R[];
+    emit<R = any, T extends Types = Types>(type: T, payload?: PickPayload<Events[T]>, retain?: boolean): R[];
+    emit<R = any, T extends string = string>(type: T, payload?: PickPayload<T extends Types ? Events[T] : RecordValues<MatchEventType<T, Events>>>, retain?: boolean): R[];
+    emit<R = any, T extends string = string>(type: T, payload?: PickPayload<T extends Types ? Events[T] : RecordValues<MatchEventType<T, Events>>>, options?: FastEventListenerArgs<FinalMeta>): R[];
+    emit<R = any>(message: FastEventEmitMessage<AtPayloads<Events>, FinalMeta>, options?: FastEventListenerArgs<FinalMeta>): R[];
     emit<R = any, T extends string = string>(message: FastEventEmitMessage<{
-        [K in T]: K extends Types ? Events[K] : any;
+        [K in T]: PickPayload<K extends Types ? Events[K] : any>;
     }, FinalMeta>, options?: FastEventListenerArgs<FinalMeta>): R[];
-    emitAsync<R = any, T extends Types = Types>(type: T, payload?: Events[T], retain?: boolean): Promise<[R | Error][]>;
-    emitAsync<R = any, T extends string = string>(type: T, payload?: T extends Types ? Events[T] : any, retain?: boolean): Promise<[R | Error][]>;
-    emitAsync<R = any, T extends Types = Types>(type: T, payload?: Events[T], options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
-    emitAsync<R = any, T extends string = string>(type: T, payload?: T extends Types ? Events[T] : any, options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
-    emitAsync<R = any>(message: TypedFastEventMessage<Events, FinalMeta>, options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
+    emitAsync<R = any, T extends Types = Types>(type: T, payload?: PickPayload<Events[T]>, retain?: boolean): Promise<[R | Error][]>;
+    emitAsync<R = any, T extends string = string>(type: T, payload?: PickPayload<T extends Types ? Events[T] : any>, retain?: boolean): Promise<[R | Error][]>;
+    emitAsync<R = any, T extends Types = Types>(type: T, payload?: PickPayload<Events[T]>, options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
+    emitAsync<R = any, T extends string = string>(type: T, payload?: PickPayload<T extends Types ? Events[T] : any>, options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
+    emitAsync<R = any, T extends string = string>(message: FastEventEmitMessage<{
+        [K in T]: PickPayload<K extends Types ? Events[K] : any>;
+    }, FinalMeta>, options?: FastEventListenerArgs<FinalMeta>): Promise<[R | Error][]>;
     waitFor<T extends Types>(type: T, timeout?: number): Promise<TypedFastEventMessage<{
         [key in T]: Events[T];
     }, FinalMeta>>;
@@ -516,8 +604,9 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
     on<T extends Types = Types>(type: T, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     on<T extends string>(type: T, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     on(type: '**', options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
-    on<T extends Types = Types>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, AllEvents[T], Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
-    on<T extends string>(type: T, listener: TypedFastEventAnyListener<MatchEventType<T, AllEvents>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    on<T extends keyof OmitTransformedEvents<AllEvents>>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, AllEvents[T], Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    on<T extends keyof PickTransformedEvents<AllEvents>>(type: T, listener: (message: PickPayload<RecordValues<MatchEventType<Exclude<T, number | symbol>, AllEvents>>>, args: FastEventListenerArgs<Meta>) => any | Promise<any>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    on<T extends Exclude<string, Types>>(type: T, listener: TypedFastEventAnyListener<MatchEventType<T, AllEvents>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     on(type: '**', listener: TypedFastEventAnyListener<Record<string, any>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     /**
      * 注册一次性事件监听器
@@ -542,8 +631,9 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      */
     once<T extends Types = Types>(type: T, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     once<T extends string>(type: T, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
-    once<T extends Types = Types>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, AllEvents[T], Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
-    once<T extends string>(type: T, listener: TypedFastEventAnyListener<MatchEventType<T, AllEvents>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    once<T extends keyof OmitTransformedEvents<AllEvents>>(type: T, listener: TypedFastEventListener<Exclude<T, number | symbol>, AllEvents[T], Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    once<T extends keyof PickTransformedEvents<AllEvents>>(type: T, listener: (message: PickPayload<RecordValues<MatchEventType<Exclude<T, number | symbol>, AllEvents>>>, args: FastEventListenerArgs<Meta>) => any | Promise<any>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
+    once<T extends Exclude<string, Types>>(type: T, listener: TypedFastEventAnyListener<MatchEventType<T, AllEvents>, Meta, Fallback<Context, typeof this>>, options?: FastEventListenOptions<AllEvents, Meta>): FastEventSubscriber;
     /**
      * 注册一个监听器，用于监听所有事件
      * @param listener 事件监听器函数，可以接收任意类型的事件数据
@@ -629,6 +719,7 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
     private _traverseToPath;
     private _traverseListeners;
     private _onListenerError;
+    private _setListenerFlags;
     /**
      * 执行单个监听器函数
      * @param listener - 要执行的监听器函数或包装过的监听器对象
@@ -731,16 +822,16 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      */
     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[T] : RecordValues<MatchEventType<T, AllEvents>>, retain?: boolean): R[];
+    emit<R = any, T extends Types = Types>(type: T, payload?: PickPayload<AllEvents[T]>, retain?: boolean): R[];
+    emit<R = any, T extends string = string>(type: T, payload: PickPayload<T extends Types ? AllEvents[T] : RecordValues<MatchEventType<T, AllEvents>>>, retain?: boolean): R[];
     emit<R = any, T extends string = string>(message: FastEventEmitMessage<{
         [K in T]: K extends Types ? AllEvents[K] : any;
     }, Meta>, retain?: boolean): R[];
     emit<R = any>(message: FastEventEmitMessage<AllEvents, Meta>, retain?: boolean): R[];
-    emit<R = any, T extends Types = Types>(type: T, payload?: AllEvents[T], options?: FastEventListenerArgs<Meta>): R[];
-    emit<R = any, T extends string = string>(type: T, payload?: T extends Types ? AllEvents[T] : RecordValues<MatchEventType<T, AllEvents>>, options?: FastEventListenerArgs<Meta>): R[];
+    emit<R = any, T extends Types = Types>(type: T, payload?: PickPayload<AllEvents[T]>, options?: FastEventListenerArgs<Meta>): R[];
+    emit<R = any, T extends string = string>(type: T, payload: PickPayload<T extends Types ? AllEvents[T] : RecordValues<MatchEventType<T, AllEvents>>>, options?: FastEventListenerArgs<Meta>): R[];
     emit<R = any, T extends string = string>(message: FastEventEmitMessage<{
-        [K in T]: K extends Types ? AllEvents[K] : any;
+        [K in T]: PickPayload<K extends Types ? AllEvents[K] : any>;
     }, Meta>, options?: FastEventListenerArgs<Meta>): R[];
     emit<R = any>(message: FastEventEmitMessage<AllEvents, Meta>, options?: FastEventListenerArgs<Meta>): R[];
     /**
@@ -779,16 +870,16 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
      * });
      * ```
      */
-    emitAsync<R = any, T extends Types = Types>(type: T, payload?: AllEvents[T], retain?: boolean): Promise<[R | Error][]>;
-    emitAsync<R = any, T extends string = string>(type: T, payload?: T extends Types ? AllEvents[T] : any, retain?: boolean): Promise<[R | Error][]>;
+    emitAsync<R = any, T extends Types = Types>(type: T, payload?: PickPayload<AllEvents[T]>, retain?: boolean): Promise<[R | Error][]>;
+    emitAsync<R = any, T extends string = string>(type: T, payload?: PickPayload<T extends Types ? AllEvents[T] : any>, retain?: boolean): Promise<[R | Error][]>;
     emitAsync<R = any, T extends string = string>(message: FastEventEmitMessage<{
-        [K in T]: K extends Types ? AllEvents[K] : any;
+        [K in T]: PickPayload<K extends Types ? AllEvents[K] : any>;
     }, Meta>, retain?: boolean): Promise<[R | Error][]>;
     emitAsync<R = any>(message: FastEventEmitMessage<AllEvents, Meta>, retain?: boolean): Promise<[R | Error][]>;
-    emitAsync<R = any, T extends string = string>(type: T, payload?: T extends Types ? AllEvents[T] : any, options?: FastEventListenerArgs<Meta>): Promise<[R | Error][]>;
-    emitAsync<R = any, T extends Types = Types>(type: T, payload?: AllEvents[T], options?: FastEventListenerArgs<Meta>): Promise<[R | Error][]>;
+    emitAsync<R = any, T extends string = string>(type: T, payload?: PickPayload<T extends Types ? AllEvents[T] : any>, options?: FastEventListenerArgs<Meta>): Promise<[R | Error][]>;
+    emitAsync<R = any, T extends Types = Types>(type: T, payload?: PickPayload<AllEvents[T]>, options?: FastEventListenerArgs<Meta>): Promise<[R | Error][]>;
     emitAsync<R = any, T extends string = string>(message: FastEventEmitMessage<{
-        [K in T]: K extends Types ? AllEvents[K] : any;
+        [K in T]: PickPayload<K extends Types ? AllEvents[K] : any>;
     }, Meta>, options?: FastEventListenerArgs<Meta>): Promise<[R | Error][]>;
     emitAsync<R = any>(message: FastEventEmitMessage<AllEvents, Meta>, options?: FastEventListenerArgs<Meta>): Promise<[R | Error][]>;
     /**
@@ -878,7 +969,7 @@ declare class FastEvent<Events extends Record<string, any> = Record<string, any>
 
 type FastEventBusNodeOptions<Meta = Record<string, any>, Context = any> = FastEventOptions<Meta, Context> & {};
 declare class FastEventBusNode<Events extends Record<string, any> = Record<string, any>, Meta extends Record<string, any> = Record<string, any>, Context = never> extends FastEvent<Events, Meta, Context> {
-    eventbus?: FastEventBus<any, any, any>;
+    eventbus?: FastEventBus<any, any, any, any, any>;
     private _subscribers;
     constructor(options?: DeepPartial<FastEventBusNodeOptions<Meta, Context>>);
     /**
@@ -904,7 +995,7 @@ declare class FastEventBusNode<Events extends Record<string, any> = Record<strin
      * 加入事件总线
      * @param eventBus 要加入的事件总线
      */
-    connect(eventbus: FastEventBus<any, any, any>): void;
+    connect<E extends Record<string, any> = Record<string, any>, M extends Record<string, any> = Record<string, any>, C = any>(eventbus: FastEventBus<E, M, C>): void;
     disconnect(): void;
     /**
      *
@@ -1132,4 +1223,4 @@ declare function isClass(target: unknown): target is new (...args: any[]) => any
 
 declare function isFastEvent(target: any): target is FastEvent;
 
-export { AbortError, BroadcastEvent, CancelError, type ChangeFieldType, type DeepPartial, type Dict, type Expand, type Fallback, FastEvent, FastEventBus, type FastEventBusEventTypes, type FastEventBusEvents, type FastEventBusMessage, FastEventBusNode, type FastEventBusNodeIds, type FastEventBusNodeOptions, type FastEventBusNodes, type FastEventBusOptions, FastEventDirectives, type FastEventEmitMessage, FastEventError, type FastEventListenOptions, type FastEventListener, type FastEventListenerArgs, type FastEventListeners, type FastEventMessage, type FastEventMessageExtends, type FastEventMeta, type FastEventOptions, FastEventScope, type FastEventScopeMeta, type FastEventScopeOptions, type FastEventSubscriber, type FastEvents, type FastListenerMeta, type FastListenerNode, type FastListeners, type MatchEventType, type Merge, type MergeUnion, NamespaceDelimiter, NodeDataEvent, type ObjectKeys, type OptionalItems, type Overloads, type OverrideOptions, QueueOverflowError, type RecordPrefix, type RecordValues, type RequiredItems, type ScopeEvents, TimeoutError, type TypedFastEventAnyListener, type TypedFastEventListener, type TypedFastEventMessage, type TypedFastEventMessageOptional, UnboundError, type Union, type Unique, __FastEventScope__, __FastEvent__, __expandable__, expandable, isClass, isExpandable, isFastEvent, isFastEventMessage, isFastEventScope, isFunction, isPathMatched, isString, isSubsctiber };
+export { AbortError, type AssertFastMessage, type AtPayloads, BroadcastEvent, CancelError, type ChangeFieldType, type DeepPartial, type Dict, type Expand, type ExpandWildcard, type Fallback, FastEvent, FastEventBus, type FastEventBusEventTypes, type FastEventBusEvents, type FastEventBusMessage, FastEventBusNode, type FastEventBusNodeIds, type FastEventBusNodeOptions, type FastEventBusNodes, type FastEventBusOptions, FastEventDirectives, type FastEventEmitMessage, FastEventError, type FastEventListenOptions, type FastEventListener, type FastEventListenerArgs, FastEventListenerFlags, type FastEventListeners, type FastEventMessage, type FastEventMessageExtends, type FastEventMeta, type FastEventOptions, FastEventScope, type FastEventScopeMeta, type FastEventScopeOptions, type FastEventSubscriber, type FastEvents, type FastListenerMeta, type FastListenerNode, type FastListeners, type FastMessagePayload, type MatchEventPayload, type MatchEventType, type Merge, type MergeUnion, NamespaceDelimiter, NodeDataEvent, type NotPayload, type ObjectKeys, type OmitTransformedEvents, type OptionalItems, type Overloads, type OverrideOptions, type PickPayload, type PickTransformedEvents, QueueOverflowError, type RecordPrefix, type RecordValues, type RequiredItems, type ScopeEvents, TimeoutError, type TransformedEvents, type TypedFastEventAnyListener, type TypedFastEventListener, type TypedFastEventMessage, type TypedFastEventMessageOptional, UnboundError, type Union, type Unique, __FastEventScope__, __FastEvent__, __expandable__, expandable, isClass, isExpandable, isFastEvent, isFastEventMessage, isFastEventScope, isFunction, isPathMatched, isString, isSubsctiber };