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

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/renderer/message.ts","../src/renderer/middleware.ts","../src/renderer/router.ts","../src/app.ts"],"sourcesContent":["/*\n * Copyright (c) 2026-present Ailrid\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n * Description: Electron renderer process adapter for virid, responsible for forwarding and receiving messages from the main process.\n */\nimport { ViridPlugin, type ViridApp } from \"@virid/core\";\nexport { ToMainMessage, FromMainMessage } from \"./renderer\";\nexport * from \"./interfaces\";\nexport * from \"./renderer\";\nimport { activateApp } from \"./app\";\nimport { type PluginOption } from \"./interfaces\";\nexport const RenderPlugin: ViridPlugin<PluginOption> = {\n  name: \"@virid/render\",\n  install(app: ViridApp, options: PluginOption) {\n    activateApp(app, options);\n  },\n};\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\nimport { EventMessage } from \"@virid/core\";\n/**\n * RenderMessage: 由主进程发来的消息\n */\nexport abstract class FromMainMessage extends EventMessage {\n  /** 我来自哪？\n   */\n  public __virid_source: string = \"unknown\";\n  /** 我的目的地是哪儿？\n   * 'main': 发给主进程处理\n   * 'all': 广播给所有窗口（经过主进程中转）\n   * string: 指定某个窗口的 ID (windowId)\n   */\n  public __virid_target: string;\n  /**\n   * 我应该在目的地转变成什么消息？\n   */\n  public __virid_messageType: string;\n}\n\n/**\n * RenderMessage: 由渲染进程发起，目标是主进程或其他窗口\n */\nexport abstract class ToMainMessage extends EventMessage {\n  /** 我来自哪？\n   */\n  public static __virid_source: string;\n\n  /** 我的目的地是哪儿？\n   * 'main': 发给主进程处理\n   * 'all': 广播给所有窗口（经过主进程中转）\n   * string: 指定某个窗口的 ID (windowId)\n   */\n  public abstract __virid_target: string;\n\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 Renderer\n */\nimport { type Middleware, MessageWriter } from \"@virid/core\";\nimport { ToMainMessage } from \"./message\";\nexport const middleWare: Middleware = (message, next) => {\n  //如果消息继承自ToMainMessage，拦截并发往主进程\n  if (message instanceof ToMainMessage) {\n    const { __virid_target, __virid_messageType, ...payload } = message;\n    //禁止发给自己\n    if (__virid_target == ToMainMessage.__virid_source) {\n      MessageWriter.warn(\n        `[Virid Render] Prohibit Sending To Oneself: ${__virid_target} is not allowed in ToRenderMessage.`,\n      );\n      return;\n    }\n    window.__VIRID_BRIDGE__.post({\n      __virid_source: ToMainMessage.__virid_source,\n      __virid_target: __virid_target,\n      __virid_messageType: __virid_messageType,\n      payload: payload, // 展开实例上的所有属性\n    });\n  } else {\n    next();\n  }\n};\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\nimport { MessageWriter, Newable } from \"@virid/core\";\nimport { type FromMainMessage } from \"./message\";\nlet MESSAGE_MAP = new Map<string, Newable<FromMainMessage>>();\n\nexport function FromIpc(type: string) {\n  return function (target: Newable<FromMainMessage>) {\n    if (MESSAGE_MAP.has(type)) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] Duplicate IpcMessage: Registration for type: ${type}`,\n        ),\n      );\n    }\n    MESSAGE_MAP.set(type, target);\n  };\n}\nexport function convertFromMainMessage(ipcMessage: any): void {\n  // 解构\n  const { __virid_source, __virid_target, __virid_messageType, payload } =\n    ipcMessage;\n  if (!__virid_messageType || !__virid_source || !__virid_target) {\n    MessageWriter.error(\n      new Error(\n        `[Virid Render] Incomplete Data:\\n__virid_source: ${__virid_source}\\n__virid_target:${__virid_target}\\n__virid_messageType: ${__virid_messageType}.`,\n      ),\n    );\n    return;\n  }\n  if (!MESSAGE_MAP.has(__virid_messageType)) {\n    MessageWriter.error(\n      new Error(`[Virid Render] Unregistered type: ${__virid_messageType} `),\n    );\n    return;\n  }\n  // 找到对应的构造函数\n  const MessageClass = MESSAGE_MAP.get(__virid_messageType)!;\n  // 实例化并注入参数\n  const instance = new MessageClass();\n\n  // 显式赋值基类标识，确保实例的身份信息完整\n  instance.__virid_source = __virid_source;\n  instance.__virid_target = __virid_target;\n  instance.__virid_messageType = __virid_messageType;\n\n  // 还原数据\n  if (payload) {\n    Object.assign(instance, payload);\n  }\n\n  // 重新分发\n  MessageWriter.write(instance);\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\n\nimport { MessageWriter, type ViridApp } from \"@virid/core\";\nimport { middleWare, convertFromMainMessage, ToMainMessage } from \"./renderer\";\nimport { type PluginOption } from \"./interfaces\";\nexport function activateApp(app: ViridApp, options: PluginOption) {\n  // 先检查预加载脚本是否已经加载\n  if (!window.__VIRID_BRIDGE__) {\n    MessageWriter.error(\n      new Error(\n        `[Virid Render] Preloading Failed: Please initialize in the preloaded script first.`,\n      ),\n    );\n  }\n  // 检查参数是否传递\n  if (!options?.windowId) {\n    MessageWriter.error(\n      new Error(\n        `[Virid Render] Activate Failed:\\nPlease provide the windowId:${options?.windowId}.`,\n      ),\n    );\n  }\n  //注册自己的id，以后所有发往主进程的消息都会携带自己的id\n  ToMainMessage.__virid_source = options.windowId;\n  //主动向主进程发一个注册消息来注册自己\n  window.__VIRID_BRIDGE__.post({\n    __virid_source: options.windowId,\n    __virid_target: \"main\",\n    __virid_messageType: \"VIRID_INTERNAL_REGISTER\",\n    payload: {\n      windowId: options.windowId,\n    },\n  });\n  // 订阅ipc通道，所有返回的消息，全部转换按照注册表转换成自己的消息类型\n  window.__VIRID_BRIDGE__.subscribe(convertFromMainMessage);\n  //注册自己的中间件函数，把ToMainMessage类型的消息拦截发往electron主进程\n  app.useMiddleware(middleWare);\n}\n"],"mappings":";;;;ulBAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,aAAAE,EAAA,oBAAAC,EAAA,iBAAAC,EAAA,kBAAAC,EAAA,2BAAAC,EAAA,eAAAC,IAAA,eAAAC,EAAAR,GCKA,IAAAS,EAA6B,uBAItB,IAAeC,EAAf,MAAeA,UAAwBC,cAAAA,CAAvC,kCAGEC,EAAAA,sBAAyB,WAMzBC,EAAAA,uBAIAC,EAAAA,4BACT,EAd8CH,EAAAA,EAAAA,mBAAvC,IAAeD,EAAfK,EAmBeC,EAAf,MAAeA,UAAsBL,cAAAA,CAgB5C,EAhB4CA,EAAAA,EAAAA,iBAG1CM,EAHoBD,EAGNJ,kBAHT,IAAeI,EAAfE,ECvBP,IAAAC,EAA+C,uBAExC,IAAMC,EAAyBC,EAAA,CAACC,EAASC,IAAAA,CAE9C,GAAID,aAAmBE,EAAe,CACpC,GAAM,CAAEC,eAAAA,EAAgBC,oBAAAA,EAAqB,GAAGC,CAAAA,EAAYL,EAE5D,GAAIG,GAAkBD,EAAcI,eAAgB,CAClDC,gBAAcC,KACZ,+CAA+CL,CAAAA,qCAAmD,EAEpG,MACF,CACAM,OAAOC,iBAAiBC,KAAK,CAC3BL,eAAgBJ,EAAcI,eAC9BH,eAAgBA,EAChBC,oBAAqBA,EACrBC,QAASA,CACX,CAAA,CACF,MACEJ,EAAAA,CAEJ,EApBsC,cCFtC,IAAAW,EAAuC,uBAEvC,IAAIC,EAAc,IAAIC,IAEf,SAASC,EAAQC,EAAY,CAClC,OAAO,SAAUC,EAAgC,CAC3CJ,EAAYK,IAAIF,CAAAA,GAClBG,gBAAcC,MACZ,IAAIC,MACF,6DAA6DL,CAAAA,EAAM,CAAA,EAIzEH,EAAYS,IAAIN,EAAMC,CAAAA,CACxB,CACF,CAXgBF,EAAAA,EAAAA,WAYT,SAASQ,EAAuBC,EAAe,CAEpD,GAAM,CAAEC,eAAAA,EAAgBC,eAAAA,EAAgBC,oBAAAA,EAAqBC,QAAAA,CAAO,EAClEJ,EACF,GAAI,CAACG,GAAuB,CAACF,GAAkB,CAACC,EAAgB,CAC9DP,gBAAcC,MACZ,IAAIC,MACF;kBAAoDI,CAAAA;iBAAkCC,CAAAA;uBAAwCC,CAAAA,GAAsB,CAAA,EAGxJ,MACF,CACA,GAAI,CAACd,EAAYK,IAAIS,CAAAA,EAAsB,CACzCR,gBAAcC,MACZ,IAAIC,MAAM,qCAAqCM,CAAAA,GAAsB,CAAA,EAEvE,MACF,CAEA,IAAME,EAAehB,EAAYiB,IAAIH,CAAAA,EAE/BI,EAAW,IAAIF,EAGrBE,EAASN,eAAiBA,EAC1BM,EAASL,eAAiBA,EAC1BK,EAASJ,oBAAsBA,EAG3BC,GACFI,OAAOC,OAAOF,EAAUH,CAAAA,EAI1BT,gBAAce,MAAMH,CAAAA,CACtB,CAnCgBR,EAAAA,EAAAA,0BCfhB,IAAAY,EAA6C,uBAGtC,SAASC,EAAYC,EAAeC,EAAqB,CAEzDC,OAAOC,kBACVC,gBAAcC,MACZ,IAAIC,MACF,oFAAoF,CAAA,EAKrFL,GAASM,UACZH,gBAAcC,MACZ,IAAIC,MACF;8BAAgEL,GAASM,QAAAA,GAAW,CAAA,EAK1FC,EAAcC,eAAiBR,EAAQM,SAEvCL,OAAOC,iBAAiBO,KAAK,CAC3BD,eAAgBR,EAAQM,SACxBI,eAAgB,OAChBC,oBAAqB,0BACrBC,QAAS,CACPN,SAAUN,EAAQM,QACpB,CACF,CAAA,EAEAL,OAAOC,iBAAiBW,UAAUC,CAAAA,EAElCf,EAAIgB,cAAcC,CAAAA,CACpB,CAhCgBlB,EAAAA,EAAAA,eJcT,IAAMmB,EAA0C,CACrDC,KAAM,gBACNC,QAAQC,EAAeC,EAAqB,CAC1CC,EAAYF,EAAKC,CAAAA,CACnB,CACF","names":["index_exports","__export","FromIpc","FromMainMessage","RenderPlugin","ToMainMessage","convertFromMainMessage","middleWare","__toCommonJS","import_core","FromMainMessage","EventMessage","__virid_source","__virid_target","__virid_messageType","_FromMainMessage","ToMainMessage","__publicField","_ToMainMessage","import_core","middleWare","__name","message","next","ToMainMessage","__virid_target","__virid_messageType","payload","__virid_source","MessageWriter","warn","window","__VIRID_BRIDGE__","post","import_core","MESSAGE_MAP","Map","FromIpc","type","target","has","MessageWriter","error","Error","set","convertFromMainMessage","ipcMessage","__virid_source","__virid_target","__virid_messageType","payload","MessageClass","get","instance","Object","assign","write","import_core","activateApp","app","options","window","__VIRID_BRIDGE__","MessageWriter","error","Error","windowId","ToMainMessage","__virid_source","post","__virid_target","__virid_messageType","payload","subscribe","convertFromMainMessage","useMiddleware","middleWare","RenderPlugin","name","install","app","options","activateApp"]}

package/dist/index.d.cts

@@ -0,0 +1,54 @@
+import { EventMessage, Middleware, Newable, ViridPlugin } from '@virid/core';
+
+/**
+ * RenderMessage: 由主进程发来的消息
+ */
+declare abstract class FromMainMessage extends EventMessage {
+    /** 我来自哪？
+     */
+    __virid_source: string;
+    /** 我的目的地是哪儿？
+     * 'main': 发给主进程处理
+     * 'all': 广播给所有窗口（经过主进程中转）
+     * string: 指定某个窗口的 ID (windowId)
+     */
+    __virid_target: string;
+    /**
+     * 我应该在目的地转变成什么消息？
+     */
+    __virid_messageType: string;
+}
+/**
+ * RenderMessage: 由渲染进程发起，目标是主进程或其他窗口
+ */
+declare abstract class ToMainMessage extends EventMessage {
+    /** 我来自哪？
+     */
+    static __virid_source: string;
+    /** 我的目的地是哪儿？
+     * 'main': 发给主进程处理
+     * 'all': 广播给所有窗口（经过主进程中转）
+     * string: 指定某个窗口的 ID (windowId)
+     */
+    abstract __virid_target: string;
+    /**
+     * 我应该在目的地转变成什么消息？
+     */
+    abstract __virid_messageType: string;
+}
+
+declare const middleWare: Middleware;
+
+declare function FromIpc(type: string): (target: Newable<FromMainMessage>) => void;
+declare function convertFromMainMessage(ipcMessage: any): void;
+
+interface PluginOption {
+    /**
+     * 窗口的 ID
+     */
+    windowId: string;
+}
+
+declare const RenderPlugin: ViridPlugin<PluginOption>;
+
+export { FromIpc, FromMainMessage, type PluginOption, RenderPlugin, ToMainMessage, convertFromMainMessage, middleWare };

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+import { EventMessage, Middleware, Newable, ViridPlugin } from '@virid/core';
+
+/**
+ * RenderMessage: 由主进程发来的消息
+ */
+declare abstract class FromMainMessage extends EventMessage {
+    /** 我来自哪？
+     */
+    __virid_source: string;
+    /** 我的目的地是哪儿？
+     * 'main': 发给主进程处理
+     * 'all': 广播给所有窗口（经过主进程中转）
+     * string: 指定某个窗口的 ID (windowId)
+     */
+    __virid_target: string;
+    /**
+     * 我应该在目的地转变成什么消息？
+     */
+    __virid_messageType: string;
+}
+/**
+ * RenderMessage: 由渲染进程发起，目标是主进程或其他窗口
+ */
+declare abstract class ToMainMessage extends EventMessage {
+    /** 我来自哪？
+     */
+    static __virid_source: string;
+    /** 我的目的地是哪儿？
+     * 'main': 发给主进程处理
+     * 'all': 广播给所有窗口（经过主进程中转）
+     * string: 指定某个窗口的 ID (windowId)
+     */
+    abstract __virid_target: string;
+    /**
+     * 我应该在目的地转变成什么消息？
+     */
+    abstract __virid_messageType: string;
+}
+
+declare const middleWare: Middleware;
+
+declare function FromIpc(type: string): (target: Newable<FromMainMessage>) => void;
+declare function convertFromMainMessage(ipcMessage: any): void;
+
+interface PluginOption {
+    /**
+     * 窗口的 ID
+     */
+    windowId: string;
+}
+
+declare const RenderPlugin: ViridPlugin<PluginOption>;
+
+export { FromIpc, FromMainMessage, type PluginOption, RenderPlugin, ToMainMessage, convertFromMainMessage, middleWare };

package/dist/index.js

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

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/renderer/message.ts","../src/renderer/middleware.ts","../src/renderer/router.ts","../src/app.ts","../src/index.ts"],"sourcesContent":["/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\nimport { EventMessage } from \"@virid/core\";\n/**\n * RenderMessage: 由主进程发来的消息\n */\nexport abstract class FromMainMessage extends EventMessage {\n  /** 我来自哪？\n   */\n  public __virid_source: string = \"unknown\";\n  /** 我的目的地是哪儿？\n   * 'main': 发给主进程处理\n   * 'all': 广播给所有窗口（经过主进程中转）\n   * string: 指定某个窗口的 ID (windowId)\n   */\n  public __virid_target: string;\n  /**\n   * 我应该在目的地转变成什么消息？\n   */\n  public __virid_messageType: string;\n}\n\n/**\n * RenderMessage: 由渲染进程发起，目标是主进程或其他窗口\n */\nexport abstract class ToMainMessage extends EventMessage {\n  /** 我来自哪？\n   */\n  public static __virid_source: string;\n\n  /** 我的目的地是哪儿？\n   * 'main': 发给主进程处理\n   * 'all': 广播给所有窗口（经过主进程中转）\n   * string: 指定某个窗口的 ID (windowId)\n   */\n  public abstract __virid_target: string;\n\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 Renderer\n */\nimport { type Middleware, MessageWriter } from \"@virid/core\";\nimport { ToMainMessage } from \"./message\";\nexport const middleWare: Middleware = (message, next) => {\n  //如果消息继承自ToMainMessage，拦截并发往主进程\n  if (message instanceof ToMainMessage) {\n    const { __virid_target, __virid_messageType, ...payload } = message;\n    //禁止发给自己\n    if (__virid_target == ToMainMessage.__virid_source) {\n      MessageWriter.warn(\n        `[Virid Render] Prohibit Sending To Oneself: ${__virid_target} is not allowed in ToRenderMessage.`,\n      );\n      return;\n    }\n    window.__VIRID_BRIDGE__.post({\n      __virid_source: ToMainMessage.__virid_source,\n      __virid_target: __virid_target,\n      __virid_messageType: __virid_messageType,\n      payload: payload, // 展开实例上的所有属性\n    });\n  } else {\n    next();\n  }\n};\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\nimport { MessageWriter, Newable } from \"@virid/core\";\nimport { type FromMainMessage } from \"./message\";\nlet MESSAGE_MAP = new Map<string, Newable<FromMainMessage>>();\n\nexport function FromIpc(type: string) {\n  return function (target: Newable<FromMainMessage>) {\n    if (MESSAGE_MAP.has(type)) {\n      MessageWriter.error(\n        new Error(\n          `[Virid Main] Duplicate IpcMessage: Registration for type: ${type}`,\n        ),\n      );\n    }\n    MESSAGE_MAP.set(type, target);\n  };\n}\nexport function convertFromMainMessage(ipcMessage: any): void {\n  // 解构\n  const { __virid_source, __virid_target, __virid_messageType, payload } =\n    ipcMessage;\n  if (!__virid_messageType || !__virid_source || !__virid_target) {\n    MessageWriter.error(\n      new Error(\n        `[Virid Render] Incomplete Data:\\n__virid_source: ${__virid_source}\\n__virid_target:${__virid_target}\\n__virid_messageType: ${__virid_messageType}.`,\n      ),\n    );\n    return;\n  }\n  if (!MESSAGE_MAP.has(__virid_messageType)) {\n    MessageWriter.error(\n      new Error(`[Virid Render] Unregistered type: ${__virid_messageType} `),\n    );\n    return;\n  }\n  // 找到对应的构造函数\n  const MessageClass = MESSAGE_MAP.get(__virid_messageType)!;\n  // 实例化并注入参数\n  const instance = new MessageClass();\n\n  // 显式赋值基类标识，确保实例的身份信息完整\n  instance.__virid_source = __virid_source;\n  instance.__virid_target = __virid_target;\n  instance.__virid_messageType = __virid_messageType;\n\n  // 还原数据\n  if (payload) {\n    Object.assign(instance, payload);\n  }\n\n  // 重新分发\n  MessageWriter.write(instance);\n}\n","/*\n * Copyright (c) 2026-present Ailrid.\n * Licensed under the Apache License, Version 2.0.\n * Project: Virid Renderer\n */\n\nimport { MessageWriter, type ViridApp } from \"@virid/core\";\nimport { middleWare, convertFromMainMessage, ToMainMessage } from \"./renderer\";\nimport { type PluginOption } from \"./interfaces\";\nexport function activateApp(app: ViridApp, options: PluginOption) {\n  // 先检查预加载脚本是否已经加载\n  if (!window.__VIRID_BRIDGE__) {\n    MessageWriter.error(\n      new Error(\n        `[Virid Render] Preloading Failed: Please initialize in the preloaded script first.`,\n      ),\n    );\n  }\n  // 检查参数是否传递\n  if (!options?.windowId) {\n    MessageWriter.error(\n      new Error(\n        `[Virid Render] Activate Failed:\\nPlease provide the windowId:${options?.windowId}.`,\n      ),\n    );\n  }\n  //注册自己的id，以后所有发往主进程的消息都会携带自己的id\n  ToMainMessage.__virid_source = options.windowId;\n  //主动向主进程发一个注册消息来注册自己\n  window.__VIRID_BRIDGE__.post({\n    __virid_source: options.windowId,\n    __virid_target: \"main\",\n    __virid_messageType: \"VIRID_INTERNAL_REGISTER\",\n    payload: {\n      windowId: options.windowId,\n    },\n  });\n  // 订阅ipc通道，所有返回的消息，全部转换按照注册表转换成自己的消息类型\n  window.__VIRID_BRIDGE__.subscribe(convertFromMainMessage);\n  //注册自己的中间件函数，把ToMainMessage类型的消息拦截发往electron主进程\n  app.useMiddleware(middleWare);\n}\n","/*\n * Copyright (c) 2026-present Ailrid\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n *\n * Description: Electron renderer process adapter for virid, responsible for forwarding and receiving messages from the main process.\n */\nimport { ViridPlugin, type ViridApp } from \"@virid/core\";\nexport { ToMainMessage, FromMainMessage } from \"./renderer\";\nexport * from \"./interfaces\";\nexport * from \"./renderer\";\nimport { activateApp } from \"./app\";\nimport { type PluginOption } from \"./interfaces\";\nexport const RenderPlugin: ViridPlugin<PluginOption> = {\n  name: \"@virid/render\",\n  install(app: ViridApp, options: PluginOption) {\n    activateApp(app, options);\n  },\n};\n"],"mappings":";;;;uNAKA,OAASA,gBAAAA,MAAoB,cAItB,IAAeC,EAAf,MAAeA,UAAwBC,CAAAA,CAAvC,kCAGEC,EAAAA,sBAAyB,WAMzBC,EAAAA,uBAIAC,EAAAA,4BACT,EAd8CH,EAAAA,EAAAA,mBAAvC,IAAeD,EAAfK,EAmBeC,EAAf,MAAeA,UAAsBL,CAAAA,CAgB5C,EAhB4CA,EAAAA,EAAAA,iBAG1CM,EAHoBD,EAGNJ,kBAHT,IAAeI,EAAfE,ECvBP,OAA0BC,iBAAAA,MAAqB,cAExC,IAAMC,EAAyBC,EAAA,CAACC,EAASC,IAAAA,CAE9C,GAAID,aAAmBE,EAAe,CACpC,GAAM,CAAEC,eAAAA,EAAgBC,oBAAAA,EAAqB,GAAGC,CAAAA,EAAYL,EAE5D,GAAIG,GAAkBD,EAAcI,eAAgB,CAClDC,EAAcC,KACZ,+CAA+CL,CAAAA,qCAAmD,EAEpG,MACF,CACAM,OAAOC,iBAAiBC,KAAK,CAC3BL,eAAgBJ,EAAcI,eAC9BH,eAAgBA,EAChBC,oBAAqBA,EACrBC,QAASA,CACX,CAAA,CACF,MACEJ,EAAAA,CAEJ,EApBsC,cCFtC,OAASW,iBAAAA,MAA8B,cAEvC,IAAIC,EAAc,IAAIC,IAEf,SAASC,EAAQC,EAAY,CAClC,OAAO,SAAUC,EAAgC,CAC3CJ,EAAYK,IAAIF,CAAAA,GAClBG,EAAcC,MACZ,IAAIC,MACF,6DAA6DL,CAAAA,EAAM,CAAA,EAIzEH,EAAYS,IAAIN,EAAMC,CAAAA,CACxB,CACF,CAXgBF,EAAAA,EAAAA,WAYT,SAASQ,EAAuBC,EAAe,CAEpD,GAAM,CAAEC,eAAAA,EAAgBC,eAAAA,EAAgBC,oBAAAA,EAAqBC,QAAAA,CAAO,EAClEJ,EACF,GAAI,CAACG,GAAuB,CAACF,GAAkB,CAACC,EAAgB,CAC9DP,EAAcC,MACZ,IAAIC,MACF;kBAAoDI,CAAAA;iBAAkCC,CAAAA;uBAAwCC,CAAAA,GAAsB,CAAA,EAGxJ,MACF,CACA,GAAI,CAACd,EAAYK,IAAIS,CAAAA,EAAsB,CACzCR,EAAcC,MACZ,IAAIC,MAAM,qCAAqCM,CAAAA,GAAsB,CAAA,EAEvE,MACF,CAEA,IAAME,EAAehB,EAAYiB,IAAIH,CAAAA,EAE/BI,EAAW,IAAIF,EAGrBE,EAASN,eAAiBA,EAC1BM,EAASL,eAAiBA,EAC1BK,EAASJ,oBAAsBA,EAG3BC,GACFI,OAAOC,OAAOF,EAAUH,CAAAA,EAI1BT,EAAce,MAAMH,CAAAA,CACtB,CAnCgBR,EAAAA,EAAAA,0BCfhB,OAASY,iBAAAA,MAAoC,cAGtC,SAASC,EAAYC,EAAeC,EAAqB,CAEzDC,OAAOC,kBACVC,EAAcC,MACZ,IAAIC,MACF,oFAAoF,CAAA,EAKrFL,GAASM,UACZH,EAAcC,MACZ,IAAIC,MACF;8BAAgEL,GAASM,QAAAA,GAAW,CAAA,EAK1FC,EAAcC,eAAiBR,EAAQM,SAEvCL,OAAOC,iBAAiBO,KAAK,CAC3BD,eAAgBR,EAAQM,SACxBI,eAAgB,OAChBC,oBAAqB,0BACrBC,QAAS,CACPN,SAAUN,EAAQM,QACpB,CACF,CAAA,EAEAL,OAAOC,iBAAiBW,UAAUC,CAAAA,EAElCf,EAAIgB,cAAcC,CAAAA,CACpB,CAhCgBlB,EAAAA,EAAAA,eCcT,IAAMmB,EAA0C,CACrDC,KAAM,gBACNC,QAAQC,EAAeC,EAAqB,CAC1CC,EAAYF,EAAKC,CAAAA,CACnB,CACF","names":["EventMessage","FromMainMessage","EventMessage","__virid_source","__virid_target","__virid_messageType","_FromMainMessage","ToMainMessage","__publicField","_ToMainMessage","MessageWriter","middleWare","__name","message","next","ToMainMessage","__virid_target","__virid_messageType","payload","__virid_source","MessageWriter","warn","window","__VIRID_BRIDGE__","post","MessageWriter","MESSAGE_MAP","Map","FromIpc","type","target","has","MessageWriter","error","Error","set","convertFromMainMessage","ipcMessage","__virid_source","__virid_target","__virid_messageType","payload","MessageClass","get","instance","Object","assign","write","MessageWriter","activateApp","app","options","window","__VIRID_BRIDGE__","MessageWriter","error","Error","windowId","ToMainMessage","__virid_source","post","__virid_target","__virid_messageType","payload","subscribe","convertFromMainMessage","useMiddleware","middleWare","RenderPlugin","name","install","app","options","activateApp"]}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@virid/renderer",
+  "type": "module",
+  "version": "0.1.0",
+  "description": "Electron renderer process adapter for virid, responsible for forwarding and receiving messages from the main process",
+  "author": "Ailrid",
+  "license": "Apache 2.0",
+  "keywords": [
+    "electron",
+    "renderer",
+    "virid",
+    "message"
+  ],
+  "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": {
+    "@virid/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}