nexfep 0.1.3 → 0.1.5

package/README-CN.md

@@ -117,13 +117,14 @@ pool.onCustomMessage = (window, data) => {
 在页面中通过 `window.invoke` 触发事件：
 
 ```javascript
+window.invoke('hello');
 window.invoke('hello', 'world');
 ```
 
 **参数说明**
 
 - `event` — 事件名称
-- `data` — 任意类型的可序列化数据，会被序列化为 JSON 字符串后发送
+- `data`（可选）— 任意类型的可序列化数据，会被序列化为 JSON 字符串后发送
 
 #### 监听事件
 
@@ -192,6 +193,59 @@ globals.set('hello', 'world');
 const value = globals.get('hello');
 ```
 
+### 窗口间通信
+
+框架支持窗口之间通过 `window.broadcast` 和 `window.tell` 直接通信，无需经过主进程。
+
+#### 广播
+
+通过 `window.broadcast` 向所有其他打开的窗口发送事件：
+
+```javascript
+window.broadcast('user-login', { userId: 123 });
+```
+
+**参数说明**
+
+- `name` — 事件名称
+- `data`（可选）— 任意类型的可序列化数据，会被序列化为 JSON 字符串后发送
+
+其他窗口通过 `window.addEventListener` 监听广播事件：
+
+```javascript
+window.addEventListener('user-login', (event) => {
+  console.log('用户已登录:', event.detail);
+});
+```
+
+#### 定向发送
+
+通过 `window.tell` 向指定 ID 的窗口发送消息：
+
+```javascript
+window.tell(2, 'custom-message', { text: '你好，窗口2' });
+```
+
+**参数说明**
+
+- `to` — 目标窗口 ID（数字类型）
+- `message` — 事件名称
+- `data`（可选）— 任意类型的可序列化数据，会被序列化为 JSON 字符串后发送
+
+目标窗口通过 `window.addEventListener` 接收消息：
+
+```javascript
+window.addEventListener('custom-message', (event) => {
+  console.log('收到消息:', event.detail);
+});
+```
+
+每个窗口的 ID 可通过 `window.id` 获取：
+
+```javascript
+console.log('当前窗口 ID:', window.id);
+```
+
 ### 窗口控制函数
 
 页面中可直接调用以下注入函数进行窗口控制：
@@ -207,6 +261,13 @@ window.openDevTools();       // 打开开发者工具
 window.closeDevTools();      // 关闭开发者工具
 ```
 
+页面中还可访问以下属性：
+
+```javascript
+console.log(window.id);               // 窗口唯一标识
+console.log(window.isNexfepLoadDone); // 窗口是否已加载完成
+```
+
 ### 拖拽区域
 
 通过 HTML 属性即可定义窗口拖拽区域，无需编写额外 JavaScript 代码。这些属性会自动应用 `-webkit-app-region` 和 `app-region` CSS 属性。

package/README.md

@@ -117,13 +117,14 @@ pool.onCustomMessage = (window, data) => {
 Invoke events via `window.invoke` in the page:
 
 ```javascript
+window.invoke('hello');
 window.invoke('hello', 'world');
 ```
 
 **Parameters**
 
 - `event` — Event name
-- `data` — Any serializable data, will be serialized to JSON string before sending
+- `data` (optional) — Any serializable data, will be serialized to JSON string before sending
 
 #### Listen for Events
 
@@ -192,6 +193,59 @@ globals.set('hello', 'world');
 const value = globals.get('hello');
 ```
 
+### Inter-Window Communication
+
+The framework supports direct communication between windows via `window.broadcast` and `window.tell`, without going through the main process.
+
+#### Broadcast
+
+Send an event to all other open windows via `window.broadcast`:
+
+```javascript
+window.broadcast('user-login', { userId: 123 });
+```
+
+**Parameters**
+
+- `name` — Event name
+- `data` (optional) — Any serializable data, will be serialized to JSON string before sending
+
+Other windows listen for the broadcast event via `window.addEventListener`:
+
+```javascript
+window.addEventListener('user-login', (event) => {
+  console.log('User logged in:', event.detail);
+});
+```
+
+#### Tell
+
+Send a message to a specific window by its ID via `window.tell`:
+
+```javascript
+window.tell(2, 'custom-message', { text: 'Hello Window 2' });
+```
+
+**Parameters**
+
+- `to` — Target window ID (number)
+- `message` — Event name
+- `data` (optional) — Any serializable data, will be serialized to JSON string before sending
+
+The target window receives the message via `window.addEventListener`:
+
+```javascript
+window.addEventListener('custom-message', (event) => {
+  console.log('Received message:', event.detail);
+});
+```
+
+Each window's ID can be accessed via `window.id`:
+
+```javascript
+console.log('This window ID:', window.id);
+```
+
 ### Window Control Functions
 
 The following injected functions can be directly called in the page for window control:
@@ -207,6 +261,13 @@ window.openDevTools();       // Open developer tools
 window.closeDevTools();      // Close developer tools
 ```
 
+The following properties are also available in the page:
+
+```javascript
+console.log(window.id);                // Window unique identifier
+console.log(window.isNexfepLoadDone);  // Whether the window has finished loading
+```
+
 ### Drag Regions
 
 Define window drag regions via HTML attributes without writing additional JavaScript code. These attributes automatically apply `-webkit-app-region` and `app-region` CSS properties.

package/index.js

@@ -187,7 +187,7 @@ class WindowPool {
 
         window.eventCount = 0;
 
-        window.invoke = async (event, data) => {
+        window.invoke = async (event, data = null) => {
             const MessageBody = { type: 'NexfepInvoke', eventId: [${this.injectCount}, ++window.eventCount], event: event, data: data }
             window.ipc.postMessage(JSON.stringify(MessageBody));
             return new Promise((resolve, reject) => {
@@ -221,6 +221,18 @@ class WindowPool {
                 });
             });
         }
+
+        window.broadcast = (name, data = null) => {
+            const MessageBody = { type: 'NexfepBroadcast', name: name, data: data }
+            window.ipc.postMessage(JSON.stringify(MessageBody));
+        }
+
+        window.id = ${windowObj.id};
+
+        window.tell = (to, message, data = null) => {
+            const MessageBody = { type: 'NexfepTell', to: to, message: message, data: data }
+            window.ipc.postMessage(JSON.stringify(MessageBody));
+        }
         
         // 注入 CSS 样式
         const style = document.createElement('style');
@@ -231,7 +243,7 @@ class WindowPool {
         window.isNexfepLoadDone = true;
 
         // 触发加载完成事件
-        window.dispatchEvent(new Event('nexfep-load-done'));
+        window.dispatchEvent(new CustomEvent('nexfep-load-done'));
         `;
         await this.__injectCode(windowObj, INJECT_CODE);
     }
@@ -290,12 +302,12 @@ class WindowPool {
                     const result = await handler(dataObj.data);
                     if (result) {
                         webview.evaluateScript(`
-                            window.dispatchEvent(new Event('nexfep-invoke-result-${dataObj.eventId[0]}-${dataObj.eventId[1]}', { detail: ${JSON.stringify(result)} }));
+                            window.dispatchEvent(new CustomEvent('nexfep-invoke-result-${dataObj.eventId[0]}-${dataObj.eventId[1]}', { detail: ${JSON.stringify(result)} }));
                         `);
                     }
                     else {
                         webview.evaluateScript(`
-                            window.dispatchEvent(new Event('nexfep-invoke-result-${dataObj.eventId[0]}-${dataObj.eventId[1]}', { detail: undefined }));
+                            window.dispatchEvent(new CustomEvent('nexfep-invoke-result-${dataObj.eventId[0]}-${dataObj.eventId[1]}', { detail: undefined }));
                         `);
                     }
                 });
@@ -306,9 +318,27 @@ class WindowPool {
             else if (dataObj.type == 'NexfepGetGlobal') {
                 const value = this.global.get(dataObj.name);
                 webview.evaluateScript(`
-                    window.dispatchEvent(new Event('nexfep-get-global-result-${dataObj.eventId[0]}-${dataObj.eventId[1]}', { detail: ${JSON.stringify(value)} }));
+                    window.dispatchEvent(new CustomEvent('nexfep-get-global-result-${dataObj.eventId[0]}-${dataObj.eventId[1]}', { detail: ${JSON.stringify(value)} }));
                 `);
             }
+            else if (dataObj.type == 'NexfepBroadcast') {
+                this.windows.forEach(async (w) => {
+                    if (w != windowObj && w.isOpen) {
+                        w.webview.evaluateScript(`
+                            window.dispatchEvent(new CustomEvent('${dataObj.name}', { detail: ${JSON.stringify(dataObj.data)} }));
+                        `);
+                    }
+                });
+            }
+            else if (dataObj.type == 'NexfepTell') {
+                this.windows.forEach(async (w) => {
+                    if (w.id == dataObj.to) {
+                        w.webview.evaluateScript(`
+                            window.dispatchEvent(new CustomEvent('${dataObj.message}', { detail: ${JSON.stringify(dataObj.data)} }));
+                        `);
+                    }
+                });
+            }
         });
         return windowObj;
     }

package/package.json

@@ -14,7 +14,7 @@
     "webview",
     "typescript"
   ],
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "main": "./index.js",
   "scripts": {
@@ -25,8 +25,16 @@
   "engines": {
     "node": ">=20.11.0"
   },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "README.md",
+    "README-CN.md",
+    "LICENSE",
+    "package.json"
+  ],
   "dependencies": {
-    "@webviewjs/webview": "^0.1.0"
+    "@webviewjs/webview": "0.1.4"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",