@virid/renderer 0.3.0 → 0.3.2

package/README.md

@@ -12,18 +12,18 @@ Conversely, messages sent from the main process to the rendering process are abs
 - **Type Restoration**: After passing through the IPC channel, messages are restored into their original **Message** classes before re-entering `@virid/core`. This allows them to be recognized and distributed by the dispatcher, achieving **location transparency** across different processes.
 - **Targeted Messaging & Broadcasting**: You can achieve point-to-point communication using the IDs of other rendering processes, or use `*` to broadcast messages.
 
-------
+---
 
 ## 🔌Enable plugins
 
 ```ts
-import { createVirid } from '@virid/core'
-import { RenderPlugin } from '@virid/renderer'
-const app = createVirid()
+import { createVirid } from "@virid/core";
+import { RenderPlugin } from "@virid/renderer";
+const app = createVirid();
 //Each window needs to be assigned a unique windowId to report to the main process
 app.use(RenderPlugin, {
-  windowId: 'renderer'
-})
+  windowId: "renderer",
+});
 ```
 
 ## 🛠️ @virid/renderer Core API Overview
@@ -33,34 +33,34 @@ app.use(RenderPlugin, {
 - **Function**: A specialized message base class designed for inheritance. All messages inheriting from `ToMainMessage` will be dispatched to other processes.
 - **Logic**: This message type requires two specific metadata tags:
   - `__virid_target`: Defines the destination.
-  - `__virid_messageType`: Defines the message type it should be restored to upon reaching the destination.
+  - `__virid_message_type`: Defines the message type it should be restored to upon reaching the destination.
 - Example
 
 **In the Rendering Process:**
 
 ```ts
-import { ToMainMessage } from '@virid/renderer'
+import { ToMainMessage } from "@virid/renderer";
 
 /**
  * - __virid_target = 'main': Indicates the message is bound for the Main Process.
  * - If __virid_target = '*': The message will be broadcast to all rendering processes.
- * - __virid_messageType: Describes the class type the message will transform back into 
+ * - __virid_message_type: Describes the class type the message will transform back into
  * once it arrives at the Main Process.
  */
 
 export class CloseWindowMessage extends ToMainMessage {
-  __virid_target = 'main'
-  __virid_messageType: string = 'close-window'
+  __virid_target = "main";
+  __virid_message_type: string = "close-window";
 }
 
 export class MinimizeWindowMessage extends ToMainMessage {
-  __virid_target = 'main'
-  __virid_messageType: string = 'minimize-window'
+  __virid_target = "main";
+  __virid_message_type: string = "minimize-window";
 }
 
 export class MaximizeWindowMessage extends ToMainMessage {
-  __virid_target = 'main'
-  __virid_messageType: string = 'maximize-window'
+  __virid_target = "main";
+  __virid_message_type: string = "maximize-window";
 }
 ```
 
@@ -69,16 +69,16 @@ In the **Main Process**, you can use the `@FromRenderer` decorator in conjunctio
 **In the Main Process:**
 
 ```ts
-import { FromRendererMessage, FromRenderer } from '@virid/main'
+import { FromRendererMessage, FromRenderer } from "@virid/main";
 
-// Each ID here maps to the __virid_messageType defined in the rendering process
-@FromRenderer('close-window')
+// Each ID here maps to the __virid_message_type defined in the rendering process
+@FromRenderer("close-window")
 export class CloseWindowMessage extends FromRendererMessage {}
 
-@FromRenderer('minimize-window')
+@FromRenderer("minimize-window")
 export class MinimizeWindowMessage extends FromRendererMessage {}
 
-@FromRenderer('maximize-window')
+@FromRenderer("maximize-window")
 export class MaximizeWindowMessage extends FromRendererMessage {}
 
 /**
@@ -88,20 +88,24 @@ export class MaximizeWindowMessage extends FromRendererMessage {}
 export class WindowSystem {
   @System()
   closeWindow(@Message(CloseWindowMessage) message: CloseWindowMessage) {
-    message.senderWindow.close()
+    message.senderWindow.close();
   }
 
   @System()
-  minimizeWindow(@Message(MinimizeWindowMessage) message: MinimizeWindowMessage) {
-    message.senderWindow.minimize()
+  minimizeWindow(
+    @Message(MinimizeWindowMessage) message: MinimizeWindowMessage,
+  ) {
+    message.senderWindow.minimize();
   }
 
   @System()
-  maximizeWindow(@Message(MaximizeWindowMessage) message: MaximizeWindowMessage) {
+  maximizeWindow(
+    @Message(MaximizeWindowMessage) message: MaximizeWindowMessage,
+  ) {
     if (message.senderWindow.isMaximized()) {
-      message.senderWindow.unmaximize()
+      message.senderWindow.unmaximize();
     } else {
-      message.senderWindow.maximize()
+      message.senderWindow.maximize();
     }
   }
 }
@@ -110,36 +114,38 @@ export class WindowSystem {
 ### FromMainMessage / @FromIpc()
 
 - **Function**: A specialized message base class for inheritance. Any message inheriting from `FromMainMessage` is automatically converted and dispatched to the current process's **Virid Dispatcher** when sent from the Main Process.
-- **Logic**: The `@FromIpc()` decorator accepts a string-based ID. This ID must match the `__virid_messageType` of the `ToRendererMessage` sent from the Main Process.
+- **Logic**: The `@FromIpc()` decorator accepts a string-based ID. This ID must match the `__virid_message_type` of the `ToRendererMessage` sent from the Main Process.
 
 - Example:
 
 **In the Rendering Process:**
 
 ```ts
-import { FromIpc, FromMainMessage, ToMainMessage } from '@virid/renderer'
+import { FromIpc, FromMainMessage, ToMainMessage } from "@virid/renderer";
 
 // This class handles the incoming file path from the Main Process
-@FromIpc('file-dialog')
+@FromIpc("file-dialog")
 class ChooseBgImageMessage extends FromMainMessage {
   constructor(public path: string) {
-    super()
+    super();
   }
 }
 
 // This class initiates the request to the Main Process
 class OpenDialogMessage extends ToMainMessage {
-  __virid_target: string = 'main'
-  __virid_messageType: string = 'open-dialog'
-  
+  __virid_target: string = "main";
+  __virid_message_type: string = "open-dialog";
+
   constructor(
     public options: {
-      title?: string
-      filters?: Array<{ name: string; extensions: string[] }>
-      properties?: Array<'openFile' | 'openDirectory' | 'multiSelections' | 'showHiddenFiles'>
-    }
+      title?: string;
+      filters?: Array<{ name: string; extensions: string[] }>;
+      properties?: Array<
+        "openFile" | "openDirectory" | "multiSelections" | "showHiddenFiles"
+      >;
+    },
   ) {
-    super()
+    super();
   }
 }
 ```
@@ -149,36 +155,42 @@ In the **Main Process**, you use `@FromRenderer` and `FromRendererMessage` to ha
 **In the Main Process:**
 
 ```ts
-import { FromRendererMessage, FromRenderer, ToRendererMessage } from '@virid/main'
+import {
+  FromRendererMessage,
+  FromRenderer,
+  ToRendererMessage,
+} from "@virid/main";
 
 /**
- * @FromRenderer('open-dialog') ensures that when the Rendering Process 
- * dispatches an OpenDialogMessage, the Main Process's corresponding 
+ * @FromRenderer('open-dialog') ensures that when the Rendering Process
+ * dispatches an OpenDialogMessage, the Main Process's corresponding
  * System will be triggered automatically.
  */
-@FromRenderer('open-dialog')
+@FromRenderer("open-dialog")
 export class OpenDialogMessage extends FromRendererMessage {
   constructor(
     public options: {
-      title?: string
-      filters?: Array<{ name: string; extensions: string[] }>
-      properties?: Array<'openFile' | 'openDirectory' | 'multiSelections' | 'showHiddenFiles'>
-    }
+      title?: string;
+      filters?: Array<{ name: string; extensions: string[] }>;
+      properties?: Array<
+        "openFile" | "openDirectory" | "multiSelections" | "showHiddenFiles"
+      >;
+    },
   ) {
-    super()
+    super();
   }
 }
 
 /**
  * RenderDialogMessage is used to send the result back.
  * - __virid_target = 'renderer' routes it back to the UI.
- * - __virid_messageType = 'file-dialog' maps it to ChooseBgImageMessage in the renderer.
+ * - __virid_message_type = 'file-dialog' maps it to ChooseBgImageMessage in the renderer.
  */
 export class RenderDialogMessage extends ToRendererMessage {
-  __virid_target: string = 'renderer'
-  __virid_messageType: string = 'file-dialog'
+  __virid_target: string = "renderer";
+  __virid_message_type: string = "file-dialog";
   constructor(public path: string) {
-    super()
+    super();
   }
 }
 
@@ -186,14 +198,17 @@ export class WindowSystem {
   @System()
   async openDialog(@Message(OpenDialogMessage) message: OpenDialogMessage) {
     // Invoke the native Electron dialog
-    const result = await dialog.showOpenDialog(message.senderWindow, message.options)
+    const result = await dialog.showOpenDialog(
+      message.senderWindow,
+      message.options,
+    );
 
     // If the user didn't cancel and selected a file, return the result message
     if (!result.canceled && result.filePaths.length > 0) {
-      const selectedPath = result.filePaths[0]
-      return new RenderDialogMessage(selectedPath)
+      const selectedPath = result.filePaths[0];
+      return new RenderDialogMessage(selectedPath);
     }
-    return
+    return;
   }
 }
-```
+```

package/README.zh.md

@@ -1,4 +1,4 @@
-#  @virid/renderer
+# @virid/renderer
 
 `@virid/renderer` 是electron应用的渲染进程适配器，提供`ToMainMessage`和`FromMainMessage`的自动路由功能与主进程报道功能。
 
@@ -8,18 +8,18 @@
 
 - **路由自动注册**：渲染进程窗口开启后，自动向主进程注册自身，以后所有的消息都将携带自身的窗口信息。
 - **类型恢复**：消息在通过IPC通道后，恢复成真正的Message类重新进入`@virid/core`并被调度器识别并分发。实现不同进程的位置无关性。
-- **消息定向与广播**：可以通过其他渲染进程的ID来实现定向通信，或者使用*来广播消息。
+- **消息定向与广播**：可以通过其他渲染进程的ID来实现定向通信，或者使用\*来广播消息。
 
 ## 🔌启用插件
 
 ```ts
-import { createVirid } from '@virid/core'
-import { RenderPlugin } from '@virid/renderer'
-const app = createVirid()
+import { createVirid } from "@virid/core";
+import { RenderPlugin } from "@virid/renderer";
+const app = createVirid();
 //需要给每个窗口指定一个唯一的windowId来向主进程报道
 app.use(RenderPlugin, {
-  windowId: 'renderer'
-})
+  windowId: "renderer",
+});
 ```
 
 ## 🛠️ @virid/renderer 核心 API 概览
@@ -27,27 +27,27 @@ app.use(RenderPlugin, {
 ### `ToMainMessage`
 
 - **功能**：一个特殊的消息基类，可被继承。所有继承自`ToMainMessage`的Message将被发往其他进程
-- **逻辑**：该消息类型需要两个特殊标记，`__virid_target`标记了目的地，`__virid_messageType`标记了在目的地应该被还原为的Message类型
+- **逻辑**：该消息类型需要两个特殊标记，`__virid_target`标记了目的地，`__virid_message_type`标记了在目的地应该被还原为的Message类型
 - **示例**：
 
 ```ts
 //在渲染进程
-import { ToMainMessage } from '@virid/renderer'
+import { ToMainMessage } from "@virid/renderer";
 // __virid_target=‘main’,说明消息需要发往主进程
 // 当指定__virid_target=‘*’时，消息将会对所有渲染进程广播
-// __virid_messageType: string = 'close-window'，描述了在主进程，该消息将会重新变为的类型
+// __virid_message_type: string = 'close-window'，描述了在主进程，该消息将会重新变为的类型
 
 export class CloseWindowMessage extends ToMainMessage {
-  __virid_target = 'main'
-  __virid_messageType: string = 'close-window'
+  __virid_target = "main";
+  __virid_message_type: string = "close-window";
 }
 export class MinimizeWindowMessage extends ToMainMessage {
-  __virid_target = 'main'
-  __virid_messageType: string = 'minimize-window'
+  __virid_target = "main";
+  __virid_message_type: string = "minimize-window";
 }
 export class MaximizeWindowMessage extends ToMainMessage {
-  __virid_target = 'main'
-  __virid_messageType: string = 'maximize-window'
+  __virid_target = "main";
+  __virid_message_type: string = "maximize-window";
 }
 ```
 
@@ -55,13 +55,13 @@ export class MaximizeWindowMessage extends ToMainMessage {
 
 ```ts
 //在主进程
-import { FromRenderMessage, FromRenderer, ToRenderMessage } from '@virid/main'
+import { FromRenderMessage, FromRenderer, ToRenderMessage } from "@virid/main";
 //这里的每个id都和渲染进程的消息对应
-@FromRenderer('close-window')
+@FromRenderer("close-window")
 export class CloseWindowMessage extends FromRendererMessage {}
-@FromRenderer('minimize-window')
+@FromRenderer("minimize-window")
 export class MinimizeWindowMessage extends FromRendererMessage {}
-@FromRenderer('maximize-window')
+@FromRenderer("maximize-window")
 export class MaximizeWindowMessage extends FromRendererMessage {}
 
 // 通过这三个System，可以实现所有窗口的最小化、最大化、关闭功能
@@ -69,18 +69,22 @@ export class MaximizeWindowMessage extends FromRendererMessage {}
 export class WindowSystem {
   @System()
   closeWindow(@Message(CloseWindowMessage) message: CloseWindowMessage) {
-    message.senderWindow.close()
+    message.senderWindow.close();
   }
   @System()
-  minimizeWindow(@Message(MinimizeWindowMessage) message: MinimizeWindowMessage) {
-    message.senderWindow.minimize()
+  minimizeWindow(
+    @Message(MinimizeWindowMessage) message: MinimizeWindowMessage,
+  ) {
+    message.senderWindow.minimize();
   }
   @System()
-  maximizeWindow(@Message(MaximizeWindowMessage) message: MaximizeWindowMessage) {
+  maximizeWindow(
+    @Message(MaximizeWindowMessage) message: MaximizeWindowMessage,
+  ) {
     if (message.senderWindow.isMaximized()) {
-      message.senderWindow.unmaximize()
+      message.senderWindow.unmaximize();
     } else {
-      message.senderWindow.maximize()
+      message.senderWindow.maximize();
     }
   }
 }
@@ -94,26 +98,28 @@ export class WindowSystem {
 
 ```ts
 //在渲染进程
-import { FromIpc, FromMainMessage, ToMainMessage } from '@virid/renderer'
+import { FromIpc, FromMainMessage, ToMainMessage } from "@virid/renderer";
 
-@FromIpc('file-dialog')
+@FromIpc("file-dialog")
 class ChooseBgImageMessage extends FromMainMessage {
   constructor(public path: string) {
-    super()
+    super();
   }
 }
 
 class OpenDialogMessage extends ToMainMessage {
-  __virid_target: string = 'main'
-  __virid_messageType: string = 'open-dialog'
+  __virid_target: string = "main";
+  __virid_message_type: string = "open-dialog";
   constructor(
     public options: {
-      title?: string
-      filters?: Array<{ name: string; extensions: string[] }>
-      properties?: Array<'openFile' | 'openDirectory' | 'multiSelections' | 'showHiddenFiles'>
-    }
+      title?: string;
+      filters?: Array<{ name: string; extensions: string[] }>;
+      properties?: Array<
+        "openFile" | "openDirectory" | "multiSelections" | "showHiddenFiles"
+      >;
+    },
   ) {
-    super()
+    super();
   }
 }
 ```
@@ -122,31 +128,37 @@ class OpenDialogMessage extends ToMainMessage {
 
 ```ts
 //在主进程
-import { FromRendererMessage, FromRenderer, ToRenderMessage } from '@virid/main'
+import {
+  FromRendererMessage,
+  FromRenderer,
+  ToRenderMessage,
+} from "@virid/main";
 
 // @FromRender('open-dialog')表明，当上面的渲染进程调用OpenDialogMessage.send(options)时
 // 主进程的OpenDialogMessage将被自动投递，因此下面的openDialog System将被virid自动调用
 // 当openDialog执行完毕，将返回一个RenderDialogMessage，该RenderDialogMessage标记了目的地与类型
 // 其会转换为渲染进程的OpenDialogMessage并触发渲染进程的System或者Listener执行
 
-@FromRenderer('open-dialog')
+@FromRenderer("open-dialog")
 export class OpenDialogMessage extends FromRendererMessage {
   constructor(
     public options: {
-      title?: string
-      filters?: Array<{ name: string; extensions: string[] }>
-      properties?: Array<'openFile' | 'openDirectory' | 'multiSelections' | 'showHiddenFiles'>
-    }
+      title?: string;
+      filters?: Array<{ name: string; extensions: string[] }>;
+      properties?: Array<
+        "openFile" | "openDirectory" | "multiSelections" | "showHiddenFiles"
+      >;
+    },
   ) {
-    super()
+    super();
   }
 }
 
 export class RenderDialogMessage extends ToRendererMessage {
-  __virid_target: string = 'renderer'
-  __virid_messageType: string = 'file-dialog'
+  __virid_target: string = "renderer";
+  __virid_message_type: string = "file-dialog";
   constructor(public path: string) {
-    super()
+    super();
   }
 }
 
@@ -154,16 +166,16 @@ export class WindowSystem {
   @System()
   async openDialog(@Message(OpenDialogMessage) message: OpenDialogMessage) {
     // 调用原生对话框
-    const result = await dialog.showOpenDialog(message.senderWindow, message.options)
+    const result = await dialog.showOpenDialog(
+      message.senderWindow,
+      message.options,
+    );
     // 如果用户没有取消，并且确实选择了文件
     if (!result.canceled && result.filePaths.length > 0) {
-      const selectedPath = result.filePaths[0]
-      return new RenderDialogMessage(selectedPath)
+      const selectedPath = result.filePaths[0];
+      return new RenderDialogMessage(selectedPath);
     }
-    return
+    return;
   }
 }
 ```
-
-
-

package/dist/index.cjs

@@ -1,10 +1,9 @@
 /**
- *  @virid/renderer v0.3.0
+ *  @virid/renderer v0.3.2
  *  Electron renderer process adapter for virid, responsible for forwarding and receiving messages from the main process
  */
-var a=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var D=Object.getOwnPropertyNames;var T=Object.prototype.hasOwnProperty;var V=(e,r,i)=>r in e?a(e,r,{enumerable:!0,configurable:!0,writable:!0,value:i}):e[r]=i;var _=(e,r)=>a(e,"name",{value:r,configurable:!0});var $=(e,r)=>{for(var i in r)a(e,i,{get:r[i],enumerable:!0})},A=(e,r,i,o)=>{if(r&&typeof r=="object"||typeof r=="function")for(let t of D(r))!T.call(e,t)&&t!==i&&a(e,t,{get:()=>r[t],enumerable:!(o=y(r,t))||o.enumerable});return e};var G=e=>A(a({},"__esModule",{value:!0}),e);var n=(e,r,i)=>V(e,typeof r!="symbol"?r+"":r,i);var W={};$(W,{FromMain:()=>h,FromMainMessage:()=>c,RenderPluginClass:()=>u,ToMainMessage:()=>d,convertFromMainMessage:()=>I,middleWare:()=>g});module.exports=G(W);var v=require("@virid/core");var f=class f extends v.EventMessage{constructor(){super(...arguments);n(this,"__virid_source","unknown");n(this,"__virid_target","");n(this,"__virid_messageType","")}};_(f,"FromMainMessage");var c=f,w=class w extends v.EventMessage{};_(w,"ToMainMessage"),n(w,"__virid_source");var d=w;var x=require("@virid/core");var g=_((e,r)=>{if(e instanceof d){let{__virid_target:i,__virid_messageType:o,...t}=e;if(i==d.__virid_source){x.MessageWriter.warn(`[Virid Render] Prohibit Sending To Oneself: ${i} is not allowed in ToRenderMessage.`);return}window.__VIRID_BRIDGE__.post({__virid_source:d.__virid_source,__virid_target:i,__virid_messageType:o,payload:t})}else r()},"middleWare");var p=require("@virid/core");var m=new Map;function h(e){return function(r){m.has(e)&&p.MessageWriter.error(new Error(`[Virid Main] Duplicate IpcMessage: Registration for type: ${e}`)),m.set(e,r)}}_(h,"FromMain");function I(e){let{__virid_source:r,__virid_target:i,__virid_messageType:o,payload:t}=e;if(!o||!r||!i){p.MessageWriter.error(new Error(`[Virid Render] Incomplete Data:
+var m=Object.defineProperty;var M=Object.getOwnPropertyDescriptor;var A=Object.getOwnPropertyNames;var V=Object.prototype.hasOwnProperty;var x=(i,e,r)=>e in i?m(i,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):i[e]=r;var t=(i,e)=>m(i,"name",{value:e,configurable:!0});var y=(i,e)=>{for(var r in e)m(i,r,{get:e[r],enumerable:!0})},T=(i,e,r,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let _ of A(e))!V.call(i,_)&&_!==r&&m(i,_,{get:()=>e[_],enumerable:!(s=M(e,_))||s.enumerable});return i};var h=i=>T(m({},"__esModule",{value:!0}),i);var d=(i,e,r)=>x(i,typeof e!="symbol"?e+"":e,r);var $={};y($,{FromMain:()=>N,FromMainMessage:()=>R,RenderPlugin:()=>v,ToMainMessage:()=>o,middleWare:()=>f});module.exports=h($);var a=require("@virid/core");var I=require("@virid/core");var w=class w extends I.EventMessage{constructor(){super(...arguments);d(this,"__virid_source","unknown");d(this,"__virid_target","");d(this,"__virid_message_type","")}};t(w,"FromMainMessage");var R=w,p=class p extends I.EventMessage{};t(p,"ToMainMessage"),d(p,"__virid_source");var o=p;var E=require("@virid/core");var f=t((i,e)=>{if(i instanceof o){let{__virid_target:r,__virid_message_type:s,..._}=i;if(r==o.__virid_source){E.MessageWriter.warn(`[Virid Render] Prohibit Sending To Oneself: ${r} is not allowed in ToRenderMessage.`);return}window.__VIRID_BRIDGE__.post({__virid_source:o.__virid_source,__virid_target:r,__virid_message_type:s,payload:_})}else e()},"middleWare");var D=require("@virid/core"),c={...D.VIRID_METADATA,FROMMAIN:"virid:renderer:frommain"};function N(i){return function(e){Reflect.defineMetadata(c.FROMMAIN,i,e)}}t(N,"FromMain");var g=class g{constructor(){d(this,"name","@virid/render");d(this,"message_map",new Map)}install(e,r){window.__VIRID_BRIDGE__||a.MessageWriter.error(new Error("[Virid Render] Preloading Failed: Please initialize in the preloaded script first.")),r?.windowId||a.MessageWriter.error(new Error(`[Virid Render] Activate Failed: Please provide the windowId:${r?.windowId}.`)),o.__virid_source=r.windowId,window.__VIRID_BRIDGE__.post({__virid_source:r.windowId,__virid_target:"main",__virid_message_type:"VIRID_INTERNAL_REGISTER",payload:{windowId:r.windowId}}),window.__VIRID_BRIDGE__.subscribe(this.convertFromMainMessage),e.useMiddleware(f)}bindRoute(e){let r=Reflect.getMetadata(c.FROMMAIN,e);this.message_map.has(r)&&a.MessageWriter.error(new Error(`[Virid Renderer] Duplicate IpcMessage: Registration for route: ${r}, message class: ${e}`)),this.message_map.set(r,e)}convertFromMainMessage(e){let{__virid_source:r,__virid_target:s,__virid_message_type:_,payload:l}=e;if(!_||!r||!s){a.MessageWriter.error(new Error(`[Virid Render] Incomplete Data:
 __virid_source: ${r}
-__virid_target:${i}
-__virid_messageType: ${o}.`));return}if(!m.has(o)){p.MessageWriter.error(new Error(`[Virid Render] Unregistered type: ${o} `));return}let M=m.get(o),s=new M;s.__virid_source=r,s.__virid_target=i,s.__virid_messageType=o,t&&Object.assign(s,t),p.MessageWriter.write(s)}_(I,"convertFromMainMessage");var l=require("@virid/core");function E(e,r){window.__VIRID_BRIDGE__||l.MessageWriter.error(new Error("[Virid Render] Preloading Failed: Please initialize in the preloaded script first.")),r?.windowId||l.MessageWriter.error(new Error(`[Virid Render] Activate Failed:
-Please provide the windowId:${r?.windowId}.`)),d.__virid_source=r.windowId,window.__VIRID_BRIDGE__.post({__virid_source:r.windowId,__virid_target:"main",__virid_messageType:"VIRID_INTERNAL_REGISTER",payload:{windowId:r.windowId}}),window.__VIRID_BRIDGE__.subscribe(I),e.useMiddleware(g)}_(E,"activateApp");var R=class R{constructor(){n(this,"name","@virid/render")}install(r,i){E(r,i)}};_(R,"RenderPluginClass");var u=R;0&&(module.exports={FromMain,FromMainMessage,RenderPluginClass,ToMainMessage,convertFromMainMessage,middleWare});
+__virid_target:${s}
+__virid_message_type: ${_}.`));return}if(!this.message_map.has(_)){a.MessageWriter.error(new Error(`[Virid Render] Unregistered type: ${_} `));return}let u=this.message_map.get(_),n=new u;n.__virid_source=r,n.__virid_target=s,n.__virid_message_type=_,l&&Object.assign(n,l),a.MessageWriter.write(n)}};t(g,"RenderPlugin");var v=g;0&&(module.exports={FromMain,FromMainMessage,RenderPlugin,ToMainMessage,middleWare});
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/renderer/message.ts","../src/renderer/middleware.ts","../src/renderer/router.ts","../src/app.ts"],"sourcesContent":["/*\n * Copyright (c) 2026-present Ailrid\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n * Description: Electron renderer process adapter for virid, responsible for forwarding and receiving messages from the main process.\n */\nimport { ViridPlugin, type ViridApp } from \"@virid/core\";\nexport { ToMainMessage, FromMainMessage } from \"./renderer\";\nexport * from \"./interfaces\";\nexport * from \"./renderer\";\nimport { activateApp } from \"./app\";\nimport { type PluginOption } from \"./interfaces\";\n\nexport class RenderPluginClass implements ViridPlugin<PluginOption> {\n  name = \"@virid/render\";\n  install(app: ViridApp, options: PluginOption) {\n    activateApp(app, options);\n  }\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\nimport { EventMessage } from \"@virid/core\";\n/**\n * RenderMessage: Message sent by the main process\n */\nexport abstract class FromMainMessage extends EventMessage {\n  /** Where am I from?\n   */\n  public __virid_source: string = \"unknown\";\n  /**Where is my destination?\n   *'main ': Sent to the main process for processing\n   *'all': Broadcast to all windows (relayed through the main process)\n   *String: Specify the ID of a window (windowId)\n   */\n  public __virid_target: string = \"\";\n  /**\n   *What message should I turn into at the destination?\n   */\n  public __virid_messageType: string = \"\";\n}\n\n/**\n *RenderMessage: Initiated by the rendering process, targeting the main process or other windows\n */\nexport abstract class ToMainMessage extends EventMessage {\n  /**Where am I from?\n   */\n  public static __virid_source: string;\n\n  /**Where is my destination?\n   *'main ': Sent to the main process for processing\n   *'all': Broadcast to all windows (relayed through the main process)\n   *String: Specify the ID of a window (windowId)\n   */\n  public abstract __virid_target: string;\n\n  /**\n   *What message should I turn into at the destination?\n   */\n  public abstract __virid_messageType: string;\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\nimport { type Middleware, MessageWriter } from \"@virid/core\";\nimport { ToMainMessage } from \"./message\";\nexport const middleWare: Middleware = (message, next) => {\n  // If the message inherits from ToMainMessage, intercept concurrency to the main process\n  if (message instanceof ToMainMessage) {\n    const { __virid_target, __virid_messageType, ...payload } = message;\n    if (__virid_target == ToMainMessage.__virid_source) {\n      MessageWriter.warn(\n        `[Virid Render] Prohibit Sending To Oneself: ${__virid_target} is not allowed in ToRenderMessage.`,\n      );\n      return;\n    }\n    window.__VIRID_BRIDGE__.post({\n      __virid_source: ToMainMessage.__virid_source,\n      __virid_target: __virid_target,\n      __virid_messageType: __virid_messageType,\n      payload: payload, // Expand all attributes on the instance\n    });\n  } else {\n    next();\n  }\n};\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\nimport { MessageWriter, Newable } from \"@virid/core\";\nimport { type FromMainMessage } from \"./message\";\nconst MESSAGE_MAP = new Map<string, Newable<FromMainMessage>>();\n\nexport function FromMain(type: string) {\n  return function (target: Newable<FromMainMessage>) {\n    if (MESSAGE_MAP.has(type)) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] Duplicate IpcMessage: Registration for type: ${type}`,\n        ),\n      );\n    }\n    MESSAGE_MAP.set(type, target);\n  };\n}\nexport function convertFromMainMessage(ipcMessage: any): void {\n  const { __virid_source, __virid_target, __virid_messageType, payload } =\n    ipcMessage;\n  if (!__virid_messageType || !__virid_source || !__virid_target) {\n    MessageWriter.error(\n      new Error(\n        `[Virid Render] Incomplete Data:\\n__virid_source: ${__virid_source}\\n__virid_target:${__virid_target}\\n__virid_messageType: ${__virid_messageType}.`,\n      ),\n    );\n    return;\n  }\n  if (!MESSAGE_MAP.has(__virid_messageType)) {\n    MessageWriter.error(\n      new Error(`[Virid Render] Unregistered type: ${__virid_messageType} `),\n    );\n    return;\n  }\n  // Find the corresponding constructor\n  const MessageClass = MESSAGE_MAP.get(__virid_messageType)!;\n  // Instantiate and inject parameters\n  const instance = new MessageClass();\n\n  // Explicitly assigning base class identifiers to ensure complete identity information of instances\n  instance.__virid_source = __virid_source;\n  instance.__virid_target = __virid_target;\n  instance.__virid_messageType = __virid_messageType;\n\n  // Restore data\n  if (payload) {\n    Object.assign(instance, payload);\n  }\n\n  // Redistribution\n  MessageWriter.write(instance);\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\n\nimport { MessageWriter, type ViridApp } from \"@virid/core\";\nimport { middleWare, convertFromMainMessage, ToMainMessage } from \"./renderer\";\nimport { type PluginOption } from \"./interfaces\";\nexport function activateApp(app: ViridApp, options: PluginOption) {\n  // first, check if the preload script has been loaded\n  if (!window.__VIRID_BRIDGE__) {\n    MessageWriter.error(\n      new Error(\n        `[Virid Render] Preloading Failed: Please initialize in the preloaded script first.`,\n      ),\n    );\n  }\n  // check whether parameters are passed\n  if (!options?.windowId) {\n    MessageWriter.error(\n      new Error(\n        `[Virid Render] Activate Failed:\\nPlease provide the windowId:${options?.windowId}.`,\n      ),\n    );\n  }\n  // register your own id, so that all messages sent to the main process will carry your own id in the future\n  ToMainMessage.__virid_source = options.windowId;\n  // actively send a registration message to the main process to register itself\n  window.__VIRID_BRIDGE__.post({\n    __virid_source: options.windowId,\n    __virid_target: \"main\",\n    __virid_messageType: \"VIRID_INTERNAL_REGISTER\",\n    payload: {\n      windowId: options.windowId,\n    },\n  });\n  // Subscribe to the ipc channel, and convert all returned messages into our own message types according to the registry\n  window.__VIRID_BRIDGE__.subscribe(convertFromMainMessage);\n  // register your own middleware function to intercept messages of type ToMainMessage and forward them to the main process of electron\n  app.useMiddleware(middleWare);\n}\n"],"mappings":"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","names":["index_exports","__export","FromMain","FromMainMessage","RenderPluginClass","ToMainMessage","convertFromMainMessage","middleWare","__toCommonJS","import_core","FromMainMessage","EventMessage","__virid_source","__virid_target","__virid_messageType","_FromMainMessage","ToMainMessage","__publicField","_ToMainMessage","import_core","middleWare","__name","message","next","ToMainMessage","__virid_target","__virid_messageType","payload","__virid_source","MessageWriter","warn","window","__VIRID_BRIDGE__","post","import_core","MESSAGE_MAP","Map","FromMain","type","target","has","MessageWriter","error","Error","set","convertFromMainMessage","ipcMessage","__virid_source","__virid_target","__virid_messageType","payload","MessageClass","get","instance","Object","assign","write","import_core","activateApp","app","options","window","__VIRID_BRIDGE__","MessageWriter","error","Error","windowId","ToMainMessage","__virid_source","post","__virid_target","__virid_messageType","payload","subscribe","convertFromMainMessage","useMiddleware","middleWare","RenderPluginClass","name","install","app","options","activateApp","_RenderPluginClass"]}
+{"version":3,"sources":["../src/index.ts","../src/renderer/message.ts","../src/renderer/middleware.ts","../src/renderer/constant.ts","../src/renderer/decorator.ts"],"sourcesContent":["/*\n * Copyright (c) 2026-present Ailrid\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n * Description: Electron renderer process adapter for virid, responsible for forwarding and receiving messages from the main process.\n */\nimport {\n  MessageWriter,\n  Newable,\n  ViridPlugin,\n  type ViridApp,\n} from \"@virid/core\";\nimport { type PluginOption } from \"./interfaces\";\nimport { FromMainMessage } from \"./renderer\";\nimport { middleWare, ToMainMessage } from \"./renderer\";\nimport { VIRID_RENDERER_METADATA } from \"./renderer/constant\";\n\nexport * from \"./interfaces\";\nexport * from \"./renderer\";\n\nexport class RenderPlugin implements ViridPlugin<PluginOption> {\n  name = \"@virid/render\";\n  public message_map = new Map<string, Newable<FromMainMessage>>();\n\n  install(app: ViridApp, options: PluginOption) {\n    // first, check if the preload script has been loaded\n    if (!window.__VIRID_BRIDGE__) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Render] Preloading Failed: Please initialize in the preloaded script first.`,\n        ),\n      );\n    }\n    // check whether parameters are passed\n    if (!options?.windowId) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Render] Activate Failed: Please provide the windowId:${options?.windowId}.`,\n        ),\n      );\n    }\n    // register your own id, so that all messages sent to the main process will carry your own id in the future\n    ToMainMessage.__virid_source = options.windowId;\n    // actively send a registration message to the main process to register itself\n    window.__VIRID_BRIDGE__.post({\n      __virid_source: options.windowId,\n      __virid_target: \"main\",\n      __virid_message_type: \"VIRID_INTERNAL_REGISTER\",\n      payload: {\n        windowId: options.windowId,\n      },\n    });\n    // Subscribe to the ipc channel, and convert all returned messages into our own message types according to the registry\n    window.__VIRID_BRIDGE__.subscribe(this.convertFromMainMessage);\n    // register your own middleware function to intercept messages of type ToMainMessage and forward them to the main process of electron\n    app.useMiddleware(middleWare);\n  }\n  bindRoute(target: Newable<FromMainMessage>) {\n    const route = Reflect.getMetadata(VIRID_RENDERER_METADATA.FROMMAIN, target);\n    if (this.message_map.has(route)) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Renderer] Duplicate IpcMessage: Registration for route: ${route}, message class: ${target}`,\n        ),\n      );\n    }\n    this.message_map.set(route, target);\n  }\n\n  convertFromMainMessage(ipcMessage: any): void {\n    const { __virid_source, __virid_target, __virid_message_type, payload } =\n      ipcMessage;\n    if (!__virid_message_type || !__virid_source || !__virid_target) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Render] Incomplete Data:\\n__virid_source: ${__virid_source}\\n__virid_target:${__virid_target}\\n__virid_message_type: ${__virid_message_type}.`,\n        ),\n      );\n      return;\n    }\n    if (!this.message_map.has(__virid_message_type)) {\n      MessageWriter.error(\n        new Error(`[Virid Render] Unregistered type: ${__virid_message_type} `),\n      );\n      return;\n    }\n    // Find the corresponding constructor\n    const MessageClass = this.message_map.get(__virid_message_type)!;\n    // Instantiate and inject parameters\n    const instance = new MessageClass();\n\n    // Explicitly assigning base class identifiers to ensure complete identity information of instances\n    instance.__virid_source = __virid_source;\n    instance.__virid_target = __virid_target;\n    instance.__virid_message_type = __virid_message_type;\n\n    // Restore data\n    if (payload) {\n      Object.assign(instance, payload);\n    }\n\n    // Redistribution\n    MessageWriter.write(instance);\n  }\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\nimport { EventMessage } from \"@virid/core\";\n/**\n * RenderMessage: Message sent by the main process\n */\nexport abstract class FromMainMessage extends EventMessage {\n  /** Where am I from?\n   */\n  public __virid_source: string = \"unknown\";\n  /**Where is my destination?\n   *'main ': Sent to the main process for processing\n   *'all': Broadcast to all windows (relayed through the main process)\n   *String: Specify the ID of a window (windowId)\n   */\n  public __virid_target: string = \"\";\n  /**\n   *What message should I turn into at the destination?\n   */\n  public __virid_message_type: string = \"\";\n}\n\n/**\n *RenderMessage: Initiated by the rendering process, targeting the main process or other windows\n */\nexport abstract class ToMainMessage extends EventMessage {\n  /**Where am I from?\n   */\n  public static __virid_source: string;\n\n  /**Where is my destination?\n   *'main ': Sent to the main process for processing\n   *'all': Broadcast to all windows (relayed through the main process)\n   *String: Specify the ID of a window (windowId)\n   */\n  public abstract __virid_target: string;\n\n  /**\n   *What message should I turn into at the destination?\n   */\n  public abstract __virid_message_type: string;\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\nimport { type Middleware, MessageWriter } from \"@virid/core\";\nimport { ToMainMessage } from \"./message\";\nexport const middleWare: Middleware = (message, next) => {\n  // If the message inherits from ToMainMessage, intercept concurrency to the main process\n  if (message instanceof ToMainMessage) {\n    const { __virid_target, __virid_message_type, ...payload } = message;\n    if (__virid_target == ToMainMessage.__virid_source) {\n      MessageWriter.warn(\n        `[Virid Render] Prohibit Sending To Oneself: ${__virid_target} is not allowed in ToRenderMessage.`,\n      );\n      return;\n    }\n    window.__VIRID_BRIDGE__.post({\n      __virid_source: ToMainMessage.__virid_source,\n      __virid_target: __virid_target,\n      __virid_message_type: __virid_message_type,\n      payload: payload, // Expand all attributes on the instance\n    });\n  } else {\n    next();\n  }\n};\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\nimport { VIRID_METADATA } from \"@virid/core\";\n\nexport const VIRID_RENDERER_METADATA = {\n  ...VIRID_METADATA,\n  FROMMAIN: \"virid:renderer:frommain\",\n} as const;\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\nimport { Newable } from \"@virid/core\";\nimport { type FromMainMessage } from \"./message\";\nimport { VIRID_RENDERER_METADATA } from \"./constant\";\nexport function FromMain(type: string) {\n  return function (target: Newable<FromMainMessage>) {\n    Reflect.defineMetadata(VIRID_RENDERER_METADATA.FROMMAIN, type, target);\n  };\n}\n"],"mappings":";;;;ulBAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,cAAAE,EAAA,oBAAAC,EAAA,iBAAAC,EAAA,kBAAAC,EAAA,eAAAC,IAAA,eAAAC,EAAAP,GAiBA,IAAAQ,EAKO,uBCjBP,IAAAC,EAA6B,uBAItB,IAAeC,EAAf,MAAeA,UAAwBC,cAAAA,CAAvC,kCAGEC,EAAAA,sBAAyB,WAMzBC,EAAAA,sBAAyB,IAIzBC,EAAAA,4BAA+B,IACxC,EAd8CH,EAAAA,EAAAA,mBAAvC,IAAeD,EAAfK,EAmBeC,EAAf,MAAeA,UAAsBL,cAAAA,CAgB5C,EAhB4CA,EAAAA,EAAAA,iBAG1CM,EAHoBD,EAGNJ,kBAHT,IAAeI,EAAfE,ECvBP,IAAAC,EAA+C,uBAExC,IAAMC,EAAyBC,EAAA,CAACC,EAASC,IAAAA,CAE9C,GAAID,aAAmBE,EAAe,CACpC,GAAM,CAAEC,eAAAA,EAAgBC,qBAAAA,EAAsB,GAAGC,CAAAA,EAAYL,EAC7D,GAAIG,GAAkBD,EAAcI,eAAgB,CAClDC,gBAAcC,KACZ,+CAA+CL,CAAAA,qCAAmD,EAEpG,MACF,CACAM,OAAOC,iBAAiBC,KAAK,CAC3BL,eAAgBJ,EAAcI,eAC9BH,eAAgBA,EAChBC,qBAAsBA,EACtBC,QAASA,CACX,CAAA,CACF,MACEJ,EAAAA,CAEJ,EAnBsC,cCFtC,IAAAW,EAA+B,uBAElBC,EAA0B,CACrC,GAAGC,iBACHC,SAAU,yBACZ,ECFO,SAASC,EAASC,EAAY,CACnC,OAAO,SAAUC,EAAgC,CAC/CC,QAAQC,eAAeC,EAAwBC,SAAUL,EAAMC,CAAAA,CACjE,CACF,CAJgBF,EAAAA,EAAAA,YJuBT,IAAMO,EAAN,MAAMA,CAAAA,CAAN,cACLC,EAAAA,YAAO,iBACAC,EAAAA,mBAAc,IAAIC,KAEzBC,QAAQC,EAAeC,EAAuB,CAEvCC,OAAOC,kBACVC,gBAAcC,MACZ,IAAIC,MACF,oFAAoF,CAAA,EAKrFL,GAASM,UACZH,gBAAcC,MACZ,IAAIC,MACF,+DAA+DL,GAASM,QAAAA,GAAW,CAAA,EAKzFC,EAAcC,eAAiBR,EAAQM,SAEvCL,OAAOC,iBAAiBO,KAAK,CAC3BD,eAAgBR,EAAQM,SACxBI,eAAgB,OAChBC,qBAAsB,0BACtBC,QAAS,CACPN,SAAUN,EAAQM,QACpB,CACF,CAAA,EAEAL,OAAOC,iBAAiBW,UAAU,KAAKC,sBAAsB,EAE7Df,EAAIgB,cAAcC,CAAAA,CACpB,CACAC,UAAUC,EAAkC,CAC1C,IAAMC,EAAQC,QAAQC,YAAYC,EAAwBC,SAAUL,CAAAA,EAChE,KAAKtB,YAAY4B,IAAIL,CAAAA,GACvBhB,gBAAcC,MACZ,IAAIC,MACF,kEAAkEc,CAAAA,oBAAyBD,CAAAA,EAAQ,CAAA,EAIzG,KAAKtB,YAAY6B,IAAIN,EAAOD,CAAAA,CAC9B,CAEAJ,uBAAuBY,EAAuB,CAC5C,GAAM,CAAElB,eAAAA,EAAgBE,eAAAA,EAAgBC,qBAAAA,EAAsBC,QAAAA,CAAO,EACnEc,EACF,GAAI,CAACf,GAAwB,CAACH,GAAkB,CAACE,EAAgB,CAC/DP,gBAAcC,MACZ,IAAIC,MACF;kBAAoDG,CAAAA;iBAAkCE,CAAAA;wBAAyCC,CAAAA,GAAuB,CAAA,EAG1J,MACF,CACA,GAAI,CAAC,KAAKf,YAAY4B,IAAIb,CAAAA,EAAuB,CAC/CR,gBAAcC,MACZ,IAAIC,MAAM,qCAAqCM,CAAAA,GAAuB,CAAA,EAExE,MACF,CAEA,IAAMgB,EAAe,KAAK/B,YAAYgC,IAAIjB,CAAAA,EAEpCkB,EAAW,IAAIF,EAGrBE,EAASrB,eAAiBA,EAC1BqB,EAASnB,eAAiBA,EAC1BmB,EAASlB,qBAAuBA,EAG5BC,GACFkB,OAAOC,OAAOF,EAAUjB,CAAAA,EAI1BT,gBAAc6B,MAAMH,CAAAA,CACtB,CACF,EApFanC,EAAAA,EAAAA,gBAAN,IAAMA,EAANuC","names":["index_exports","__export","FromMain","FromMainMessage","RenderPlugin","ToMainMessage","middleWare","__toCommonJS","import_core","import_core","FromMainMessage","EventMessage","__virid_source","__virid_target","__virid_message_type","_FromMainMessage","ToMainMessage","__publicField","_ToMainMessage","import_core","middleWare","__name","message","next","ToMainMessage","__virid_target","__virid_message_type","payload","__virid_source","MessageWriter","warn","window","__VIRID_BRIDGE__","post","import_core","VIRID_RENDERER_METADATA","VIRID_METADATA","FROMMAIN","FromMain","type","target","Reflect","defineMetadata","VIRID_RENDERER_METADATA","FROMMAIN","RenderPlugin","name","message_map","Map","install","app","options","window","__VIRID_BRIDGE__","MessageWriter","error","Error","windowId","ToMainMessage","__virid_source","post","__virid_target","__virid_message_type","payload","subscribe","convertFromMainMessage","useMiddleware","middleWare","bindRoute","target","route","Reflect","getMetadata","VIRID_RENDERER_METADATA","FROMMAIN","has","set","ipcMessage","MessageClass","get","instance","Object","assign","write","_RenderPlugin"]}

package/dist/index.d.cts

@@ -1,5 +1,9 @@
 import { EventMessage, Middleware, Newable, ViridPlugin, ViridApp } from '@virid/core';
 
+interface PluginOption {
+    windowId: string;
+}
+
 /**
  * RenderMessage: Message sent by the main process
  */
@@ -16,7 +20,7 @@ declare abstract class FromMainMessage extends EventMessage {
     /**
      *What message should I turn into at the destination?
      */
-    __virid_messageType: string;
+    __virid_message_type: string;
 }
 /**
  *RenderMessage: Initiated by the rendering process, targeting the main process or other windows
@@ -34,24 +38,19 @@ declare abstract class ToMainMessage extends EventMessage {
     /**
      *What message should I turn into at the destination?
      */
-    abstract __virid_messageType: string;
+    abstract __virid_message_type: string;
 }
 
 declare const middleWare: Middleware;
 
 declare function FromMain(type: string): (target: Newable<FromMainMessage>) => void;
-declare function convertFromMainMessage(ipcMessage: any): void;
-
-interface PluginOption {
-    /**
-     * 窗口的 ID
-     */
-    windowId: string;
-}
 
-declare class RenderPluginClass implements ViridPlugin<PluginOption> {
+declare class RenderPlugin implements ViridPlugin<PluginOption> {
     name: string;
+    message_map: Map<string, Newable<FromMainMessage>>;
     install(app: ViridApp, options: PluginOption): void;
+    bindRoute(target: Newable<FromMainMessage>): void;
+    convertFromMainMessage(ipcMessage: any): void;
 }
 
-export { FromMain, FromMainMessage, type PluginOption, RenderPluginClass, ToMainMessage, convertFromMainMessage, middleWare };
+export { FromMain, FromMainMessage, type PluginOption, RenderPlugin, ToMainMessage, middleWare };

package/dist/index.d.ts

@@ -1,5 +1,9 @@
 import { EventMessage, Middleware, Newable, ViridPlugin, ViridApp } from '@virid/core';
 
+interface PluginOption {
+    windowId: string;
+}
+
 /**
  * RenderMessage: Message sent by the main process
  */
@@ -16,7 +20,7 @@ declare abstract class FromMainMessage extends EventMessage {
     /**
      *What message should I turn into at the destination?
      */
-    __virid_messageType: string;
+    __virid_message_type: string;
 }
 /**
  *RenderMessage: Initiated by the rendering process, targeting the main process or other windows
@@ -34,24 +38,19 @@ declare abstract class ToMainMessage extends EventMessage {
     /**
      *What message should I turn into at the destination?
      */
-    abstract __virid_messageType: string;
+    abstract __virid_message_type: string;
 }
 
 declare const middleWare: Middleware;
 
 declare function FromMain(type: string): (target: Newable<FromMainMessage>) => void;
-declare function convertFromMainMessage(ipcMessage: any): void;
-
-interface PluginOption {
-    /**
-     * 窗口的 ID
-     */
-    windowId: string;
-}
 
-declare class RenderPluginClass implements ViridPlugin<PluginOption> {
+declare class RenderPlugin implements ViridPlugin<PluginOption> {
     name: string;
+    message_map: Map<string, Newable<FromMainMessage>>;
     install(app: ViridApp, options: PluginOption): void;
+    bindRoute(target: Newable<FromMainMessage>): void;
+    convertFromMainMessage(ipcMessage: any): void;
 }
 
-export { FromMain, FromMainMessage, type PluginOption, RenderPluginClass, ToMainMessage, convertFromMainMessage, middleWare };
+export { FromMain, FromMainMessage, type PluginOption, RenderPlugin, ToMainMessage, middleWare };

package/dist/index.js

@@ -1,10 +1,9 @@
 /**
- *  @virid/renderer v0.3.0
+ *  @virid/renderer v0.3.2
  *  Electron renderer process adapter for virid, responsible for forwarding and receiving messages from the main process
  */
-var f=Object.defineProperty;var M=(e,r,i)=>r in e?f(e,r,{enumerable:!0,configurable:!0,writable:!0,value:i}):e[r]=i;var _=(e,r)=>f(e,"name",{value:r,configurable:!0});var d=(e,r,i)=>M(e,typeof r!="symbol"?r+"":r,i);import{EventMessage as g}from"@virid/core";var m=class m extends g{constructor(){super(...arguments);d(this,"__virid_source","unknown");d(this,"__virid_target","");d(this,"__virid_messageType","")}};_(m,"FromMainMessage");var w=m,a=class a extends g{};_(a,"ToMainMessage"),d(a,"__virid_source");var o=a;import{MessageWriter as y}from"@virid/core";var I=_((e,r)=>{if(e instanceof o){let{__virid_target:i,__virid_messageType:t,...s}=e;if(i==o.__virid_source){y.warn(`[Virid Render] Prohibit Sending To Oneself: ${i} is not allowed in ToRenderMessage.`);return}window.__VIRID_BRIDGE__.post({__virid_source:o.__virid_source,__virid_target:i,__virid_messageType:t,payload:s})}else r()},"middleWare");import{MessageWriter as p}from"@virid/core";var c=new Map;function B(e){return function(r){c.has(e)&&p.error(new Error(`[Virid Main] Duplicate IpcMessage: Registration for type: ${e}`)),c.set(e,r)}}_(B,"FromMain");function l(e){let{__virid_source:r,__virid_target:i,__virid_messageType:t,payload:s}=e;if(!t||!r||!i){p.error(new Error(`[Virid Render] Incomplete Data:
+var w=Object.defineProperty;var D=(i,e,r)=>e in i?w(i,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):i[e]=r;var _=(i,e)=>w(i,"name",{value:e,configurable:!0});var o=(i,e,r)=>D(i,typeof e!="symbol"?e+"":e,r);import{MessageWriter as d}from"@virid/core";import{EventMessage as v}from"@virid/core";var c=class c extends v{constructor(){super(...arguments);o(this,"__virid_source","unknown");o(this,"__virid_target","");o(this,"__virid_message_type","")}};_(c,"FromMainMessage");var f=c,m=class m extends v{};_(m,"ToMainMessage"),o(m,"__virid_source");var s=m;import{MessageWriter as u}from"@virid/core";var g=_((i,e)=>{if(i instanceof s){let{__virid_target:r,__virid_message_type:a,...t}=i;if(r==s.__virid_source){u.warn(`[Virid Render] Prohibit Sending To Oneself: ${r} is not allowed in ToRenderMessage.`);return}window.__VIRID_BRIDGE__.post({__virid_source:s.__virid_source,__virid_target:r,__virid_message_type:a,payload:t})}else e()},"middleWare");import{VIRID_METADATA as M}from"@virid/core";var p={...M,FROMMAIN:"virid:renderer:frommain"};function O(i){return function(e){Reflect.defineMetadata(p.FROMMAIN,i,e)}}_(O,"FromMain");var R=class R{constructor(){o(this,"name","@virid/render");o(this,"message_map",new Map)}install(e,r){window.__VIRID_BRIDGE__||d.error(new Error("[Virid Render] Preloading Failed: Please initialize in the preloaded script first.")),r?.windowId||d.error(new Error(`[Virid Render] Activate Failed: Please provide the windowId:${r?.windowId}.`)),s.__virid_source=r.windowId,window.__VIRID_BRIDGE__.post({__virid_source:r.windowId,__virid_target:"main",__virid_message_type:"VIRID_INTERNAL_REGISTER",payload:{windowId:r.windowId}}),window.__VIRID_BRIDGE__.subscribe(this.convertFromMainMessage),e.useMiddleware(g)}bindRoute(e){let r=Reflect.getMetadata(p.FROMMAIN,e);this.message_map.has(r)&&d.error(new Error(`[Virid Renderer] Duplicate IpcMessage: Registration for route: ${r}, message class: ${e}`)),this.message_map.set(r,e)}convertFromMainMessage(e){let{__virid_source:r,__virid_target:a,__virid_message_type:t,payload:I}=e;if(!t||!r||!a){d.error(new Error(`[Virid Render] Incomplete Data:
 __virid_source: ${r}
-__virid_target:${i}
-__virid_messageType: ${t}.`));return}if(!c.has(t)){p.error(new Error(`[Virid Render] Unregistered type: ${t} `));return}let E=c.get(t),n=new E;n.__virid_source=r,n.__virid_target=i,n.__virid_messageType=t,s&&Object.assign(n,s),p.write(n)}_(l,"convertFromMainMessage");import{MessageWriter as u}from"@virid/core";function R(e,r){window.__VIRID_BRIDGE__||u.error(new Error("[Virid Render] Preloading Failed: Please initialize in the preloaded script first.")),r?.windowId||u.error(new Error(`[Virid Render] Activate Failed:
-Please provide the windowId:${r?.windowId}.`)),o.__virid_source=r.windowId,window.__VIRID_BRIDGE__.post({__virid_source:r.windowId,__virid_target:"main",__virid_messageType:"VIRID_INTERNAL_REGISTER",payload:{windowId:r.windowId}}),window.__VIRID_BRIDGE__.subscribe(l),e.useMiddleware(I)}_(R,"activateApp");var v=class v{constructor(){d(this,"name","@virid/render")}install(r,i){R(r,i)}};_(v,"RenderPluginClass");var x=v;export{B as FromMain,w as FromMainMessage,x as RenderPluginClass,o as ToMainMessage,l as convertFromMainMessage,I as middleWare};
+__virid_target:${a}
+__virid_message_type: ${t}.`));return}if(!this.message_map.has(t)){d.error(new Error(`[Virid Render] Unregistered type: ${t} `));return}let E=this.message_map.get(t),n=new E;n.__virid_source=r,n.__virid_target=a,n.__virid_message_type=t,I&&Object.assign(n,I),d.write(n)}};_(R,"RenderPlugin");var l=R;export{O as FromMain,f as FromMainMessage,l as RenderPlugin,s as ToMainMessage,g as middleWare};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/renderer/message.ts","../src/renderer/middleware.ts","../src/renderer/router.ts","../src/app.ts","../src/index.ts"],"sourcesContent":["/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\nimport { EventMessage } from \"@virid/core\";\n/**\n * RenderMessage: Message sent by the main process\n */\nexport abstract class FromMainMessage extends EventMessage {\n  /** Where am I from?\n   */\n  public __virid_source: string = \"unknown\";\n  /**Where is my destination?\n   *'main ': Sent to the main process for processing\n   *'all': Broadcast to all windows (relayed through the main process)\n   *String: Specify the ID of a window (windowId)\n   */\n  public __virid_target: string = \"\";\n  /**\n   *What message should I turn into at the destination?\n   */\n  public __virid_messageType: string = \"\";\n}\n\n/**\n *RenderMessage: Initiated by the rendering process, targeting the main process or other windows\n */\nexport abstract class ToMainMessage extends EventMessage {\n  /**Where am I from?\n   */\n  public static __virid_source: string;\n\n  /**Where is my destination?\n   *'main ': Sent to the main process for processing\n   *'all': Broadcast to all windows (relayed through the main process)\n   *String: Specify the ID of a window (windowId)\n   */\n  public abstract __virid_target: string;\n\n  /**\n   *What message should I turn into at the destination?\n   */\n  public abstract __virid_messageType: string;\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\nimport { type Middleware, MessageWriter } from \"@virid/core\";\nimport { ToMainMessage } from \"./message\";\nexport const middleWare: Middleware = (message, next) => {\n  // If the message inherits from ToMainMessage, intercept concurrency to the main process\n  if (message instanceof ToMainMessage) {\n    const { __virid_target, __virid_messageType, ...payload } = message;\n    if (__virid_target == ToMainMessage.__virid_source) {\n      MessageWriter.warn(\n        `[Virid Render] Prohibit Sending To Oneself: ${__virid_target} is not allowed in ToRenderMessage.`,\n      );\n      return;\n    }\n    window.__VIRID_BRIDGE__.post({\n      __virid_source: ToMainMessage.__virid_source,\n      __virid_target: __virid_target,\n      __virid_messageType: __virid_messageType,\n      payload: payload, // Expand all attributes on the instance\n    });\n  } else {\n    next();\n  }\n};\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\nimport { MessageWriter, Newable } from \"@virid/core\";\nimport { type FromMainMessage } from \"./message\";\nconst MESSAGE_MAP = new Map<string, Newable<FromMainMessage>>();\n\nexport function FromMain(type: string) {\n  return function (target: Newable<FromMainMessage>) {\n    if (MESSAGE_MAP.has(type)) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] Duplicate IpcMessage: Registration for type: ${type}`,\n        ),\n      );\n    }\n    MESSAGE_MAP.set(type, target);\n  };\n}\nexport function convertFromMainMessage(ipcMessage: any): void {\n  const { __virid_source, __virid_target, __virid_messageType, payload } =\n    ipcMessage;\n  if (!__virid_messageType || !__virid_source || !__virid_target) {\n    MessageWriter.error(\n      new Error(\n        `[Virid Render] Incomplete Data:\\n__virid_source: ${__virid_source}\\n__virid_target:${__virid_target}\\n__virid_messageType: ${__virid_messageType}.`,\n      ),\n    );\n    return;\n  }\n  if (!MESSAGE_MAP.has(__virid_messageType)) {\n    MessageWriter.error(\n      new Error(`[Virid Render] Unregistered type: ${__virid_messageType} `),\n    );\n    return;\n  }\n  // Find the corresponding constructor\n  const MessageClass = MESSAGE_MAP.get(__virid_messageType)!;\n  // Instantiate and inject parameters\n  const instance = new MessageClass();\n\n  // Explicitly assigning base class identifiers to ensure complete identity information of instances\n  instance.__virid_source = __virid_source;\n  instance.__virid_target = __virid_target;\n  instance.__virid_messageType = __virid_messageType;\n\n  // Restore data\n  if (payload) {\n    Object.assign(instance, payload);\n  }\n\n  // Redistribution\n  MessageWriter.write(instance);\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\n\nimport { MessageWriter, type ViridApp } from \"@virid/core\";\nimport { middleWare, convertFromMainMessage, ToMainMessage } from \"./renderer\";\nimport { type PluginOption } from \"./interfaces\";\nexport function activateApp(app: ViridApp, options: PluginOption) {\n  // first, check if the preload script has been loaded\n  if (!window.__VIRID_BRIDGE__) {\n    MessageWriter.error(\n      new Error(\n        `[Virid Render] Preloading Failed: Please initialize in the preloaded script first.`,\n      ),\n    );\n  }\n  // check whether parameters are passed\n  if (!options?.windowId) {\n    MessageWriter.error(\n      new Error(\n        `[Virid Render] Activate Failed:\\nPlease provide the windowId:${options?.windowId}.`,\n      ),\n    );\n  }\n  // register your own id, so that all messages sent to the main process will carry your own id in the future\n  ToMainMessage.__virid_source = options.windowId;\n  // actively send a registration message to the main process to register itself\n  window.__VIRID_BRIDGE__.post({\n    __virid_source: options.windowId,\n    __virid_target: \"main\",\n    __virid_messageType: \"VIRID_INTERNAL_REGISTER\",\n    payload: {\n      windowId: options.windowId,\n    },\n  });\n  // Subscribe to the ipc channel, and convert all returned messages into our own message types according to the registry\n  window.__VIRID_BRIDGE__.subscribe(convertFromMainMessage);\n  // register your own middleware function to intercept messages of type ToMainMessage and forward them to the main process of electron\n  app.useMiddleware(middleWare);\n}\n","/*\n * Copyright (c) 2026-present Ailrid\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n * Description: Electron renderer process adapter for virid, responsible for forwarding and receiving messages from the main process.\n */\nimport { ViridPlugin, type ViridApp } from \"@virid/core\";\nexport { ToMainMessage, FromMainMessage } from \"./renderer\";\nexport * from \"./interfaces\";\nexport * from \"./renderer\";\nimport { activateApp } from \"./app\";\nimport { type PluginOption } from \"./interfaces\";\n\nexport class RenderPluginClass implements ViridPlugin<PluginOption> {\n  name = \"@virid/render\";\n  install(app: ViridApp, options: PluginOption) {\n    activateApp(app, options);\n  }\n}\n"],"mappings":";;;;uNAKA,OAASA,gBAAAA,MAAoB,cAItB,IAAeC,EAAf,MAAeA,UAAwBC,CAAAA,CAAvC,kCAGEC,EAAAA,sBAAyB,WAMzBC,EAAAA,sBAAyB,IAIzBC,EAAAA,2BAA8B,IACvC,EAd8CH,EAAAA,EAAAA,mBAAvC,IAAeD,EAAfK,EAmBeC,EAAf,MAAeA,UAAsBL,CAAAA,CAgB5C,EAhB4CA,EAAAA,EAAAA,iBAG1CM,EAHoBD,EAGNJ,kBAHT,IAAeI,EAAfE,ECvBP,OAA0BC,iBAAAA,MAAqB,cAExC,IAAMC,EAAyBC,EAAA,CAACC,EAASC,IAAAA,CAE9C,GAAID,aAAmBE,EAAe,CACpC,GAAM,CAAEC,eAAAA,EAAgBC,oBAAAA,EAAqB,GAAGC,CAAAA,EAAYL,EAC5D,GAAIG,GAAkBD,EAAcI,eAAgB,CAClDC,EAAcC,KACZ,+CAA+CL,CAAAA,qCAAmD,EAEpG,MACF,CACAM,OAAOC,iBAAiBC,KAAK,CAC3BL,eAAgBJ,EAAcI,eAC9BH,eAAgBA,EAChBC,oBAAqBA,EACrBC,QAASA,CACX,CAAA,CACF,MACEJ,EAAAA,CAEJ,EAnBsC,cCFtC,OAASW,iBAAAA,MAA8B,cAEvC,IAAMC,EAAc,IAAIC,IAEjB,SAASC,EAASC,EAAY,CACnC,OAAO,SAAUC,EAAgC,CAC3CJ,EAAYK,IAAIF,CAAAA,GAClBG,EAAcC,MACZ,IAAIC,MACF,6DAA6DL,CAAAA,EAAM,CAAA,EAIzEH,EAAYS,IAAIN,EAAMC,CAAAA,CACxB,CACF,CAXgBF,EAAAA,EAAAA,YAYT,SAASQ,EAAuBC,EAAe,CACpD,GAAM,CAAEC,eAAAA,EAAgBC,eAAAA,EAAgBC,oBAAAA,EAAqBC,QAAAA,CAAO,EAClEJ,EACF,GAAI,CAACG,GAAuB,CAACF,GAAkB,CAACC,EAAgB,CAC9DP,EAAcC,MACZ,IAAIC,MACF;kBAAoDI,CAAAA;iBAAkCC,CAAAA;uBAAwCC,CAAAA,GAAsB,CAAA,EAGxJ,MACF,CACA,GAAI,CAACd,EAAYK,IAAIS,CAAAA,EAAsB,CACzCR,EAAcC,MACZ,IAAIC,MAAM,qCAAqCM,CAAAA,GAAsB,CAAA,EAEvE,MACF,CAEA,IAAME,EAAehB,EAAYiB,IAAIH,CAAAA,EAE/BI,EAAW,IAAIF,EAGrBE,EAASN,eAAiBA,EAC1BM,EAASL,eAAiBA,EAC1BK,EAASJ,oBAAsBA,EAG3BC,GACFI,OAAOC,OAAOF,EAAUH,CAAAA,EAI1BT,EAAce,MAAMH,CAAAA,CACtB,CAlCgBR,EAAAA,EAAAA,0BCfhB,OAASY,iBAAAA,MAAoC,cAGtC,SAASC,EAAYC,EAAeC,EAAqB,CAEzDC,OAAOC,kBACVC,EAAcC,MACZ,IAAIC,MACF,oFAAoF,CAAA,EAKrFL,GAASM,UACZH,EAAcC,MACZ,IAAIC,MACF;8BAAgEL,GAASM,QAAAA,GAAW,CAAA,EAK1FC,EAAcC,eAAiBR,EAAQM,SAEvCL,OAAOC,iBAAiBO,KAAK,CAC3BD,eAAgBR,EAAQM,SACxBI,eAAgB,OAChBC,oBAAqB,0BACrBC,QAAS,CACPN,SAAUN,EAAQM,QACpB,CACF,CAAA,EAEAL,OAAOC,iBAAiBW,UAAUC,CAAAA,EAElCf,EAAIgB,cAAcC,CAAAA,CACpB,CAhCgBlB,EAAAA,EAAAA,eCeT,IAAMmB,EAAN,MAAMA,CAAAA,CAAN,cACLC,EAAAA,YAAO,iBACPC,QAAQC,EAAeC,EAAuB,CAC5CC,EAAYF,EAAKC,CAAAA,CACnB,CACF,EALaJ,EAAAA,EAAAA,qBAAN,IAAMA,EAANM","names":["EventMessage","FromMainMessage","EventMessage","__virid_source","__virid_target","__virid_messageType","_FromMainMessage","ToMainMessage","__publicField","_ToMainMessage","MessageWriter","middleWare","__name","message","next","ToMainMessage","__virid_target","__virid_messageType","payload","__virid_source","MessageWriter","warn","window","__VIRID_BRIDGE__","post","MessageWriter","MESSAGE_MAP","Map","FromMain","type","target","has","MessageWriter","error","Error","set","convertFromMainMessage","ipcMessage","__virid_source","__virid_target","__virid_messageType","payload","MessageClass","get","instance","Object","assign","write","MessageWriter","activateApp","app","options","window","__VIRID_BRIDGE__","MessageWriter","error","Error","windowId","ToMainMessage","__virid_source","post","__virid_target","__virid_messageType","payload","subscribe","convertFromMainMessage","useMiddleware","middleWare","RenderPluginClass","name","install","app","options","activateApp","_RenderPluginClass"]}
+{"version":3,"sources":["../src/index.ts","../src/renderer/message.ts","../src/renderer/middleware.ts","../src/renderer/constant.ts","../src/renderer/decorator.ts"],"sourcesContent":["/*\n * Copyright (c) 2026-present Ailrid\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n * Description: Electron renderer process adapter for virid, responsible for forwarding and receiving messages from the main process.\n */\nimport {\n  MessageWriter,\n  Newable,\n  ViridPlugin,\n  type ViridApp,\n} from \"@virid/core\";\nimport { type PluginOption } from \"./interfaces\";\nimport { FromMainMessage } from \"./renderer\";\nimport { middleWare, ToMainMessage } from \"./renderer\";\nimport { VIRID_RENDERER_METADATA } from \"./renderer/constant\";\n\nexport * from \"./interfaces\";\nexport * from \"./renderer\";\n\nexport class RenderPlugin implements ViridPlugin<PluginOption> {\n  name = \"@virid/render\";\n  public message_map = new Map<string, Newable<FromMainMessage>>();\n\n  install(app: ViridApp, options: PluginOption) {\n    // first, check if the preload script has been loaded\n    if (!window.__VIRID_BRIDGE__) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Render] Preloading Failed: Please initialize in the preloaded script first.`,\n        ),\n      );\n    }\n    // check whether parameters are passed\n    if (!options?.windowId) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Render] Activate Failed: Please provide the windowId:${options?.windowId}.`,\n        ),\n      );\n    }\n    // register your own id, so that all messages sent to the main process will carry your own id in the future\n    ToMainMessage.__virid_source = options.windowId;\n    // actively send a registration message to the main process to register itself\n    window.__VIRID_BRIDGE__.post({\n      __virid_source: options.windowId,\n      __virid_target: \"main\",\n      __virid_message_type: \"VIRID_INTERNAL_REGISTER\",\n      payload: {\n        windowId: options.windowId,\n      },\n    });\n    // Subscribe to the ipc channel, and convert all returned messages into our own message types according to the registry\n    window.__VIRID_BRIDGE__.subscribe(this.convertFromMainMessage);\n    // register your own middleware function to intercept messages of type ToMainMessage and forward them to the main process of electron\n    app.useMiddleware(middleWare);\n  }\n  bindRoute(target: Newable<FromMainMessage>) {\n    const route = Reflect.getMetadata(VIRID_RENDERER_METADATA.FROMMAIN, target);\n    if (this.message_map.has(route)) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Renderer] Duplicate IpcMessage: Registration for route: ${route}, message class: ${target}`,\n        ),\n      );\n    }\n    this.message_map.set(route, target);\n  }\n\n  convertFromMainMessage(ipcMessage: any): void {\n    const { __virid_source, __virid_target, __virid_message_type, payload } =\n      ipcMessage;\n    if (!__virid_message_type || !__virid_source || !__virid_target) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Render] Incomplete Data:\\n__virid_source: ${__virid_source}\\n__virid_target:${__virid_target}\\n__virid_message_type: ${__virid_message_type}.`,\n        ),\n      );\n      return;\n    }\n    if (!this.message_map.has(__virid_message_type)) {\n      MessageWriter.error(\n        new Error(`[Virid Render] Unregistered type: ${__virid_message_type} `),\n      );\n      return;\n    }\n    // Find the corresponding constructor\n    const MessageClass = this.message_map.get(__virid_message_type)!;\n    // Instantiate and inject parameters\n    const instance = new MessageClass();\n\n    // Explicitly assigning base class identifiers to ensure complete identity information of instances\n    instance.__virid_source = __virid_source;\n    instance.__virid_target = __virid_target;\n    instance.__virid_message_type = __virid_message_type;\n\n    // Restore data\n    if (payload) {\n      Object.assign(instance, payload);\n    }\n\n    // Redistribution\n    MessageWriter.write(instance);\n  }\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\nimport { EventMessage } from \"@virid/core\";\n/**\n * RenderMessage: Message sent by the main process\n */\nexport abstract class FromMainMessage extends EventMessage {\n  /** Where am I from?\n   */\n  public __virid_source: string = \"unknown\";\n  /**Where is my destination?\n   *'main ': Sent to the main process for processing\n   *'all': Broadcast to all windows (relayed through the main process)\n   *String: Specify the ID of a window (windowId)\n   */\n  public __virid_target: string = \"\";\n  /**\n   *What message should I turn into at the destination?\n   */\n  public __virid_message_type: string = \"\";\n}\n\n/**\n *RenderMessage: Initiated by the rendering process, targeting the main process or other windows\n */\nexport abstract class ToMainMessage extends EventMessage {\n  /**Where am I from?\n   */\n  public static __virid_source: string;\n\n  /**Where is my destination?\n   *'main ': Sent to the main process for processing\n   *'all': Broadcast to all windows (relayed through the main process)\n   *String: Specify the ID of a window (windowId)\n   */\n  public abstract __virid_target: string;\n\n  /**\n   *What message should I turn into at the destination?\n   */\n  public abstract __virid_message_type: string;\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\nimport { type Middleware, MessageWriter } from \"@virid/core\";\nimport { ToMainMessage } from \"./message\";\nexport const middleWare: Middleware = (message, next) => {\n  // If the message inherits from ToMainMessage, intercept concurrency to the main process\n  if (message instanceof ToMainMessage) {\n    const { __virid_target, __virid_message_type, ...payload } = message;\n    if (__virid_target == ToMainMessage.__virid_source) {\n      MessageWriter.warn(\n        `[Virid Render] Prohibit Sending To Oneself: ${__virid_target} is not allowed in ToRenderMessage.`,\n      );\n      return;\n    }\n    window.__VIRID_BRIDGE__.post({\n      __virid_source: ToMainMessage.__virid_source,\n      __virid_target: __virid_target,\n      __virid_message_type: __virid_message_type,\n      payload: payload, // Expand all attributes on the instance\n    });\n  } else {\n    next();\n  }\n};\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\nimport { VIRID_METADATA } from \"@virid/core\";\n\nexport const VIRID_RENDERER_METADATA = {\n  ...VIRID_METADATA,\n  FROMMAIN: \"virid:renderer:frommain\",\n} as const;\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\nimport { Newable } from \"@virid/core\";\nimport { type FromMainMessage } from \"./message\";\nimport { VIRID_RENDERER_METADATA } from \"./constant\";\nexport function FromMain(type: string) {\n  return function (target: Newable<FromMainMessage>) {\n    Reflect.defineMetadata(VIRID_RENDERER_METADATA.FROMMAIN, type, target);\n  };\n}\n"],"mappings":"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","names":["MessageWriter","EventMessage","FromMainMessage","EventMessage","__virid_source","__virid_target","__virid_message_type","_FromMainMessage","ToMainMessage","__publicField","_ToMainMessage","MessageWriter","middleWare","__name","message","next","ToMainMessage","__virid_target","__virid_message_type","payload","__virid_source","MessageWriter","warn","window","__VIRID_BRIDGE__","post","VIRID_METADATA","VIRID_RENDERER_METADATA","FROMMAIN","FromMain","type","target","Reflect","defineMetadata","VIRID_RENDERER_METADATA","FROMMAIN","RenderPlugin","name","message_map","Map","install","app","options","window","__VIRID_BRIDGE__","MessageWriter","error","Error","windowId","ToMainMessage","__virid_source","post","__virid_target","__virid_message_type","payload","subscribe","convertFromMainMessage","useMiddleware","middleWare","bindRoute","target","route","Reflect","getMetadata","VIRID_RENDERER_METADATA","FROMMAIN","has","set","ipcMessage","MessageClass","get","instance","Object","assign","write","_RenderPlugin"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@virid/renderer",
   "type": "module",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Electron renderer process adapter for virid, responsible for forwarding and receiving messages from the main process",
   "author": "Ailrid",
   "license": "Apache 2.0",
@@ -34,7 +34,7 @@
   },
   "dependencies": {},
   "peerDependencies": {
-    "@virid/core": "0.3.0"
+    "@virid/core": "0.3.2"
   },
   "scripts": {
     "build": "tsup --config tsup.config.ts",