macos-scroll-monitor 1.0.0

package/binding.gyp

@@ -0,0 +1,36 @@
+{
+  "targets": [
+    {
+      "target_name": "macos_scroll_monitor",
+      "sources": [
+        "src/macos_scroll_monitor.mm",
+      ],
+      "include_dirs": [
+        "<!@(node -p \"require('node-addon-api').include\")",
+        "include"
+      ],
+      "dependencies": [
+        "<!(node -p \"require('node-addon-api').gyp\")"
+      ],
+      "defines": [
+        "NODE_ADDON_API_CPP_EXCEPTIONS"
+      ],
+      "cflags!": ["-fno-exceptions"],
+      "cflags_cc!": ["-fno-exceptions"],
+      "xcode_settings": {
+        "CLANG_ENABLE_OBJC_ARC": "YES",
+        "GCC_ENABLE_CPP_EXCEPTIONS": "YES",
+        "CLANG_CXX_LIBRARY": "libc++",
+        "MACOSX_DEPLOYMENT_TARGET": "10.14"
+      },
+      "msvs_settings": {
+        "VCCLCompilerTool": {
+          "ExceptionHandling": 1
+        }
+      },
+      "libraries": [
+        "-framework AppKit"
+      ]
+    }
+  ]
+}

package/index.d.ts

@@ -0,0 +1 @@
+export function isFnPressed(): boolean;

package/index.js

@@ -0,0 +1 @@
+module.exports = require('bindings')('macos_scroll_monitor')

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "macos-scroll-monitor",
+  "version": "1.0.0",
+  "description": "A native addon for Electron",
+  "main": "index.js",
+  "scripts": {
+    "clean": "node -e \"require('fs').rmSync('build', { recursive: true, force: true })\"",
+    "build": "node-gyp configure && node-gyp build"
+  },
+  "dependencies": {
+    "bindings": "^1.5.0",
+    "node-addon-api": "^8.3.0"
+  },
+  "devDependencies": {
+    "node-gyp": "^11.1.0"
+  }
+}

package/src/macos_scroll_monitor.mm

@@ -0,0 +1,97 @@
+#include <napi.h>
+#import <AppKit/AppKit.h>
+
+class ScrollMonitor : public Napi::Addon<ScrollMonitor> {
+public:
+    // 构造函数：关联 JavaScript 方法与 C++ 实现
+    ScrollMonitor(Napi::Env env, Napi::Object exports) {
+        DefineAddon(exports, {
+            InstanceMethod("start", &ScrollMonitor::Start),
+            InstanceMethod("stop", &ScrollMonitor::Stop)
+        });
+    }
+
+private:
+    id _eventMonitor = nil;             // 存储 macOS 原生监听器引用
+    Napi::ThreadSafeFunction _tsfn;     // 用于跨线程（系统事件线程 -> JS 线程）安全通信
+
+    // 内部结构体：封装需要传回 JS 的事件数据
+    struct ScrollEventData {
+        double deltaY;
+        bool command;
+        bool shift;
+        bool option;
+        bool ctrl;
+        bool fn;
+    };
+
+    // 启动监听逻辑
+    Napi::Value Start(const Napi::CallbackInfo& info) {
+        Napi::Env env = info.Env();
+        
+        // 防护逻辑：避免重复启动导致内存泄漏或多次监听
+        if (_eventMonitor != nil || _tsfn) return env.Undefined();
+
+        // 验证参数：确保第一个参数是回调函数
+        if (info.Length() < 1 || !info[0].IsFunction()) {
+            Napi::TypeError::New(env, "Callback function expected").ThrowAsJavaScriptException();
+            return env.Undefined();
+        }
+
+        Napi::Function cb = info[0].As<Napi::Function>();
+        
+        // 创建线程安全函数。Resource Name 设为 MacOSGlobalScrollMonitor 方便调试
+        _tsfn = Napi::ThreadSafeFunction::New(env, cb, "MacOSGlobalScrollMonitor", 0, 1);
+
+        // 调用 AppKit API 添加全局滚动监控
+        _eventMonitor = [NSEvent addGlobalMonitorForEventsMatchingMask:NSEventMaskScrollWheel
+                                                              handler:^(NSEvent* event) {
+            // 获取修饰键掩码
+            NSEventModifierFlags flags = [event modifierFlags];
+            
+            // 填充数据结构
+            ScrollEventData data;
+            data.deltaY = [event deltaY];
+            data.command = (flags & NSEventModifierFlagCommand) != 0;
+            data.shift = (flags & NSEventModifierFlagShift) != 0;
+            data.option = (flags & NSEventModifierFlagOption) != 0;
+            data.ctrl = (flags & NSEventModifierFlagControl) != 0;
+            data.fn = (flags & NSEventModifierFlagFunction) != 0; // 原生支持 fn 键监测
+
+            // 将数据异步推送到 Node.js 主线程
+            _tsfn.BlockingCall([data](Napi::Env env, Napi::Function jsCallback) {
+                Napi::Object obj = Napi::Object::New(env);
+                obj.Set("deltaY", Napi::Number::New(env, data.deltaY));
+                obj.Set("command", Napi::Boolean::New(env, data.command));
+                obj.Set("shift", Napi::Boolean::New(env, data.shift));
+                obj.Set("option", Napi::Boolean::New(env, data.option));
+                obj.Set("ctrl", Napi::Boolean::New(env, data.ctrl));
+                obj.Set("fn", Napi::Boolean::New(env, data.fn));
+                
+                jsCallback.Call({ obj });
+            });
+        }];
+
+        return Napi::Boolean::New(env, true);
+    }
+
+    // 停止监听逻辑
+    Napi::Value Stop(const Napi::CallbackInfo& info) {
+        // 移除 macOS 系统级监听器
+        if (_eventMonitor != nil) {
+            [NSEvent removeMonitor:_eventMonitor];
+            _eventMonitor = nil;
+        }
+
+        // 安全释放线程安全函数，并显式置空
+        if (_tsfn) {
+            _tsfn.Release();
+            _tsfn = nullptr;
+        }
+        
+        return info.Env().Undefined();
+    }
+};
+
+// 导出插件，类名为 ScrollMonitor
+NODE_API_ADDON(ScrollMonitor)