@virid/main 0.1.0 → 0.1.2

package/README.md

@@ -1 +1,160 @@
-todo
+# @virid/main
+
+**@virid/main** is the main process adapter for Electron applications. It provides automatic routing for `ToRendererMessage` and `FromRendererMessage`, along with the capability to receive and manage reporting from rendering processes.
+
+## 🌟 Core Design Philosophy
+
+In **@virid/main**, messages sent from the main process to a rendering process are abstracted as `ToRendererMessage`. These messages can be distributed directly via the dispatcher, traveling through IPC to the target rendering process to trigger the corresponding **System**.
+
+Conversely, messages sent from a rendering process to the main process are abstracted as `FromRendererMessage`. Once a rendering process sends a message, the `FromRendererMessage` is automatically delivered to the dispatcher to trigger the relevant main process **System**.
+
+- **Automatic Route Registration**: When a rendering process window opens, it automatically registers itself with the main process. All subsequent messages will carry the window's specific metadata (context).
+- **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 by using the specific IDs of rendering processes, or use `*` to broadcast messages to all windows.
+
+## 🔌Enable plugins
+
+```ts
+import { createVirid } from '@virid/core'
+import { MainPlugin } from '@virid/main'
+import { app } from 'electron'
+const virid = createVirid()
+  .use(MainPlugin, { electronApp: app })
+```
+
+## 🛠️ @virid/main Core API Overview
+
+### ToRendererMessage
+
+- **Function**: A specialized message base class designed for inheritance. All messages inheriting from `ToRendererMessage` will be dispatched to the rendering process.
+- **Logic**: This message type requires two specific metadata tags:
+  - `__virid_target`: Specifies the destination (e.g., a specific `windowId`).
+  - `__virid_messageType`: Defines the message type it should be restored to upon reaching the rendering process.
+
+- Example:
+
+**In the Main Process:**
+
+```ts
+import { ToRendererMessage } from '@virid/main'
+
+/**
+ * - __virid_target = 'renderer': Indicates the message is bound for the rendering process 
+ * with the windowId 'renderer'.
+ * - __virid_messageType = 'file-dialog': Describes the type this message will transform 
+ * into once it arrives in the rendering process.
+ */
+export class RenderDialogMessage extends ToRendererMessage {
+  __virid_target: string = 'renderer'
+  __virid_messageType: string = 'file-dialog'
+  
+  constructor(public path: string) {
+    super()
+  }
+}
+```
+
+In the **Rendering Process**, you can use the `@FromIpc` decorator in conjunction with `FromMainMessage` to handle the conversion. For more details, refer to `@virid/renderer`.
+
+**In the Rendering Process:**
+
+```ts
+import { FromIpc, FromMainMessage } from '@virid/renderer'
+
+/**
+ * @FromIpc('file-dialog') indicates that when the Main Process sends a ToRendererMessage 
+ * where __virid_messageType is 'file-dialog', this message will be automatically 
+ * delivered to the Virid dispatcher to trigger the corresponding rendering process System.
+ */
+@FromIpc('file-dialog')
+class ChooseBgImageMessage extends FromMainMessage {
+  constructor(public path: string) {
+    super()
+  }
+}
+```
+
+### FromRenderMessage / @FromRenderer()
+
+- **Function**: A specialized message base class designed for inheritance. All messages inheriting from `FromRenderMessage` will be automatically converted and dispatched to the **Virid Dispatcher** in the Main Process when sent from a Rendering Process.
+- **Logic**: The `@FromRenderer()` decorator accepts a string-based ID. This ID must match the `__virid_messageType` of the `ToMainMessage` dispatched from the Rendering Process.
+
+#### Example:
+
+**In the Main Process:**
+
+```ts
+import { FromRenderer, FromRenderMessage, ToRendererMessage } from '@virid/main'
+
+// Message to be sent to the Rendering Process
+export class RenderDialogMessage extends ToRendererMessage {
+  __virid_target: string = 'renderer'
+  __virid_messageType: string = 'file-dialog'
+  constructor(public path: string) {
+    super()
+  }
+}
+
+/**
+ * Converts incoming messages from the Rendering Process with 
+ * __virid_messageType: 'open-dialog' into the Main Process's OpenDialogMessage.
+ */
+@FromRenderer('open-dialog')
+export class OpenDialogMessage extends FromRenderMessage {
+  constructor(
+    public options: {
+      title?: string
+      filters?: Array<{ name: string; extensions: string[] }>
+      properties?: Array<'openFile' | 'openDirectory' | 'multiSelections' | 'showHiddenFiles'>
+    }
+  ) {
+    super()
+  }
+}
+
+export class WindowSystem {
+  @System()
+  async openDialog(@Message(OpenDialogMessage) message: OpenDialogMessage) {
+    // Invoke native Electron dialog
+    const result = await dialog.showOpenDialog(message.senderWindow, message.options)
+    
+    // If the user did not cancel and selected a file
+    if (!result.canceled && result.filePaths.length > 0) {
+      const selectedPath = result.filePaths[0]
+      return new RenderDialogMessage(selectedPath)
+    }
+    return
+  }
+}
+```
+
+In the **Rendering Process**, you can use `@FromIpc` in conjunction with `ToMainMessage` to handle message conversion and dispatching. For more details, refer to `@virid/renderer`.
+
+**In the Rendering Process:**
+
+```ts
+import { ToMainMessage, FromIpc, FromMainMessage } from '@virid/renderer'
+
+// Handles the incoming file selection result
+@FromIpc('file-dialog')
+class ChooseBgImageMessage extends FromMainMessage {
+  constructor(public path: string) {
+    super()
+  }
+}
+
+// Initiates the request to open a dialog
+class OpenDialogMessage extends ToMainMessage {
+  __virid_target: string = 'main'
+  __virid_messageType: string = 'open-dialog'
+  constructor(
+    public options: {
+      title?: string
+      filters?: Array<{ name: string; extensions: string[] }>
+      properties?: Array<'openFile' | 'openDirectory' | 'multiSelections' | 'showHiddenFiles'>
+    }
+  ) {
+    super()
+  }
+}
+```

package/README.zh.md

@@ -1 +1,138 @@
-todo
+#  @virid/main
+
+`@virid/main` 是electron应用的主适配器，提供`ToRendererMessage`和`FromRendererMessage`的自动路由功能与接受渲染进程报道功能。
+
+## 🌟 核心设计理念
+
+在 `@virid/main` 中，主进程朝渲染进程发送消息被抽象为`ToRendererMessage`，该消息可以直接通过调度器分发，消息将会通过IPC直接传送到渲染进程并触发对应的`System`。渲染进程朝主进程发送的消息被抽象为`FromRendererMessage`，一旦渲染进程发送了对应的消息，`FromRendererMessage`将会自动被投递到调度器触发相应的主进程`System`。
+
+- **路由自动注册**：渲染进程窗口开启后，自动向主进程注册自身，以后所有的消息都将携带自身的窗口信息。
+- **类型恢复**：消息在通过IPC通道后，恢复成真正的Message类重新进入`@virid/core`并被调度器识别并分发。实现不同进程的位置无关性。
+- **消息定向与广播**：可以通过其他渲染进程的ID来实现定向通信，或者使用“*”来广播消息。
+
+## 🔌启用插件
+
+```ts
+import { createVirid } from '@virid/core'
+import { MainPlugin } from '@virid/main'
+import { app } from 'electron'
+const virid = createVirid()
+  .use(MainPlugin, { electronApp: app })
+```
+
+## 🛠️ @virid/main 核心 API 概览
+
+### `ToRendererMessage`
+
+- **功能**：一个特殊的消息基类，可被继承。所有继承自`ToRendererMessage`的Message将被发往渲染进程
+- **逻辑**：该消息类型需要两个特殊标记，`__virid_target`标记了目的地，`__virid_messageType`标记了在目的地应该被还原为的Message类型
+- **示例**：
+
+```ts
+//在主进程
+import { ToRendererMessage } from '@virid/main'
+// __virid_target=‘renderer’,说明消息需要发往windowId为renderer的渲染进程
+//  __virid_messageType: string = 'file-dialog'，描述了在渲染进程，该消息将会重新变为的类型
+export class RenderDialogMessage extends ToRendererMessage {
+  __virid_target: string = 'renderer'
+  __virid_messageType: string = 'file-dialog'
+  constructor(public path: string) {
+    super()
+  }
+}
+```
+
+在渲染进程，可以通过`@FromIpc`结合`FromMainMessage`来实现对应的转换。详情见`@virid/renderer` 。
+
+```ts
+//在渲染进程
+import { FromIpc, FromMainMessage } from '@virid/main'
+//@FromIpc('file-dialog')表明当主进程发送一个ToRenderMessage，而且
+//  __virid_target: string = 'renderer'
+//  __virid_messageType: string = 'file-dialog'
+// 时，这个消息将被自动投递到virid调度中心触发相应的渲染进程System
+@FromIpc('file-dialog')
+class ChooseBgImageMessage extends FromMainMessage {
+  constructor(public path: string) {
+    super()
+  }
+}
+```
+
+### `FromRenderMessage/@FromRenderer()`
+
+- **功能**：一个特殊的消息基类，可被继承。所有继承自`FromRenderMessage`的Message将在渲染进程发送消息时自动转换并投递到主进程的`virid`调度中心
+- **逻辑**：`@FromRenderer()`接受一个字符串类型的ID，该ID与渲染进程中发送的`ToMainMessage`的ID应该相同。
+- **示例**：
+
+```ts
+//在主进程
+import { FromRenderer, FromRenderMessage } from '@virid/renderer'
+// 发往渲染进程的消息
+export class RenderDialogMessage extends ToRendererMessage {
+  __virid_target: string = 'renderer'
+  __virid_messageType: string = 'file-dialog'
+  constructor(public path: string) {
+    super()
+  }
+}
+// 将来自渲染进程且 __virid_messageType: string = 'file-dialog'的消息转换成主进程的OpenDialogMessage
+@FromRenderer('open-dialog')
+export class OpenDialogMessage extends FromRenderMessage {
+  constructor(
+    public options: {
+      title?: string
+      filters?: Array<{ name: string; extensions: string[] }>
+      properties?: Array<'openFile' | 'openDirectory' | 'multiSelections' | 'showHiddenFiles'>
+    }
+  ) {
+    super()
+  }
+}
+
+export class WindowSystem {
+  @System()
+  async openDialog(@Message(OpenDialogMessage) message: OpenDialogMessage) {
+    // 调用原生对话框
+    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)
+    }
+    return
+  }
+}
+```
+
+在渲染进程，可以通过`@FromIpc`结合`ToMainMessage`来实现对应的转换和消息的发送。详情见`@virid/renderer` 。
+
+```ts
+// 在渲染进程
+import { ToMainMessage，FromIpc } from '@virid/renderer'
+// 打开文件选择框
+@FromIpc('file-dialog')
+class ChooseBgImageMessage extends FromMainMessage {
+  constructor(public path: string) {
+    super()
+  }
+}
+//打开文件选择框
+class OpenDialogMessage extends ToMainMessage {
+  __virid_target: string = 'main'
+  __virid_messageType: string = 'open-dialog'
+  constructor(
+    public options: {
+      title?: string
+      filters?: Array<{ name: string; extensions: string[] }>
+      properties?: Array<'openFile' | 'openDirectory' | 'multiSelections' | 'showHiddenFiles'>
+    }
+  ) {
+    super()
+  }
+}
+
+```
+
+
+

package/dist/index.cjs

@@ -1,7 +1,7 @@
 /**
- *  @virid/main v0.0.1
+ *  @virid/main v0.1.1
  *  Electron main process adapter for Virid, responsible for sending, receiving, and broadcasting rendering process messages
  */
-var g=Object.defineProperty;var A=Object.getOwnPropertyDescriptor;var V=Object.getOwnPropertyNames;var W=Object.prototype.hasOwnProperty;var h=(r,e,i)=>e in r?g(r,e,{enumerable:!0,configurable:!0,writable:!0,value:i}):r[e]=i;var a=(r,e)=>g(r,"name",{value:e,configurable:!0});var N=(r,e)=>{for(var i in e)g(r,i,{get:e[i],enumerable:!0})},$=(r,e,i,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of V(e))!W.call(r,n)&&n!==i&&g(r,n,{get:()=>e[n],enumerable:!(o=A(e,n))||o.enumerable});return r};var b=r=>$(g({},"__esModule",{value:!0}),r);var p=(r,e,i)=>h(r,typeof e!="symbol"?e+"":e,i);var U={};N(U,{FromRender:()=>C,FromRenderMessage:()=>M,MainPlugin:()=>S,ROUTER_MAP:()=>_,ToRenderMessage:()=>f,VIRID_CHANNEL:()=>u,middleWare:()=>R,processMessage:()=>T});module.exports=b(U);var E=require("@virid/core");var I=class I extends E.EventMessage{constructor(){super(...arguments);p(this,"__virid_source","unknown");p(this,"__virid_target","unknown");p(this,"__virid_messageType","unknown");p(this,"senderWindow",null)}};a(I,"FromRenderMessage");var M=I,m=class m extends E.EventMessage{};a(m,"ToRenderMessage"),p(m,"__virid_source","main");var f=m;var x=require("@virid/core");var l=require("@virid/core");var u="VIRID_INTERNAL_BUS",_=new Map,w=new Map;function C(r){return function(e){w.has(r)&&l.MessageWriter.warn(`[Virid Main] Duplicate IpcMessage: Registration for type: ${r}`),w.set(r,e)}}a(C,"FromRender");function D(r){let{__virid_source:e,__virid_messageType:i,__virid_target:o,payload:n}=r;if(!w.has(i)){l.MessageWriter.error(new Error(`[Virid Main] unknown Message Type: Cannot find ${i} in the main process registry.`));return}let t=w.get(i),s=new t;n&&Object.assign(s,n),s.__virid_source=e,s.__virid_target=o,s.__virid_messageType=i;let d=_.get(e);d&&(s.senderWindow=d),l.MessageWriter.write(s)}a(D,"ReceiveMessages");function k(r){let{__virid_source:e,__virid_messageType:i,__virid_target:o,payload:n}=r,t=_.get(o);if(!t){l.MessageWriter.error(new Error(`[Virid Main] unknown Window: Cannot find ${o} in the windows registry.`));return}t.webContents.send(u,{__virid_source:e,__virid_messageType:i,__virid_target:o,payload:n})}a(k,"TransmitMessages");function P(r){let{__virid_source:e,__virid_messageType:i,__virid_target:o,payload:n}=r;_.forEach(t=>{t.webContents.send(u,{__virid_source:e,__virid_messageType:i,__virid_target:o,payload:n})})}a(P,"broadcastMessage");function T(r){let{__virid_target:e,__virid_source:i,__virid_messageType:o}=r;return e==="main"?D(r):e==="all"||e==="*"?P(r):k(r)}a(T,"processMessage");var R=a((r,e)=>{if(r instanceof f){let{__virid_target:i,__virid_messageType:o,...n}=r;i=="main"&&x.MessageWriter.warn(`[Virid Main] Prohibit Sending To Oneself: ${i} is not allowed in ToRenderMessage.`);let t={__virid_source:f.__virid_source,__virid_target:i,__virid_messageType:o,payload:n},s=i==="*"||i==="all"?Array.from(_.values()):[_.get(i)].filter(Boolean);s.length>0?s.forEach(d=>d.webContents.send(u,t)):x.MessageWriter.error(new Error(`[Virid Main] No Window Found: Message target ${i} cannot be found.`))}else e()},"middleWare");var c=require("@virid/core"),v=require("electron");var L="VIRID_INTERNAL_BUS";function y(r,e){e?.electronApp||c.MessageWriter.error(new Error(`[Virid Main] Missing Initialization Parameters:
-electronApp:${e?.electronApp}.`)),v.ipcMain.on(L,(i,o)=>{let{__virid_target:n,__virid_source:t,__virid_messageType:s}=o;if(!n||!t||!s){c.MessageWriter.error(new Error(`[Virid Main] Incomplete Message: The message is incomplete and requires __virid_target${n}, __virid_source${t}, __virid_messageType${s}`));return}if(s==="VIRID_INTERNAL_REGISTER"){let d=v.BrowserWindow.fromWebContents(i.sender);if(!d){c.MessageWriter.error(new Error("[Virid Main] unknown Window: Unable to find the window corresponding to event.sender"));return}if(_.has(t)){c.MessageWriter.error(new Error(`[Virid Main] Duplicate Registration: This ID has already been registered: ${t}`));return}_.set(t,d),d.once("closed",()=>{_.delete(t),c.MessageWriter.info(`[Virid Main] Window unregistered: ${t}`)}),c.MessageWriter.info(`[Virid Main] Window registered: ${t}`);return}T(o)}),r.useMiddleware(R)}a(y,"activateApp");var S={name:"@virid/main",install(r,e){y(r,e)}};0&&(module.exports={FromRender,FromRenderMessage,MainPlugin,ROUTER_MAP,ToRenderMessage,VIRID_CHANNEL,middleWare,processMessage});
+var g=Object.defineProperty;var A=Object.getOwnPropertyDescriptor;var V=Object.getOwnPropertyNames;var W=Object.prototype.hasOwnProperty;var h=(r,e,i)=>e in r?g(r,e,{enumerable:!0,configurable:!0,writable:!0,value:i}):r[e]=i;var a=(r,e)=>g(r,"name",{value:e,configurable:!0});var N=(r,e)=>{for(var i in e)g(r,i,{get:e[i],enumerable:!0})},$=(r,e,i,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of V(e))!W.call(r,n)&&n!==i&&g(r,n,{get:()=>e[n],enumerable:!(o=A(e,n))||o.enumerable});return r};var b=r=>$(g({},"__esModule",{value:!0}),r);var p=(r,e,i)=>h(r,typeof e!="symbol"?e+"":e,i);var U={};N(U,{FromRenderer:()=>C,FromRendererMessage:()=>M,MainPlugin:()=>S,ROUTER_MAP:()=>_,ToRendererMessage:()=>f,VIRID_CHANNEL:()=>u,middleWare:()=>R,processMessage:()=>T});module.exports=b(U);var E=require("@virid/core");var I=class I extends E.EventMessage{constructor(){super(...arguments);p(this,"__virid_source","unknown");p(this,"__virid_target","unknown");p(this,"__virid_messageType","unknown");p(this,"senderWindow",null)}};a(I,"FromRendererMessage");var M=I,m=class m extends E.EventMessage{};a(m,"ToRendererMessage"),p(m,"__virid_source","main");var f=m;var x=require("@virid/core");var l=require("@virid/core");var u="VIRID_INTERNAL_BUS",_=new Map,w=new Map;function C(r){return function(e){w.has(r)&&l.MessageWriter.warn(`[Virid Main] Duplicate IpcMessage: Registration for type: ${r}`),w.set(r,e)}}a(C,"FromRenderer");function D(r){let{__virid_source:e,__virid_messageType:i,__virid_target:o,payload:n}=r;if(!w.has(i)){l.MessageWriter.error(new Error(`[Virid Main] unknown Message Type: Cannot find ${i} in the main process registry.`));return}let t=w.get(i),s=new t;n&&Object.assign(s,n),s.__virid_source=e,s.__virid_target=o,s.__virid_messageType=i;let d=_.get(e);d&&(s.senderWindow=d),l.MessageWriter.write(s)}a(D,"ReceiveMessages");function k(r){let{__virid_source:e,__virid_messageType:i,__virid_target:o,payload:n}=r,t=_.get(o);if(!t){l.MessageWriter.error(new Error(`[Virid Main] unknown Window: Cannot find ${o} in the windows registry.`));return}t.webContents.send(u,{__virid_source:e,__virid_messageType:i,__virid_target:o,payload:n})}a(k,"TransmitMessages");function P(r){let{__virid_source:e,__virid_messageType:i,__virid_target:o,payload:n}=r;_.forEach(t=>{t.webContents.send(u,{__virid_source:e,__virid_messageType:i,__virid_target:o,payload:n})})}a(P,"broadcastMessage");function T(r){let{__virid_target:e,__virid_source:i,__virid_messageType:o}=r;return e==="main"?D(r):e==="all"||e==="*"?P(r):k(r)}a(T,"processMessage");var R=a((r,e)=>{if(r instanceof f){let{__virid_target:i,__virid_messageType:o,...n}=r;i=="main"&&x.MessageWriter.warn(`[Virid Main] Prohibit Sending To Oneself: ${i} is not allowed in ToRendererMessage.`);let t={__virid_source:f.__virid_source,__virid_target:i,__virid_messageType:o,payload:n},s=i==="*"||i==="all"?Array.from(_.values()):[_.get(i)].filter(Boolean);s.length>0?s.forEach(d=>d.webContents.send(u,t)):x.MessageWriter.error(new Error(`[Virid Main] No Window Found: Message target ${i} cannot be found.`))}else e()},"middleWare");var c=require("@virid/core"),v=require("electron");var L="VIRID_INTERNAL_BUS";function y(r,e){e?.electronApp||c.MessageWriter.error(new Error(`[Virid Main] Missing Initialization Parameters:
+electronApp:${e?.electronApp}.`)),v.ipcMain.on(L,(i,o)=>{let{__virid_target:n,__virid_source:t,__virid_messageType:s}=o;if(!n||!t||!s){c.MessageWriter.error(new Error(`[Virid Main] Incomplete Message: The message is incomplete and requires __virid_target${n}, __virid_source${t}, __virid_messageType${s}`));return}if(s==="VIRID_INTERNAL_REGISTER"){let d=v.BrowserWindow.fromWebContents(i.sender);if(!d){c.MessageWriter.error(new Error("[Virid Main] unknown Window: Unable to find the window corresponding to event.sender"));return}if(_.has(t)){c.MessageWriter.error(new Error(`[Virid Main] Duplicate Registration: This ID has already been registered: ${t}`));return}_.set(t,d),d.once("closed",()=>{_.delete(t),c.MessageWriter.info(`[Virid Main] Window unregistered: ${t}`)}),c.MessageWriter.info(`[Virid Main] Window registered: ${t}`);return}T(o)}),r.useMiddleware(R)}a(y,"activateApp");var S={name:"@virid/main",install(r,e){y(r,e)}};0&&(module.exports={FromRenderer,FromRendererMessage,MainPlugin,ROUTER_MAP,ToRendererMessage,VIRID_CHANNEL,middleWare,processMessage});
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/main/message.ts","../src/main/middleware.ts","../src/main/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 main process adapter for Virid, responsible for sending, receiving, and broadcasting rendering process messages.\n */\nexport * from \"./main\";\nexport * from \"./interfaces\";\nimport { ViridPlugin, type ViridApp } from \"@virid/core\";\nimport { type PluginOption } from \"./interfaces\";\nimport { activateApp } from \"./app\";\nexport const MainPlugin: ViridPlugin<PluginOption> = {\n  name: \"@virid/main\",\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 Main\n */\nimport { EventMessage } from \"@virid/core\";\nexport { type SystemContext } from \"@virid/core\";\n/**\n * description: 来自渲染进程的消息\n */\nexport abstract class FromRenderMessage extends EventMessage {\n  //我来自哪？\n  public __virid_source: string = \"unknown\";\n\n  /** 我的目的地是哪儿？\n   * 'main': 发给主进程处理\n   * 'all': 广播给所有窗口（经过主进程中转）\n   * string: 指定某个窗口的 ID (windowId)\n   */\n  public __virid_target: string = \"unknown\";\n\n  //我应该在目的地转变成什么消息？\n  public __virid_messageType: string = \"unknown\";\n  public senderWindow: Electron.BrowserWindow = null as any;\n}\n\n/**\n * description: 要发送给渲染进程的消息\n */\nexport abstract class ToRenderMessage extends EventMessage {\n  // 我来自哪？\n  public static __virid_source = \"main\";\n  /** 我的目的地是哪儿？\n   * 'all': 广播给所有窗口（经过主进程中转）\n   * string: 指定某个窗口的 ID (windowId)\n   */\n  public abstract __virid_target: string;\n  /**\n   * 我应该在目的地转变成什么消息？\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 Main\n */\nimport { type Middleware, MessageWriter } from \"@virid/core\";\nimport { ToRenderMessage } from \"./message\";\nimport { ROUTER_MAP, VIRID_CHANNEL } from \"./router\";\nexport const middleWare: Middleware = (message, next) => {\n  //如果消息是继承自MainRequestMessage，拦截并发往对应的渲染进程\n  if (message instanceof ToRenderMessage) {\n    const { __virid_target, __virid_messageType, ...payload } = message;\n    //不准自己发给自己\n    if (__virid_target == \"main\") {\n      MessageWriter.warn(\n        `[Virid Main] Prohibit Sending To Oneself: ${__virid_target} is not allowed in ToRenderMessage.`,\n      );\n    }\n    // 准备要发送的数据包\n    const packet = {\n      __virid_source: ToRenderMessage.__virid_source,\n      __virid_target,\n      __virid_messageType,\n      payload,\n    };\n\n    const targetWindows =\n      __virid_target === \"*\" || __virid_target === \"all\"\n        ? Array.from(ROUTER_MAP.values())\n        : [ROUTER_MAP.get(__virid_target)].filter(Boolean); // 过滤掉 undefined\n\n    if (targetWindows.length > 0) {\n      targetWindows.forEach((win) =>\n        win!.webContents.send(VIRID_CHANNEL, packet),\n      );\n    } else {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] No Window Found: Message target ${__virid_target} cannot be found.`,\n        ),\n      );\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 Main\n */\nimport { MessageWriter, type Newable } from \"@virid/core\";\nimport { type BrowserWindow } from \"electron\";\nimport { type FromRenderMessage } from \"./message\";\nexport const VIRID_CHANNEL = \"VIRID_INTERNAL_BUS\";\nexport const ROUTER_MAP = new Map<string, BrowserWindow>();\nlet MESSAGE_MAP = new Map<string, Newable<FromRenderMessage>>();\n\nexport function FromRender(type: string) {\n  return function (target: Newable<FromRenderMessage>) {\n    if (MESSAGE_MAP.has(type)) {\n      MessageWriter.warn(\n        `[Virid Main] Duplicate IpcMessage: Registration for type: ${type}`,\n      );\n    }\n    MESSAGE_MAP.set(type, target);\n  };\n}\n//主进程接收消息并发给自己的system\nfunction ReceiveMessages(message: any): void {\n  const { __virid_source, __virid_messageType, __virid_target, payload } =\n    message;\n  if (!MESSAGE_MAP.has(__virid_messageType)) {\n    // 主进程没注册这个消息,直接报错\n    MessageWriter.error(\n      new Error(\n        `[Virid Main] unknown Message Type: Cannot find ${__virid_messageType} in the main process registry.`,\n      ),\n    );\n    return;\n  }\n  // 查找主进程注册的消息类\n  const MessageClass = MESSAGE_MAP.get(__virid_messageType);\n  // 实例化\n  let instance = new (MessageClass as any)();\n  // 数据还原\n  if (payload) {\n    Object.assign(instance, payload);\n  }\n  // 注入身份元数据\n  instance.__virid_source = __virid_source;\n  instance.__virid_target = __virid_target;\n  instance.__virid_messageType = __virid_messageType;\n  // 注入物理上下文\n  const context = ROUTER_MAP.get(__virid_source);\n  if (context) {\n    instance.senderWindow = context;\n  }\n\n  // 派发给主进程的 System 群\n  MessageWriter.write(instance);\n}\n\nfunction TransmitMessages(message: any): void {\n  const { __virid_source, __virid_messageType, __virid_target, payload } =\n    message;\n  // 查找主进程注册的消息类\n  const targetWindow = ROUTER_MAP.get(__virid_target);\n  if (!targetWindow) {\n    // 主进程没注册这个消息,直接报错\n    MessageWriter.error(\n      new Error(\n        `[Virid Main] unknown Window: Cannot find ${__virid_target} in the windows registry.`,\n      ),\n    );\n    return;\n  }\n  targetWindow.webContents.send(VIRID_CHANNEL, {\n    __virid_source,\n    __virid_messageType,\n    __virid_target,\n    payload,\n  });\n}\nfunction broadcastMessage(message: any) {\n  const { __virid_source, __virid_messageType, __virid_target, payload } =\n    message;\n  ROUTER_MAP.forEach((window) => {\n    window.webContents.send(VIRID_CHANNEL, {\n      __virid_source,\n      __virid_messageType,\n      __virid_target,\n      payload,\n    });\n  });\n}\n\nexport function processMessage(message: any) {\n  const { __virid_target, __virid_source, __virid_messageType } = message;\n  if (__virid_target === \"main\") return ReceiveMessages(message);\n  else if (__virid_target === \"all\" || __virid_target === \"*\")\n    return broadcastMessage(message);\n  else return TransmitMessages(message);\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Main\n */\nconst VIRID_CHANNEL = \"VIRID_INTERNAL_BUS\";\nimport { type ViridApp, MessageWriter } from \"@virid/core\";\nimport { BrowserWindow, ipcMain } from \"electron\";\nimport { middleWare, processMessage, ROUTER_MAP } from \"./main\";\nimport { type PluginOption } from \"./interfaces\";\nexport function activateApp(app: ViridApp, options: PluginOption) {\n  //检查参数\n  if (!options?.electronApp) {\n    MessageWriter.error(\n      new Error(\n        `[Virid Main] Missing Initialization Parameters:\\nelectronApp:${options?.electronApp}.`,\n      ),\n    );\n  }\n  //绑定electron主进程回调\n  ipcMain.on(VIRID_CHANNEL, (event, message) => {\n    const { __virid_target, __virid_source, __virid_messageType } = message;\n    if (!__virid_target || !__virid_source || !__virid_messageType) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] Incomplete Message: The message is incomplete and requires __virid_target${__virid_target}, __virid_source${__virid_source}, __virid_messageType${__virid_messageType}`,\n        ),\n      );\n      return;\n    }\n    // 如果是注册消息，那么注册这个渲染进程\n    if (__virid_messageType === \"VIRID_INTERNAL_REGISTER\") {\n      // 通过 event.sender 拿到物理实例，并与逻辑 ID 绑定\n      const win = BrowserWindow.fromWebContents(event.sender);\n      //找不见窗口，报错\n      if (!win) {\n        MessageWriter.error(\n          new Error(\n            `[Virid Main] unknown Window: Unable to find the window corresponding to event.sender`,\n          ),\n        );\n        return;\n      }\n      //如果已经存在了，报错\n      if (ROUTER_MAP.has(__virid_source)) {\n        MessageWriter.error(\n          new Error(\n            `[Virid Main] Duplicate Registration: This ID has already been registered: ${__virid_source}`,\n          ),\n        );\n        return;\n      }\n      // 存入路由表\n      ROUTER_MAP.set(__virid_source, win);\n      // 关闭时自动删除自己\n      win.once(\"closed\", () => {\n        ROUTER_MAP.delete(__virid_source);\n        MessageWriter.info(\n          `[Virid Main] Window unregistered: ${__virid_source}`,\n        );\n      });\n      MessageWriter.info(`[Virid Main] Window registered: ${__virid_source}`);\n      return;\n    }\n    //分发消息\n    processMessage(message);\n  });\n  //注册自己的中间件函数，把ToRenderMessage拦截发往指定的渲染进程\n  app.useMiddleware(middleWare);\n}\n"],"mappings":"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","names":["index_exports","__export","FromRender","FromRenderMessage","MainPlugin","ROUTER_MAP","ToRenderMessage","VIRID_CHANNEL","middleWare","processMessage","__toCommonJS","import_core","FromRenderMessage","EventMessage","__virid_source","__virid_target","__virid_messageType","senderWindow","_FromRenderMessage","ToRenderMessage","__publicField","_ToRenderMessage","import_core","import_core","VIRID_CHANNEL","ROUTER_MAP","Map","MESSAGE_MAP","FromRender","type","target","has","MessageWriter","warn","set","ReceiveMessages","message","__virid_source","__virid_messageType","__virid_target","payload","error","Error","MessageClass","get","instance","Object","assign","context","senderWindow","write","TransmitMessages","targetWindow","webContents","send","broadcastMessage","forEach","window","processMessage","middleWare","__name","message","next","ToRenderMessage","__virid_target","__virid_messageType","payload","MessageWriter","warn","packet","__virid_source","targetWindows","Array","from","ROUTER_MAP","values","get","filter","Boolean","length","forEach","win","webContents","send","VIRID_CHANNEL","error","Error","import_core","import_electron","VIRID_CHANNEL","activateApp","app","options","electronApp","MessageWriter","error","Error","ipcMain","on","event","message","__virid_target","__virid_source","__virid_messageType","win","BrowserWindow","fromWebContents","sender","ROUTER_MAP","has","set","once","delete","info","processMessage","useMiddleware","middleWare","MainPlugin","name","install","app","options","activateApp"]}
+{"version":3,"sources":["../src/index.ts","../src/main/message.ts","../src/main/middleware.ts","../src/main/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 main process adapter for Virid, responsible for sending, receiving, and broadcasting rendering process messages.\n */\nexport * from \"./main\";\nexport * from \"./interfaces\";\nimport { ViridPlugin, type ViridApp } from \"@virid/core\";\nimport { type PluginOption } from \"./interfaces\";\nimport { activateApp } from \"./app\";\nexport const MainPlugin: ViridPlugin<PluginOption> = {\n  name: \"@virid/main\",\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 Main\n */\nimport { EventMessage } from \"@virid/core\";\nexport { type SystemContext } from \"@virid/core\";\n/**\n * description: 来自渲染进程的消息\n */\nexport abstract class FromRendererMessage extends EventMessage {\n  //我来自哪？\n  public __virid_source: string = \"unknown\";\n\n  /** 我的目的地是哪儿？\n   * 'main': 发给主进程处理\n   * 'all': 广播给所有窗口（经过主进程中转）\n   * string: 指定某个窗口的 ID (windowId)\n   */\n  public __virid_target: string = \"unknown\";\n\n  //我应该在目的地转变成什么消息？\n  public __virid_messageType: string = \"unknown\";\n  public senderWindow: Electron.BrowserWindow = null as any;\n}\n\n/**\n * description: 要发送给渲染进程的消息\n */\nexport abstract class ToRendererMessage extends EventMessage {\n  // 我来自哪？\n  public static __virid_source = \"main\";\n  /** 我的目的地是哪儿？\n   * 'all': 广播给所有窗口（经过主进程中转）\n   * string: 指定某个窗口的 ID (windowId)\n   */\n  public abstract __virid_target: string;\n  /**\n   * 我应该在目的地转变成什么消息？\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 Main\n */\nimport { type Middleware, MessageWriter } from \"@virid/core\";\nimport { ToRendererMessage } from \"./message\";\nimport { ROUTER_MAP, VIRID_CHANNEL } from \"./router\";\nexport const middleWare: Middleware = (message, next) => {\n  //如果消息是继承自MainRequestMessage，拦截并发往对应的渲染进程\n  if (message instanceof ToRendererMessage) {\n    const { __virid_target, __virid_messageType, ...payload } = message;\n    //不准自己发给自己\n    if (__virid_target == \"main\") {\n      MessageWriter.warn(\n        `[Virid Main] Prohibit Sending To Oneself: ${__virid_target} is not allowed in ToRendererMessage.`,\n      );\n    }\n    // 准备要发送的数据包\n    const packet = {\n      __virid_source: ToRendererMessage.__virid_source,\n      __virid_target,\n      __virid_messageType,\n      payload,\n    };\n\n    const targetWindows =\n      __virid_target === \"*\" || __virid_target === \"all\"\n        ? Array.from(ROUTER_MAP.values())\n        : [ROUTER_MAP.get(__virid_target)].filter(Boolean); // 过滤掉 undefined\n\n    if (targetWindows.length > 0) {\n      targetWindows.forEach((win) =>\n        win!.webContents.send(VIRID_CHANNEL, packet),\n      );\n    } else {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] No Window Found: Message target ${__virid_target} cannot be found.`,\n        ),\n      );\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 Main\n */\nimport { MessageWriter, type Newable } from \"@virid/core\";\nimport { type BrowserWindow } from \"electron\";\nimport { type FromRendererMessage } from \"./message\";\nexport const VIRID_CHANNEL = \"VIRID_INTERNAL_BUS\";\nexport const ROUTER_MAP = new Map<string, BrowserWindow>();\nlet MESSAGE_MAP = new Map<string, Newable<FromRendererMessage>>();\n\nexport function FromRenderer(type: string) {\n  return function (target: Newable<FromRendererMessage>) {\n    if (MESSAGE_MAP.has(type)) {\n      MessageWriter.warn(\n        `[Virid Main] Duplicate IpcMessage: Registration for type: ${type}`,\n      );\n    }\n    MESSAGE_MAP.set(type, target);\n  };\n}\n//主进程接收消息并发给自己的system\nfunction ReceiveMessages(message: any): void {\n  const { __virid_source, __virid_messageType, __virid_target, payload } =\n    message;\n  if (!MESSAGE_MAP.has(__virid_messageType)) {\n    // 主进程没注册这个消息,直接报错\n    MessageWriter.error(\n      new Error(\n        `[Virid Main] unknown Message Type: Cannot find ${__virid_messageType} in the main process registry.`,\n      ),\n    );\n    return;\n  }\n  // 查找主进程注册的消息类\n  const MessageClass = MESSAGE_MAP.get(__virid_messageType);\n  // 实例化\n  let instance = new (MessageClass as any)();\n  // 数据还原\n  if (payload) {\n    Object.assign(instance, payload);\n  }\n  // 注入身份元数据\n  instance.__virid_source = __virid_source;\n  instance.__virid_target = __virid_target;\n  instance.__virid_messageType = __virid_messageType;\n  // 注入物理上下文\n  const context = ROUTER_MAP.get(__virid_source);\n  if (context) {\n    instance.senderWindow = context;\n  }\n\n  // 派发给主进程的 System 群\n  MessageWriter.write(instance);\n}\n\nfunction TransmitMessages(message: any): void {\n  const { __virid_source, __virid_messageType, __virid_target, payload } =\n    message;\n  // 查找主进程注册的消息类\n  const targetWindow = ROUTER_MAP.get(__virid_target);\n  if (!targetWindow) {\n    // 主进程没注册这个消息,直接报错\n    MessageWriter.error(\n      new Error(\n        `[Virid Main] unknown Window: Cannot find ${__virid_target} in the windows registry.`,\n      ),\n    );\n    return;\n  }\n  targetWindow.webContents.send(VIRID_CHANNEL, {\n    __virid_source,\n    __virid_messageType,\n    __virid_target,\n    payload,\n  });\n}\nfunction broadcastMessage(message: any) {\n  const { __virid_source, __virid_messageType, __virid_target, payload } =\n    message;\n  ROUTER_MAP.forEach((window) => {\n    window.webContents.send(VIRID_CHANNEL, {\n      __virid_source,\n      __virid_messageType,\n      __virid_target,\n      payload,\n    });\n  });\n}\n\nexport function processMessage(message: any) {\n  const { __virid_target, __virid_source, __virid_messageType } = message;\n  if (__virid_target === \"main\") return ReceiveMessages(message);\n  else if (__virid_target === \"all\" || __virid_target === \"*\")\n    return broadcastMessage(message);\n  else return TransmitMessages(message);\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Main\n */\nconst VIRID_CHANNEL = \"VIRID_INTERNAL_BUS\";\nimport { type ViridApp, MessageWriter } from \"@virid/core\";\nimport { BrowserWindow, ipcMain } from \"electron\";\nimport { middleWare, processMessage, ROUTER_MAP } from \"./main\";\nimport { type PluginOption } from \"./interfaces\";\nexport function activateApp(app: ViridApp, options: PluginOption) {\n  //检查参数\n  if (!options?.electronApp) {\n    MessageWriter.error(\n      new Error(\n        `[Virid Main] Missing Initialization Parameters:\\nelectronApp:${options?.electronApp}.`,\n      ),\n    );\n  }\n  //绑定electron主进程回调\n  ipcMain.on(VIRID_CHANNEL, (event, message) => {\n    const { __virid_target, __virid_source, __virid_messageType } = message;\n    if (!__virid_target || !__virid_source || !__virid_messageType) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] Incomplete Message: The message is incomplete and requires __virid_target${__virid_target}, __virid_source${__virid_source}, __virid_messageType${__virid_messageType}`,\n        ),\n      );\n      return;\n    }\n    // 如果是注册消息，那么注册这个渲染进程\n    if (__virid_messageType === \"VIRID_INTERNAL_REGISTER\") {\n      // 通过 event.sender 拿到物理实例，并与逻辑 ID 绑定\n      const win = BrowserWindow.fromWebContents(event.sender);\n      //找不见窗口，报错\n      if (!win) {\n        MessageWriter.error(\n          new Error(\n            `[Virid Main] unknown Window: Unable to find the window corresponding to event.sender`,\n          ),\n        );\n        return;\n      }\n      //如果已经存在了，报错\n      if (ROUTER_MAP.has(__virid_source)) {\n        MessageWriter.error(\n          new Error(\n            `[Virid Main] Duplicate Registration: This ID has already been registered: ${__virid_source}`,\n          ),\n        );\n        return;\n      }\n      // 存入路由表\n      ROUTER_MAP.set(__virid_source, win);\n      // 关闭时自动删除自己\n      win.once(\"closed\", () => {\n        ROUTER_MAP.delete(__virid_source);\n        MessageWriter.info(\n          `[Virid Main] Window unregistered: ${__virid_source}`,\n        );\n      });\n      MessageWriter.info(`[Virid Main] Window registered: ${__virid_source}`);\n      return;\n    }\n    //分发消息\n    processMessage(message);\n  });\n  //注册自己的中间件函数，把ToRenderMessage拦截发往指定的渲染进程\n  app.useMiddleware(middleWare);\n}\n"],"mappings":"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","names":["index_exports","__export","FromRenderer","FromRendererMessage","MainPlugin","ROUTER_MAP","ToRendererMessage","VIRID_CHANNEL","middleWare","processMessage","__toCommonJS","import_core","FromRendererMessage","EventMessage","__virid_source","__virid_target","__virid_messageType","senderWindow","_FromRendererMessage","ToRendererMessage","__publicField","_ToRendererMessage","import_core","import_core","VIRID_CHANNEL","ROUTER_MAP","Map","MESSAGE_MAP","FromRenderer","type","target","has","MessageWriter","warn","set","ReceiveMessages","message","__virid_source","__virid_messageType","__virid_target","payload","error","Error","MessageClass","get","instance","Object","assign","context","senderWindow","write","TransmitMessages","targetWindow","webContents","send","broadcastMessage","forEach","window","processMessage","middleWare","__name","message","next","ToRendererMessage","__virid_target","__virid_messageType","payload","MessageWriter","warn","packet","__virid_source","targetWindows","Array","from","ROUTER_MAP","values","get","filter","Boolean","length","forEach","win","webContents","send","VIRID_CHANNEL","error","Error","import_core","import_electron","VIRID_CHANNEL","activateApp","app","options","electronApp","MessageWriter","error","Error","ipcMain","on","event","message","__virid_target","__virid_source","__virid_messageType","win","BrowserWindow","fromWebContents","sender","ROUTER_MAP","has","set","once","delete","info","processMessage","useMiddleware","middleWare","MainPlugin","name","install","app","options","activateApp"]}

package/dist/index.d.cts

@@ -5,7 +5,7 @@ import { BrowserWindow, App } from 'electron';
 /**
  * description: 来自渲染进程的消息
  */
-declare abstract class FromRenderMessage extends EventMessage {
+declare abstract class FromRendererMessage extends EventMessage {
     __virid_source: string;
     /** 我的目的地是哪儿？
      * 'main': 发给主进程处理
@@ -19,7 +19,7 @@ declare abstract class FromRenderMessage extends EventMessage {
 /**
  * description: 要发送给渲染进程的消息
  */
-declare abstract class ToRenderMessage extends EventMessage {
+declare abstract class ToRendererMessage extends EventMessage {
     static __virid_source: string;
     /** 我的目的地是哪儿？
      * 'all': 广播给所有窗口（经过主进程中转）
@@ -36,7 +36,7 @@ declare const middleWare: Middleware;
 
 declare const VIRID_CHANNEL = "VIRID_INTERNAL_BUS";
 declare const ROUTER_MAP: Map<string, BrowserWindow>;
-declare function FromRender(type: string): (target: Newable<FromRenderMessage>) => void;
+declare function FromRenderer(type: string): (target: Newable<FromRendererMessage>) => void;
 declare function processMessage(message: any): void;
 
 interface PluginOption {
@@ -48,4 +48,4 @@ interface PluginOption {
 
 declare const MainPlugin: ViridPlugin<PluginOption>;
 
-export { FromRender, FromRenderMessage, MainPlugin, type PluginOption, ROUTER_MAP, ToRenderMessage, VIRID_CHANNEL, middleWare, processMessage };
+export { FromRenderer, FromRendererMessage, MainPlugin, type PluginOption, ROUTER_MAP, ToRendererMessage, VIRID_CHANNEL, middleWare, processMessage };

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import { BrowserWindow, App } from 'electron';
 /**
  * description: 来自渲染进程的消息
  */
-declare abstract class FromRenderMessage extends EventMessage {
+declare abstract class FromRendererMessage extends EventMessage {
     __virid_source: string;
     /** 我的目的地是哪儿？
      * 'main': 发给主进程处理
@@ -19,7 +19,7 @@ declare abstract class FromRenderMessage extends EventMessage {
 /**
  * description: 要发送给渲染进程的消息
  */
-declare abstract class ToRenderMessage extends EventMessage {
+declare abstract class ToRendererMessage extends EventMessage {
     static __virid_source: string;
     /** 我的目的地是哪儿？
      * 'all': 广播给所有窗口（经过主进程中转）
@@ -36,7 +36,7 @@ declare const middleWare: Middleware;
 
 declare const VIRID_CHANNEL = "VIRID_INTERNAL_BUS";
 declare const ROUTER_MAP: Map<string, BrowserWindow>;
-declare function FromRender(type: string): (target: Newable<FromRenderMessage>) => void;
+declare function FromRenderer(type: string): (target: Newable<FromRendererMessage>) => void;
 declare function processMessage(message: any): void;
 
 interface PluginOption {
@@ -48,4 +48,4 @@ interface PluginOption {
 
 declare const MainPlugin: ViridPlugin<PluginOption>;
 
-export { FromRender, FromRenderMessage, MainPlugin, type PluginOption, ROUTER_MAP, ToRenderMessage, VIRID_CHANNEL, middleWare, processMessage };
+export { FromRenderer, FromRendererMessage, MainPlugin, type PluginOption, ROUTER_MAP, ToRendererMessage, VIRID_CHANNEL, middleWare, processMessage };

package/dist/index.js

@@ -1,7 +1,7 @@
 /**
- *  @virid/main v0.0.1
+ *  @virid/main v0.1.1
  *  Electron main process adapter for Virid, responsible for sending, receiving, and broadcasting rendering process messages
  */
-var v=Object.defineProperty;var y=(r,e,i)=>e in r?v(r,e,{enumerable:!0,configurable:!0,writable:!0,value:i}):r[e]=i;var s=(r,e)=>v(r,"name",{value:e,configurable:!0});var c=(r,e,i)=>y(r,typeof e!="symbol"?e+"":e,i);import{EventMessage as E}from"@virid/core";var w=class w extends E{constructor(){super(...arguments);c(this,"__virid_source","unknown");c(this,"__virid_target","unknown");c(this,"__virid_messageType","unknown");c(this,"senderWindow",null)}};s(w,"FromRenderMessage");var M=w,g=class g extends E{};s(g,"ToRenderMessage"),c(g,"__virid_source","main");var f=g;import{MessageWriter as T}from"@virid/core";import{MessageWriter as l}from"@virid/core";var m="VIRID_INTERNAL_BUS",_=new Map,u=new Map;function L(r){return function(e){u.has(r)&&l.warn(`[Virid Main] Duplicate IpcMessage: Registration for type: ${r}`),u.set(r,e)}}s(L,"FromRender");function A(r){let{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:a}=r;if(!u.has(i)){l.error(new Error(`[Virid Main] unknown Message Type: Cannot find ${i} in the main process registry.`));return}let n=u.get(i),o=new n;a&&Object.assign(o,a),o.__virid_source=e,o.__virid_target=t,o.__virid_messageType=i;let d=_.get(e);d&&(o.senderWindow=d),l.write(o)}s(A,"ReceiveMessages");function V(r){let{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:a}=r,n=_.get(t);if(!n){l.error(new Error(`[Virid Main] unknown Window: Cannot find ${t} in the windows registry.`));return}n.webContents.send(m,{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:a})}s(V,"TransmitMessages");function W(r){let{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:a}=r;_.forEach(n=>{n.webContents.send(m,{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:a})})}s(W,"broadcastMessage");function I(r){let{__virid_target:e,__virid_source:i,__virid_messageType:t}=r;return e==="main"?A(r):e==="all"||e==="*"?W(r):V(r)}s(I,"processMessage");var x=s((r,e)=>{if(r instanceof f){let{__virid_target:i,__virid_messageType:t,...a}=r;i=="main"&&T.warn(`[Virid Main] Prohibit Sending To Oneself: ${i} is not allowed in ToRenderMessage.`);let n={__virid_source:f.__virid_source,__virid_target:i,__virid_messageType:t,payload:a},o=i==="*"||i==="all"?Array.from(_.values()):[_.get(i)].filter(Boolean);o.length>0?o.forEach(d=>d.webContents.send(m,n)):T.error(new Error(`[Virid Main] No Window Found: Message target ${i} cannot be found.`))}else e()},"middleWare");import{MessageWriter as p}from"@virid/core";import{BrowserWindow as N,ipcMain as $}from"electron";var h="VIRID_INTERNAL_BUS";function R(r,e){e?.electronApp||p.error(new Error(`[Virid Main] Missing Initialization Parameters:
-electronApp:${e?.electronApp}.`)),$.on(h,(i,t)=>{let{__virid_target:a,__virid_source:n,__virid_messageType:o}=t;if(!a||!n||!o){p.error(new Error(`[Virid Main] Incomplete Message: The message is incomplete and requires __virid_target${a}, __virid_source${n}, __virid_messageType${o}`));return}if(o==="VIRID_INTERNAL_REGISTER"){let d=N.fromWebContents(i.sender);if(!d){p.error(new Error("[Virid Main] unknown Window: Unable to find the window corresponding to event.sender"));return}if(_.has(n)){p.error(new Error(`[Virid Main] Duplicate Registration: This ID has already been registered: ${n}`));return}_.set(n,d),d.once("closed",()=>{_.delete(n),p.info(`[Virid Main] Window unregistered: ${n}`)}),p.info(`[Virid Main] Window registered: ${n}`);return}I(t)}),r.useMiddleware(x)}s(R,"activateApp");var re={name:"@virid/main",install(r,e){R(r,e)}};export{L as FromRender,M as FromRenderMessage,re as MainPlugin,_ as ROUTER_MAP,f as ToRenderMessage,m as VIRID_CHANNEL,x as middleWare,I as processMessage};
+var v=Object.defineProperty;var y=(r,e,i)=>e in r?v(r,e,{enumerable:!0,configurable:!0,writable:!0,value:i}):r[e]=i;var s=(r,e)=>v(r,"name",{value:e,configurable:!0});var c=(r,e,i)=>y(r,typeof e!="symbol"?e+"":e,i);import{EventMessage as E}from"@virid/core";var w=class w extends E{constructor(){super(...arguments);c(this,"__virid_source","unknown");c(this,"__virid_target","unknown");c(this,"__virid_messageType","unknown");c(this,"senderWindow",null)}};s(w,"FromRendererMessage");var M=w,g=class g extends E{};s(g,"ToRendererMessage"),c(g,"__virid_source","main");var f=g;import{MessageWriter as T}from"@virid/core";import{MessageWriter as l}from"@virid/core";var m="VIRID_INTERNAL_BUS",_=new Map,u=new Map;function L(r){return function(e){u.has(r)&&l.warn(`[Virid Main] Duplicate IpcMessage: Registration for type: ${r}`),u.set(r,e)}}s(L,"FromRenderer");function A(r){let{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:a}=r;if(!u.has(i)){l.error(new Error(`[Virid Main] unknown Message Type: Cannot find ${i} in the main process registry.`));return}let n=u.get(i),o=new n;a&&Object.assign(o,a),o.__virid_source=e,o.__virid_target=t,o.__virid_messageType=i;let d=_.get(e);d&&(o.senderWindow=d),l.write(o)}s(A,"ReceiveMessages");function V(r){let{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:a}=r,n=_.get(t);if(!n){l.error(new Error(`[Virid Main] unknown Window: Cannot find ${t} in the windows registry.`));return}n.webContents.send(m,{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:a})}s(V,"TransmitMessages");function W(r){let{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:a}=r;_.forEach(n=>{n.webContents.send(m,{__virid_source:e,__virid_messageType:i,__virid_target:t,payload:a})})}s(W,"broadcastMessage");function I(r){let{__virid_target:e,__virid_source:i,__virid_messageType:t}=r;return e==="main"?A(r):e==="all"||e==="*"?W(r):V(r)}s(I,"processMessage");var x=s((r,e)=>{if(r instanceof f){let{__virid_target:i,__virid_messageType:t,...a}=r;i=="main"&&T.warn(`[Virid Main] Prohibit Sending To Oneself: ${i} is not allowed in ToRendererMessage.`);let n={__virid_source:f.__virid_source,__virid_target:i,__virid_messageType:t,payload:a},o=i==="*"||i==="all"?Array.from(_.values()):[_.get(i)].filter(Boolean);o.length>0?o.forEach(d=>d.webContents.send(m,n)):T.error(new Error(`[Virid Main] No Window Found: Message target ${i} cannot be found.`))}else e()},"middleWare");import{MessageWriter as p}from"@virid/core";import{BrowserWindow as N,ipcMain as $}from"electron";var h="VIRID_INTERNAL_BUS";function R(r,e){e?.electronApp||p.error(new Error(`[Virid Main] Missing Initialization Parameters:
+electronApp:${e?.electronApp}.`)),$.on(h,(i,t)=>{let{__virid_target:a,__virid_source:n,__virid_messageType:o}=t;if(!a||!n||!o){p.error(new Error(`[Virid Main] Incomplete Message: The message is incomplete and requires __virid_target${a}, __virid_source${n}, __virid_messageType${o}`));return}if(o==="VIRID_INTERNAL_REGISTER"){let d=N.fromWebContents(i.sender);if(!d){p.error(new Error("[Virid Main] unknown Window: Unable to find the window corresponding to event.sender"));return}if(_.has(n)){p.error(new Error(`[Virid Main] Duplicate Registration: This ID has already been registered: ${n}`));return}_.set(n,d),d.once("closed",()=>{_.delete(n),p.info(`[Virid Main] Window unregistered: ${n}`)}),p.info(`[Virid Main] Window registered: ${n}`);return}I(t)}),r.useMiddleware(x)}s(R,"activateApp");var re={name:"@virid/main",install(r,e){R(r,e)}};export{L as FromRenderer,M as FromRendererMessage,re as MainPlugin,_ as ROUTER_MAP,f as ToRendererMessage,m as VIRID_CHANNEL,x as middleWare,I as processMessage};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/main/message.ts","../src/main/middleware.ts","../src/main/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 Main\n */\nimport { EventMessage } from \"@virid/core\";\nexport { type SystemContext } from \"@virid/core\";\n/**\n * description: 来自渲染进程的消息\n */\nexport abstract class FromRenderMessage extends EventMessage {\n  //我来自哪？\n  public __virid_source: string = \"unknown\";\n\n  /** 我的目的地是哪儿？\n   * 'main': 发给主进程处理\n   * 'all': 广播给所有窗口（经过主进程中转）\n   * string: 指定某个窗口的 ID (windowId)\n   */\n  public __virid_target: string = \"unknown\";\n\n  //我应该在目的地转变成什么消息？\n  public __virid_messageType: string = \"unknown\";\n  public senderWindow: Electron.BrowserWindow = null as any;\n}\n\n/**\n * description: 要发送给渲染进程的消息\n */\nexport abstract class ToRenderMessage extends EventMessage {\n  // 我来自哪？\n  public static __virid_source = \"main\";\n  /** 我的目的地是哪儿？\n   * 'all': 广播给所有窗口（经过主进程中转）\n   * string: 指定某个窗口的 ID (windowId)\n   */\n  public abstract __virid_target: string;\n  /**\n   * 我应该在目的地转变成什么消息？\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 Main\n */\nimport { type Middleware, MessageWriter } from \"@virid/core\";\nimport { ToRenderMessage } from \"./message\";\nimport { ROUTER_MAP, VIRID_CHANNEL } from \"./router\";\nexport const middleWare: Middleware = (message, next) => {\n  //如果消息是继承自MainRequestMessage，拦截并发往对应的渲染进程\n  if (message instanceof ToRenderMessage) {\n    const { __virid_target, __virid_messageType, ...payload } = message;\n    //不准自己发给自己\n    if (__virid_target == \"main\") {\n      MessageWriter.warn(\n        `[Virid Main] Prohibit Sending To Oneself: ${__virid_target} is not allowed in ToRenderMessage.`,\n      );\n    }\n    // 准备要发送的数据包\n    const packet = {\n      __virid_source: ToRenderMessage.__virid_source,\n      __virid_target,\n      __virid_messageType,\n      payload,\n    };\n\n    const targetWindows =\n      __virid_target === \"*\" || __virid_target === \"all\"\n        ? Array.from(ROUTER_MAP.values())\n        : [ROUTER_MAP.get(__virid_target)].filter(Boolean); // 过滤掉 undefined\n\n    if (targetWindows.length > 0) {\n      targetWindows.forEach((win) =>\n        win!.webContents.send(VIRID_CHANNEL, packet),\n      );\n    } else {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] No Window Found: Message target ${__virid_target} cannot be found.`,\n        ),\n      );\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 Main\n */\nimport { MessageWriter, type Newable } from \"@virid/core\";\nimport { type BrowserWindow } from \"electron\";\nimport { type FromRenderMessage } from \"./message\";\nexport const VIRID_CHANNEL = \"VIRID_INTERNAL_BUS\";\nexport const ROUTER_MAP = new Map<string, BrowserWindow>();\nlet MESSAGE_MAP = new Map<string, Newable<FromRenderMessage>>();\n\nexport function FromRender(type: string) {\n  return function (target: Newable<FromRenderMessage>) {\n    if (MESSAGE_MAP.has(type)) {\n      MessageWriter.warn(\n        `[Virid Main] Duplicate IpcMessage: Registration for type: ${type}`,\n      );\n    }\n    MESSAGE_MAP.set(type, target);\n  };\n}\n//主进程接收消息并发给自己的system\nfunction ReceiveMessages(message: any): void {\n  const { __virid_source, __virid_messageType, __virid_target, payload } =\n    message;\n  if (!MESSAGE_MAP.has(__virid_messageType)) {\n    // 主进程没注册这个消息,直接报错\n    MessageWriter.error(\n      new Error(\n        `[Virid Main] unknown Message Type: Cannot find ${__virid_messageType} in the main process registry.`,\n      ),\n    );\n    return;\n  }\n  // 查找主进程注册的消息类\n  const MessageClass = MESSAGE_MAP.get(__virid_messageType);\n  // 实例化\n  let instance = new (MessageClass as any)();\n  // 数据还原\n  if (payload) {\n    Object.assign(instance, payload);\n  }\n  // 注入身份元数据\n  instance.__virid_source = __virid_source;\n  instance.__virid_target = __virid_target;\n  instance.__virid_messageType = __virid_messageType;\n  // 注入物理上下文\n  const context = ROUTER_MAP.get(__virid_source);\n  if (context) {\n    instance.senderWindow = context;\n  }\n\n  // 派发给主进程的 System 群\n  MessageWriter.write(instance);\n}\n\nfunction TransmitMessages(message: any): void {\n  const { __virid_source, __virid_messageType, __virid_target, payload } =\n    message;\n  // 查找主进程注册的消息类\n  const targetWindow = ROUTER_MAP.get(__virid_target);\n  if (!targetWindow) {\n    // 主进程没注册这个消息,直接报错\n    MessageWriter.error(\n      new Error(\n        `[Virid Main] unknown Window: Cannot find ${__virid_target} in the windows registry.`,\n      ),\n    );\n    return;\n  }\n  targetWindow.webContents.send(VIRID_CHANNEL, {\n    __virid_source,\n    __virid_messageType,\n    __virid_target,\n    payload,\n  });\n}\nfunction broadcastMessage(message: any) {\n  const { __virid_source, __virid_messageType, __virid_target, payload } =\n    message;\n  ROUTER_MAP.forEach((window) => {\n    window.webContents.send(VIRID_CHANNEL, {\n      __virid_source,\n      __virid_messageType,\n      __virid_target,\n      payload,\n    });\n  });\n}\n\nexport function processMessage(message: any) {\n  const { __virid_target, __virid_source, __virid_messageType } = message;\n  if (__virid_target === \"main\") return ReceiveMessages(message);\n  else if (__virid_target === \"all\" || __virid_target === \"*\")\n    return broadcastMessage(message);\n  else return TransmitMessages(message);\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Main\n */\nconst VIRID_CHANNEL = \"VIRID_INTERNAL_BUS\";\nimport { type ViridApp, MessageWriter } from \"@virid/core\";\nimport { BrowserWindow, ipcMain } from \"electron\";\nimport { middleWare, processMessage, ROUTER_MAP } from \"./main\";\nimport { type PluginOption } from \"./interfaces\";\nexport function activateApp(app: ViridApp, options: PluginOption) {\n  //检查参数\n  if (!options?.electronApp) {\n    MessageWriter.error(\n      new Error(\n        `[Virid Main] Missing Initialization Parameters:\\nelectronApp:${options?.electronApp}.`,\n      ),\n    );\n  }\n  //绑定electron主进程回调\n  ipcMain.on(VIRID_CHANNEL, (event, message) => {\n    const { __virid_target, __virid_source, __virid_messageType } = message;\n    if (!__virid_target || !__virid_source || !__virid_messageType) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] Incomplete Message: The message is incomplete and requires __virid_target${__virid_target}, __virid_source${__virid_source}, __virid_messageType${__virid_messageType}`,\n        ),\n      );\n      return;\n    }\n    // 如果是注册消息，那么注册这个渲染进程\n    if (__virid_messageType === \"VIRID_INTERNAL_REGISTER\") {\n      // 通过 event.sender 拿到物理实例，并与逻辑 ID 绑定\n      const win = BrowserWindow.fromWebContents(event.sender);\n      //找不见窗口，报错\n      if (!win) {\n        MessageWriter.error(\n          new Error(\n            `[Virid Main] unknown Window: Unable to find the window corresponding to event.sender`,\n          ),\n        );\n        return;\n      }\n      //如果已经存在了，报错\n      if (ROUTER_MAP.has(__virid_source)) {\n        MessageWriter.error(\n          new Error(\n            `[Virid Main] Duplicate Registration: This ID has already been registered: ${__virid_source}`,\n          ),\n        );\n        return;\n      }\n      // 存入路由表\n      ROUTER_MAP.set(__virid_source, win);\n      // 关闭时自动删除自己\n      win.once(\"closed\", () => {\n        ROUTER_MAP.delete(__virid_source);\n        MessageWriter.info(\n          `[Virid Main] Window unregistered: ${__virid_source}`,\n        );\n      });\n      MessageWriter.info(`[Virid Main] Window registered: ${__virid_source}`);\n      return;\n    }\n    //分发消息\n    processMessage(message);\n  });\n  //注册自己的中间件函数，把ToRenderMessage拦截发往指定的渲染进程\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 main process adapter for Virid, responsible for sending, receiving, and broadcasting rendering process messages.\n */\nexport * from \"./main\";\nexport * from \"./interfaces\";\nimport { ViridPlugin, type ViridApp } from \"@virid/core\";\nimport { type PluginOption } from \"./interfaces\";\nimport { activateApp } from \"./app\";\nexport const MainPlugin: ViridPlugin<PluginOption> = {\n  name: \"@virid/main\",\n  install(app: ViridApp, options: PluginOption) {\n    activateApp(app, options);\n  },\n};\n"],"mappings":"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","names":["EventMessage","FromRenderMessage","EventMessage","__virid_source","__virid_target","__virid_messageType","senderWindow","_FromRenderMessage","ToRenderMessage","__publicField","_ToRenderMessage","MessageWriter","MessageWriter","VIRID_CHANNEL","ROUTER_MAP","Map","MESSAGE_MAP","FromRender","type","target","has","MessageWriter","warn","set","ReceiveMessages","message","__virid_source","__virid_messageType","__virid_target","payload","error","Error","MessageClass","get","instance","Object","assign","context","senderWindow","write","TransmitMessages","targetWindow","webContents","send","broadcastMessage","forEach","window","processMessage","middleWare","__name","message","next","ToRenderMessage","__virid_target","__virid_messageType","payload","MessageWriter","warn","packet","__virid_source","targetWindows","Array","from","ROUTER_MAP","values","get","filter","Boolean","length","forEach","win","webContents","send","VIRID_CHANNEL","error","Error","MessageWriter","BrowserWindow","ipcMain","VIRID_CHANNEL","activateApp","app","options","electronApp","MessageWriter","error","Error","ipcMain","on","event","message","__virid_target","__virid_source","__virid_messageType","win","BrowserWindow","fromWebContents","sender","ROUTER_MAP","has","set","once","delete","info","processMessage","useMiddleware","middleWare","MainPlugin","name","install","app","options","activateApp"]}
+{"version":3,"sources":["../src/main/message.ts","../src/main/middleware.ts","../src/main/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 Main\n */\nimport { EventMessage } from \"@virid/core\";\nexport { type SystemContext } from \"@virid/core\";\n/**\n * description: 来自渲染进程的消息\n */\nexport abstract class FromRendererMessage extends EventMessage {\n  //我来自哪？\n  public __virid_source: string = \"unknown\";\n\n  /** 我的目的地是哪儿？\n   * 'main': 发给主进程处理\n   * 'all': 广播给所有窗口（经过主进程中转）\n   * string: 指定某个窗口的 ID (windowId)\n   */\n  public __virid_target: string = \"unknown\";\n\n  //我应该在目的地转变成什么消息？\n  public __virid_messageType: string = \"unknown\";\n  public senderWindow: Electron.BrowserWindow = null as any;\n}\n\n/**\n * description: 要发送给渲染进程的消息\n */\nexport abstract class ToRendererMessage extends EventMessage {\n  // 我来自哪？\n  public static __virid_source = \"main\";\n  /** 我的目的地是哪儿？\n   * 'all': 广播给所有窗口（经过主进程中转）\n   * string: 指定某个窗口的 ID (windowId)\n   */\n  public abstract __virid_target: string;\n  /**\n   * 我应该在目的地转变成什么消息？\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 Main\n */\nimport { type Middleware, MessageWriter } from \"@virid/core\";\nimport { ToRendererMessage } from \"./message\";\nimport { ROUTER_MAP, VIRID_CHANNEL } from \"./router\";\nexport const middleWare: Middleware = (message, next) => {\n  //如果消息是继承自MainRequestMessage，拦截并发往对应的渲染进程\n  if (message instanceof ToRendererMessage) {\n    const { __virid_target, __virid_messageType, ...payload } = message;\n    //不准自己发给自己\n    if (__virid_target == \"main\") {\n      MessageWriter.warn(\n        `[Virid Main] Prohibit Sending To Oneself: ${__virid_target} is not allowed in ToRendererMessage.`,\n      );\n    }\n    // 准备要发送的数据包\n    const packet = {\n      __virid_source: ToRendererMessage.__virid_source,\n      __virid_target,\n      __virid_messageType,\n      payload,\n    };\n\n    const targetWindows =\n      __virid_target === \"*\" || __virid_target === \"all\"\n        ? Array.from(ROUTER_MAP.values())\n        : [ROUTER_MAP.get(__virid_target)].filter(Boolean); // 过滤掉 undefined\n\n    if (targetWindows.length > 0) {\n      targetWindows.forEach((win) =>\n        win!.webContents.send(VIRID_CHANNEL, packet),\n      );\n    } else {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] No Window Found: Message target ${__virid_target} cannot be found.`,\n        ),\n      );\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 Main\n */\nimport { MessageWriter, type Newable } from \"@virid/core\";\nimport { type BrowserWindow } from \"electron\";\nimport { type FromRendererMessage } from \"./message\";\nexport const VIRID_CHANNEL = \"VIRID_INTERNAL_BUS\";\nexport const ROUTER_MAP = new Map<string, BrowserWindow>();\nlet MESSAGE_MAP = new Map<string, Newable<FromRendererMessage>>();\n\nexport function FromRenderer(type: string) {\n  return function (target: Newable<FromRendererMessage>) {\n    if (MESSAGE_MAP.has(type)) {\n      MessageWriter.warn(\n        `[Virid Main] Duplicate IpcMessage: Registration for type: ${type}`,\n      );\n    }\n    MESSAGE_MAP.set(type, target);\n  };\n}\n//主进程接收消息并发给自己的system\nfunction ReceiveMessages(message: any): void {\n  const { __virid_source, __virid_messageType, __virid_target, payload } =\n    message;\n  if (!MESSAGE_MAP.has(__virid_messageType)) {\n    // 主进程没注册这个消息,直接报错\n    MessageWriter.error(\n      new Error(\n        `[Virid Main] unknown Message Type: Cannot find ${__virid_messageType} in the main process registry.`,\n      ),\n    );\n    return;\n  }\n  // 查找主进程注册的消息类\n  const MessageClass = MESSAGE_MAP.get(__virid_messageType);\n  // 实例化\n  let instance = new (MessageClass as any)();\n  // 数据还原\n  if (payload) {\n    Object.assign(instance, payload);\n  }\n  // 注入身份元数据\n  instance.__virid_source = __virid_source;\n  instance.__virid_target = __virid_target;\n  instance.__virid_messageType = __virid_messageType;\n  // 注入物理上下文\n  const context = ROUTER_MAP.get(__virid_source);\n  if (context) {\n    instance.senderWindow = context;\n  }\n\n  // 派发给主进程的 System 群\n  MessageWriter.write(instance);\n}\n\nfunction TransmitMessages(message: any): void {\n  const { __virid_source, __virid_messageType, __virid_target, payload } =\n    message;\n  // 查找主进程注册的消息类\n  const targetWindow = ROUTER_MAP.get(__virid_target);\n  if (!targetWindow) {\n    // 主进程没注册这个消息,直接报错\n    MessageWriter.error(\n      new Error(\n        `[Virid Main] unknown Window: Cannot find ${__virid_target} in the windows registry.`,\n      ),\n    );\n    return;\n  }\n  targetWindow.webContents.send(VIRID_CHANNEL, {\n    __virid_source,\n    __virid_messageType,\n    __virid_target,\n    payload,\n  });\n}\nfunction broadcastMessage(message: any) {\n  const { __virid_source, __virid_messageType, __virid_target, payload } =\n    message;\n  ROUTER_MAP.forEach((window) => {\n    window.webContents.send(VIRID_CHANNEL, {\n      __virid_source,\n      __virid_messageType,\n      __virid_target,\n      payload,\n    });\n  });\n}\n\nexport function processMessage(message: any) {\n  const { __virid_target, __virid_source, __virid_messageType } = message;\n  if (__virid_target === \"main\") return ReceiveMessages(message);\n  else if (__virid_target === \"all\" || __virid_target === \"*\")\n    return broadcastMessage(message);\n  else return TransmitMessages(message);\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Main\n */\nconst VIRID_CHANNEL = \"VIRID_INTERNAL_BUS\";\nimport { type ViridApp, MessageWriter } from \"@virid/core\";\nimport { BrowserWindow, ipcMain } from \"electron\";\nimport { middleWare, processMessage, ROUTER_MAP } from \"./main\";\nimport { type PluginOption } from \"./interfaces\";\nexport function activateApp(app: ViridApp, options: PluginOption) {\n  //检查参数\n  if (!options?.electronApp) {\n    MessageWriter.error(\n      new Error(\n        `[Virid Main] Missing Initialization Parameters:\\nelectronApp:${options?.electronApp}.`,\n      ),\n    );\n  }\n  //绑定electron主进程回调\n  ipcMain.on(VIRID_CHANNEL, (event, message) => {\n    const { __virid_target, __virid_source, __virid_messageType } = message;\n    if (!__virid_target || !__virid_source || !__virid_messageType) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] Incomplete Message: The message is incomplete and requires __virid_target${__virid_target}, __virid_source${__virid_source}, __virid_messageType${__virid_messageType}`,\n        ),\n      );\n      return;\n    }\n    // 如果是注册消息，那么注册这个渲染进程\n    if (__virid_messageType === \"VIRID_INTERNAL_REGISTER\") {\n      // 通过 event.sender 拿到物理实例，并与逻辑 ID 绑定\n      const win = BrowserWindow.fromWebContents(event.sender);\n      //找不见窗口，报错\n      if (!win) {\n        MessageWriter.error(\n          new Error(\n            `[Virid Main] unknown Window: Unable to find the window corresponding to event.sender`,\n          ),\n        );\n        return;\n      }\n      //如果已经存在了，报错\n      if (ROUTER_MAP.has(__virid_source)) {\n        MessageWriter.error(\n          new Error(\n            `[Virid Main] Duplicate Registration: This ID has already been registered: ${__virid_source}`,\n          ),\n        );\n        return;\n      }\n      // 存入路由表\n      ROUTER_MAP.set(__virid_source, win);\n      // 关闭时自动删除自己\n      win.once(\"closed\", () => {\n        ROUTER_MAP.delete(__virid_source);\n        MessageWriter.info(\n          `[Virid Main] Window unregistered: ${__virid_source}`,\n        );\n      });\n      MessageWriter.info(`[Virid Main] Window registered: ${__virid_source}`);\n      return;\n    }\n    //分发消息\n    processMessage(message);\n  });\n  //注册自己的中间件函数，把ToRenderMessage拦截发往指定的渲染进程\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 main process adapter for Virid, responsible for sending, receiving, and broadcasting rendering process messages.\n */\nexport * from \"./main\";\nexport * from \"./interfaces\";\nimport { ViridPlugin, type ViridApp } from \"@virid/core\";\nimport { type PluginOption } from \"./interfaces\";\nimport { activateApp } from \"./app\";\nexport const MainPlugin: ViridPlugin<PluginOption> = {\n  name: \"@virid/main\",\n  install(app: ViridApp, options: PluginOption) {\n    activateApp(app, options);\n  },\n};\n"],"mappings":"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","names":["EventMessage","FromRendererMessage","EventMessage","__virid_source","__virid_target","__virid_messageType","senderWindow","_FromRendererMessage","ToRendererMessage","__publicField","_ToRendererMessage","MessageWriter","MessageWriter","VIRID_CHANNEL","ROUTER_MAP","Map","MESSAGE_MAP","FromRenderer","type","target","has","MessageWriter","warn","set","ReceiveMessages","message","__virid_source","__virid_messageType","__virid_target","payload","error","Error","MessageClass","get","instance","Object","assign","context","senderWindow","write","TransmitMessages","targetWindow","webContents","send","broadcastMessage","forEach","window","processMessage","middleWare","__name","message","next","ToRendererMessage","__virid_target","__virid_messageType","payload","MessageWriter","warn","packet","__virid_source","targetWindows","Array","from","ROUTER_MAP","values","get","filter","Boolean","length","forEach","win","webContents","send","VIRID_CHANNEL","error","Error","MessageWriter","BrowserWindow","ipcMain","VIRID_CHANNEL","activateApp","app","options","electronApp","MessageWriter","error","Error","ipcMain","on","event","message","__virid_target","__virid_source","__virid_messageType","win","BrowserWindow","fromWebContents","sender","ROUTER_MAP","has","set","once","delete","info","processMessage","useMiddleware","middleWare","MainPlugin","name","install","app","options","activateApp"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@virid/main",
   "type": "module",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Electron main process adapter for Virid, responsible for sending, receiving, and broadcasting rendering process messages",
   "author": "Ailrid",
   "license": "Apache 2.0",
@@ -13,7 +13,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/ArisuYuki/virid.git"
+    "url": "git+https://github.com/Ailrid/virid.git"
   },
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -35,7 +35,7 @@
   "dependencies": {},
   "peerDependencies": {
     "electron": "^30.0.0",
-    "@virid/core": "0.1.0"
+    "@virid/core": "0.1.2"
   },
   "scripts": {
     "build": "tsup --config tsup.config.ts",