@virid/main 0.1.0

package/LICENSE

@@ -0,0 +1,190 @@
+   Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Ailrid
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1 @@
+todo

package/README.zh.md

@@ -0,0 +1 @@
+todo

package/dist/index.cjs

@@ -0,0 +1,7 @@
+/**
+ *  @virid/main v0.0.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});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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"]}

package/dist/index.d.cts

@@ -0,0 +1,51 @@
+import { EventMessage, Middleware, Newable, ViridPlugin } from '@virid/core';
+export { SystemContext } from '@virid/core';
+import { BrowserWindow, App } from 'electron';
+
+/**
+ * description: 来自渲染进程的消息
+ */
+declare abstract class FromRenderMessage extends EventMessage {
+    __virid_source: string;
+    /** 我的目的地是哪儿？
+     * 'main': 发给主进程处理
+     * 'all': 广播给所有窗口（经过主进程中转）
+     * string: 指定某个窗口的 ID (windowId)
+     */
+    __virid_target: string;
+    __virid_messageType: string;
+    senderWindow: Electron.BrowserWindow;
+}
+/**
+ * description: 要发送给渲染进程的消息
+ */
+declare abstract class ToRenderMessage extends EventMessage {
+    static __virid_source: string;
+    /** 我的目的地是哪儿？
+     * 'all': 广播给所有窗口（经过主进程中转）
+     * string: 指定某个窗口的 ID (windowId)
+     */
+    abstract __virid_target: string;
+    /**
+     * 我应该在目的地转变成什么消息？
+     */
+    abstract __virid_messageType: string;
+}
+
+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 processMessage(message: any): void;
+
+interface PluginOption {
+    /**
+     * 窗口的 ID
+     */
+    electronApp: App;
+}
+
+declare const MainPlugin: ViridPlugin<PluginOption>;
+
+export { FromRender, FromRenderMessage, MainPlugin, type PluginOption, ROUTER_MAP, ToRenderMessage, VIRID_CHANNEL, middleWare, processMessage };

package/dist/index.d.ts

@@ -0,0 +1,51 @@
+import { EventMessage, Middleware, Newable, ViridPlugin } from '@virid/core';
+export { SystemContext } from '@virid/core';
+import { BrowserWindow, App } from 'electron';
+
+/**
+ * description: 来自渲染进程的消息
+ */
+declare abstract class FromRenderMessage extends EventMessage {
+    __virid_source: string;
+    /** 我的目的地是哪儿？
+     * 'main': 发给主进程处理
+     * 'all': 广播给所有窗口（经过主进程中转）
+     * string: 指定某个窗口的 ID (windowId)
+     */
+    __virid_target: string;
+    __virid_messageType: string;
+    senderWindow: Electron.BrowserWindow;
+}
+/**
+ * description: 要发送给渲染进程的消息
+ */
+declare abstract class ToRenderMessage extends EventMessage {
+    static __virid_source: string;
+    /** 我的目的地是哪儿？
+     * 'all': 广播给所有窗口（经过主进程中转）
+     * string: 指定某个窗口的 ID (windowId)
+     */
+    abstract __virid_target: string;
+    /**
+     * 我应该在目的地转变成什么消息？
+     */
+    abstract __virid_messageType: string;
+}
+
+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 processMessage(message: any): void;
+
+interface PluginOption {
+    /**
+     * 窗口的 ID
+     */
+    electronApp: App;
+}
+
+declare const MainPlugin: ViridPlugin<PluginOption>;
+
+export { FromRender, FromRenderMessage, MainPlugin, type PluginOption, ROUTER_MAP, ToRenderMessage, VIRID_CHANNEL, middleWare, processMessage };

package/dist/index.js

@@ -0,0 +1,7 @@
+/**
+ *  @virid/main v0.0.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};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"]}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@virid/main",
+  "type": "module",
+  "version": "0.1.0",
+  "description": "Electron main process adapter for Virid, responsible for sending, receiving, and broadcasting rendering process messages",
+  "author": "Ailrid",
+  "license": "Apache 2.0",
+  "keywords": [
+    "electron",
+    "virid",
+    "main",
+    "ipc"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ArisuYuki/virid.git"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "electron": "^30.0.0",
+    "@virid/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}