feat(MessageCenter): add off function, let on return a canceller

api-documents/kit.messagecenter.md

@@ -22,13 +22,14 @@ export declare class MessageCenter<ITypedMessages>
 
 |  Property | Modifiers | Type | Description |
 |  --- | --- | --- | --- |
-|  [send](./kit.messagecenter.send.md) |  | <code>&lt;Key_1 extends keyof ITypedMessages&gt;(key: Key_1, data: ITypedMessages[Key_1], alsoSendToDocument?: boolean) =&gt; void</code> |  |
 |  [writeToConsole](./kit.messagecenter.writetoconsole.md) |  | <code>boolean</code> | Should MessageCenter prints all messages to console? |
 
 ## Methods
 
 |  Method | Modifiers | Description |
 |  --- | --- | --- |
 |  [emit(key, data, alsoSendToDocument)](./kit.messagecenter.emit.md) |  | Send message to local or other instance of extension |
+|  [off(event, handler)](./kit.messagecenter.off.md) |  | Remove the listener of an event |
 |  [on(event, handler)](./kit.messagecenter.on.md) |  | Listen to an event |
+|  [send(args)](./kit.messagecenter.send.md) |  | Send message to local or other instance of extension |
 

api-documents/kit.messagecenter.off.md

@@ -0,0 +1,25 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@holoflows/kit](./kit.md) &gt; [MessageCenter](./kit.messagecenter.md) &gt; [off](./kit.messagecenter.off.md)
+
+## MessageCenter.off() method
+
+Remove the listener of an event
+
+<b>Signature:</b>
+
+```typescript
+off<Key extends keyof ITypedMessages>(event: Key, handler: (data: ITypedMessages[Key]) => void): void;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  event | <code>Key</code> | Name of the event |
+|  handler | <code>(data: ITypedMessages[Key]) =&gt; void</code> | Handler of the event |
+
+<b>Returns:</b>
+
+`void`
+

api-documents/kit.messagecenter.on.md

@@ -9,7 +9,7 @@ Listen to an event
 <b>Signature:</b>
 
 ```typescript
-on<Key extends keyof ITypedMessages>(event: Key, handler: (data: ITypedMessages[Key]) => void): void;
+on<Key extends keyof ITypedMessages>(event: Key, handler: (data: ITypedMessages[Key]) => void): () => void;
 ```
 
 ## Parameters
@@ -21,5 +21,7 @@ on<Key extends keyof ITypedMessages>(event: Key, handler: (data: ITypedMessages[
 
 <b>Returns:</b>
 
-`void`
+`() => void`
+
+a function, call it to remove this listener
 

api-documents/kit.messagecenter.send.md

@@ -2,10 +2,23 @@
 
 [Home](./index.md) > [@holoflows/kit](./kit.md) > [MessageCenter](./kit.messagecenter.md) > [send](./kit.messagecenter.send.md)
 
-## MessageCenter.send property
+## MessageCenter.send() method
+
+Send message to local or other instance of extension
 
 <b>Signature:</b>
 
 ```typescript
-send: <Key_1 extends keyof ITypedMessages>(key: Key_1, data: ITypedMessages[Key_1], alsoSendToDocument?: boolean) => void;
+send(...args: Parameters<MessageCenter<ITypedMessages>['emit']>): ReturnType<MessageCenter<ITypedMessages>['emit']>;
 ```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  args | <code>Parameters&lt;MessageCenter&lt;ITypedMessages&gt;['emit']&gt;</code> |  |
+
+<b>Returns:</b>
+
+`ReturnType<MessageCenter<ITypedMessages>['emit']>`
+

doc/holoflows-kit.api.report.md

@@ -155,9 +155,9 @@ export class LiveSelector<T, SingleMode extends boolean = false> {
 export class MessageCenter<ITypedMessages> {
     constructor(instanceKey?: string);
     emit<Key extends keyof ITypedMessages>(key: Key, data: ITypedMessages[Key], alsoSendToDocument?: boolean): void;
-    on<Key extends keyof ITypedMessages>(event: Key, handler: (data: ITypedMessages[Key]) => void): void;
-    // (undocumented)
-    send: <Key_1 extends keyof ITypedMessages>(key: Key_1, data: ITypedMessages[Key_1], alsoSendToDocument?: boolean) => void;
+    off<Key extends keyof ITypedMessages>(event: Key, handler: (data: ITypedMessages[Key]) => void): void;
+    on<Key extends keyof ITypedMessages>(event: Key, handler: (data: ITypedMessages[Key]) => void): () => void;
+    send(...args: Parameters<MessageCenter<ITypedMessages>['emit']>): ReturnType<MessageCenter<ITypedMessages>['emit']>;
     writeToConsole: boolean;
 }
 

src/Extension/MessageCenter.ts

@@ -47,11 +47,20 @@ export class MessageCenter<ITypedMessages> {
      * Listen to an event
      * @param event - Name of the event
      * @param handler - Handler of the event
+     * @returns a function, call it to remove this listener
      */
-    public on<Key extends keyof ITypedMessages>(event: Key, handler: (data: ITypedMessages[Key]) => void): void {
+    public on<Key extends keyof ITypedMessages>(event: Key, handler: (data: ITypedMessages[Key]) => void) {
         this.eventEmitter.on(event as string, handler)
+        return () => this.off(event, handler)
+    }
+    /**
+     * Remove the listener of an event
+     * @param event - Name of the event
+     * @param handler - Handler of the event
+     */
+    public off<Key extends keyof ITypedMessages>(event: Key, handler: (data: ITypedMessages[Key]) => void): void {
+        this.eventEmitter.off(event as string, handler)
     }
-
     /**
      * Send message to local or other instance of extension
      * @param key - Key of the message
@@ -90,7 +99,14 @@ export class MessageCenter<ITypedMessages> {
             document.dispatchEvent(newMessage(key, data))
         }
     }
-    public send = this.emit
+    /**
+     * {@inheritdoc MessageCenter.emit}
+     */
+    public send(
+        ...args: Parameters<MessageCenter<ITypedMessages>['emit']>
+    ): ReturnType<MessageCenter<ITypedMessages>['emit']> {
+        return Reflect.apply(this.emit, this, args)
+    }
     /**
      * Should MessageCenter prints all messages to console?
      */