simen-keyboard-listener 1.1.2 → 1.1.4

package/dist/index.d.mts

@@ -37,5 +37,32 @@ declare function createGlobalKeyboardListener(): IGlobalKeyboardListener;
 declare function checkKeyboardPermission(): boolean;
 declare function getFocusedInputValue(): string | null;
 declare function getFocusedInputSelectedText(): string | null;
+/**
+ * 获取完整上下文信息（JSON 格式）
+ * 包含：应用信息、焦点元素、选中文本、DOM 信息等
+ * @returns JSON 字符串或 null
+ */
+declare function getContextJSON(): string | null;
+/**
+ * 智能获取选中文本
+ * 优先用 Accessibility API，失败则用模拟 Cmd+C（支持微信等）
+ * @returns 选中文本或 null
+ */
+declare function getSelectedTextSmart(): string | null;
+/**
+ * Set whether to block ALL system hotkeys involving modifier key combinations.
+ * This covers: Shift+Alt (IME switch), Ctrl+Shift (IME switch), Win+Space (IME switch),
+ * Alt release (menu activation), Win release (Start menu), etc.
+ *
+ * When enabled:
+ *   - On modifier key DOWN with another modifier held: inject F13 to break system hotkey detection
+ *   - On Alt release: inject F13 to prevent menu activation
+ *   - On Win release: inject Shift+Win sequence to prevent Start menu
+ *
+ * Windows only - no-op on other platforms.
+ *
+ * @param block true = block all system hotkeys, false = allow normal behavior
+ */
+declare function setBlockSystemHotkeys(block: boolean): void;
 
-export { type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, type IPermissionLostListener, checkKeyboardPermission, createGlobalKeyboardListener, getFocusedInputSelectedText, getFocusedInputValue, getGlobalKeyboardListener };
+export { type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, type IPermissionLostListener, checkKeyboardPermission, createGlobalKeyboardListener, getContextJSON, getFocusedInputSelectedText, getFocusedInputValue, getGlobalKeyboardListener, getSelectedTextSmart, setBlockSystemHotkeys };

package/dist/index.d.ts

@@ -37,5 +37,32 @@ declare function createGlobalKeyboardListener(): IGlobalKeyboardListener;
 declare function checkKeyboardPermission(): boolean;
 declare function getFocusedInputValue(): string | null;
 declare function getFocusedInputSelectedText(): string | null;
+/**
+ * 获取完整上下文信息（JSON 格式）
+ * 包含：应用信息、焦点元素、选中文本、DOM 信息等
+ * @returns JSON 字符串或 null
+ */
+declare function getContextJSON(): string | null;
+/**
+ * 智能获取选中文本
+ * 优先用 Accessibility API，失败则用模拟 Cmd+C（支持微信等）
+ * @returns 选中文本或 null
+ */
+declare function getSelectedTextSmart(): string | null;
+/**
+ * Set whether to block ALL system hotkeys involving modifier key combinations.
+ * This covers: Shift+Alt (IME switch), Ctrl+Shift (IME switch), Win+Space (IME switch),
+ * Alt release (menu activation), Win release (Start menu), etc.
+ *
+ * When enabled:
+ *   - On modifier key DOWN with another modifier held: inject F13 to break system hotkey detection
+ *   - On Alt release: inject F13 to prevent menu activation
+ *   - On Win release: inject Shift+Win sequence to prevent Start menu
+ *
+ * Windows only - no-op on other platforms.
+ *
+ * @param block true = block all system hotkeys, false = allow normal behavior
+ */
+declare function setBlockSystemHotkeys(block: boolean): void;
 
-export { type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, type IPermissionLostListener, checkKeyboardPermission, createGlobalKeyboardListener, getFocusedInputSelectedText, getFocusedInputValue, getGlobalKeyboardListener };
+export { type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, type IPermissionLostListener, checkKeyboardPermission, createGlobalKeyboardListener, getContextJSON, getFocusedInputSelectedText, getFocusedInputValue, getGlobalKeyboardListener, getSelectedTextSmart, setBlockSystemHotkeys };

package/dist/index.js

@@ -32,9 +32,12 @@ var index_exports = {};
 __export(index_exports, {
   checkKeyboardPermission: () => checkKeyboardPermission,
   createGlobalKeyboardListener: () => createGlobalKeyboardListener,
+  getContextJSON: () => getContextJSON,
   getFocusedInputSelectedText: () => getFocusedInputSelectedText,
   getFocusedInputValue: () => getFocusedInputValue,
-  getGlobalKeyboardListener: () => getGlobalKeyboardListener
+  getGlobalKeyboardListener: () => getGlobalKeyboardListener,
+  getSelectedTextSmart: () => getSelectedTextSmart,
+  setBlockSystemHotkeys: () => setBlockSystemHotkeys
 });
 module.exports = __toCommonJS(index_exports);
 var path = __toESM(require("path"));
@@ -43,6 +46,8 @@ var import_node_child_process = require("child_process");
 var import_node_module = require("module");
 var import_url = require("url");
 var import_meta = {};
+var IS_MACOS = process.platform === "darwin";
+var IS_WINDOWS = process.platform === "win32";
 var PLATFORM_PACKAGES = {
   "darwin-arm64": "@simen-keyboard-listener/darwin-arm64",
   "win32-x64": "@simen-keyboard-listener/win32-x64"
@@ -193,7 +198,7 @@ var NativeKeyboardListener = class _NativeKeyboardListener {
   }
 };
 function getGlobalKeyboardListener() {
-  if (process.platform !== "darwin" && process.platform !== "win32") {
+  if (!IS_MACOS && !IS_WINDOWS) {
     throw new Error(`Unsupported platform for global keyboard listener: ${process.platform}`);
   }
   return NativeKeyboardListener.getInstance();
@@ -202,7 +207,7 @@ function createGlobalKeyboardListener() {
   return getGlobalKeyboardListener();
 }
 function checkKeyboardPermission() {
-  if (process.platform !== "darwin" && process.platform !== "win32") {
+  if (!IS_MACOS && !IS_WINDOWS) {
     return false;
   }
   try {
@@ -214,7 +219,7 @@ function checkKeyboardPermission() {
 }
 var lastMacAccessibilitySettingsOpenTs = 0;
 function openMacAccessibilitySettings() {
-  if (process.platform !== "darwin") {
+  if (!IS_MACOS) {
     return;
   }
   const now = Date.now();
@@ -240,7 +245,7 @@ function ensureAccessibilityPermission(addon) {
   return false;
 }
 function getFocusedInputValue() {
-  if (process.platform !== "darwin") {
+  if (!IS_MACOS) {
     return null;
   }
   const addon = getNativeAddon();
@@ -254,7 +259,7 @@ function getFocusedInputValue() {
   }
 }
 function getFocusedInputSelectedText() {
-  if (process.platform !== "darwin") {
+  if (!IS_MACOS) {
     return null;
   }
   const addon = getNativeAddon();
@@ -267,11 +272,44 @@ function getFocusedInputSelectedText() {
     return null;
   }
 }
+function getContextJSON() {
+  if (!IS_MACOS) return null;
+  const addon = getNativeAddon();
+  if (!ensureAccessibilityPermission(addon)) return null;
+  try {
+    return addon.getContextJSON?.() ?? null;
+  } catch {
+    return null;
+  }
+}
+function getSelectedTextSmart() {
+  if (!IS_MACOS) return null;
+  const addon = getNativeAddon();
+  if (!ensureAccessibilityPermission(addon)) return null;
+  try {
+    return addon.getSelectedTextSmart?.() ?? null;
+  } catch {
+    return null;
+  }
+}
+function setBlockSystemHotkeys(block) {
+  if (!IS_WINDOWS) {
+    return;
+  }
+  try {
+    const addon = getNativeAddon();
+    addon.setBlockSystemHotkeys?.(block);
+  } catch {
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   checkKeyboardPermission,
   createGlobalKeyboardListener,
+  getContextJSON,
   getFocusedInputSelectedText,
   getFocusedInputValue,
-  getGlobalKeyboardListener
+  getGlobalKeyboardListener,
+  getSelectedTextSmart,
+  setBlockSystemHotkeys
 });

package/dist/index.mjs

@@ -11,6 +11,8 @@ import * as fs from "fs";
 import { execFileSync } from "child_process";
 import { createRequire } from "module";
 import { fileURLToPath } from "url";
+var IS_MACOS = process.platform === "darwin";
+var IS_WINDOWS = process.platform === "win32";
 var PLATFORM_PACKAGES = {
   "darwin-arm64": "@simen-keyboard-listener/darwin-arm64",
   "win32-x64": "@simen-keyboard-listener/win32-x64"
@@ -161,7 +163,7 @@ var NativeKeyboardListener = class _NativeKeyboardListener {
   }
 };
 function getGlobalKeyboardListener() {
-  if (process.platform !== "darwin" && process.platform !== "win32") {
+  if (!IS_MACOS && !IS_WINDOWS) {
     throw new Error(`Unsupported platform for global keyboard listener: ${process.platform}`);
   }
   return NativeKeyboardListener.getInstance();
@@ -170,7 +172,7 @@ function createGlobalKeyboardListener() {
   return getGlobalKeyboardListener();
 }
 function checkKeyboardPermission() {
-  if (process.platform !== "darwin" && process.platform !== "win32") {
+  if (!IS_MACOS && !IS_WINDOWS) {
     return false;
   }
   try {
@@ -182,7 +184,7 @@ function checkKeyboardPermission() {
 }
 var lastMacAccessibilitySettingsOpenTs = 0;
 function openMacAccessibilitySettings() {
-  if (process.platform !== "darwin") {
+  if (!IS_MACOS) {
     return;
   }
   const now = Date.now();
@@ -208,7 +210,7 @@ function ensureAccessibilityPermission(addon) {
   return false;
 }
 function getFocusedInputValue() {
-  if (process.platform !== "darwin") {
+  if (!IS_MACOS) {
     return null;
   }
   const addon = getNativeAddon();
@@ -222,7 +224,7 @@ function getFocusedInputValue() {
   }
 }
 function getFocusedInputSelectedText() {
-  if (process.platform !== "darwin") {
+  if (!IS_MACOS) {
     return null;
   }
   const addon = getNativeAddon();
@@ -235,10 +237,43 @@ function getFocusedInputSelectedText() {
     return null;
   }
 }
+function getContextJSON() {
+  if (!IS_MACOS) return null;
+  const addon = getNativeAddon();
+  if (!ensureAccessibilityPermission(addon)) return null;
+  try {
+    return addon.getContextJSON?.() ?? null;
+  } catch {
+    return null;
+  }
+}
+function getSelectedTextSmart() {
+  if (!IS_MACOS) return null;
+  const addon = getNativeAddon();
+  if (!ensureAccessibilityPermission(addon)) return null;
+  try {
+    return addon.getSelectedTextSmart?.() ?? null;
+  } catch {
+    return null;
+  }
+}
+function setBlockSystemHotkeys(block) {
+  if (!IS_WINDOWS) {
+    return;
+  }
+  try {
+    const addon = getNativeAddon();
+    addon.setBlockSystemHotkeys?.(block);
+  } catch {
+  }
+}
 export {
   checkKeyboardPermission,
   createGlobalKeyboardListener,
+  getContextJSON,
   getFocusedInputSelectedText,
   getFocusedInputValue,
-  getGlobalKeyboardListener
+  getGlobalKeyboardListener,
+  getSelectedTextSmart,
+  setBlockSystemHotkeys
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simen-keyboard-listener",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "Native global keyboard listener for macOS and Windows",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -16,10 +16,11 @@
     "dist"
   ],
   "scripts": {
-    "build:native": "node-gyp rebuild --directory=src/native",
+    "build:swift": "cd src/native && swiftc -O -parse-as-library -c ContextHelper.swift -o ContextHelper.o",
+    "build:native": "npm run build:swift && node-gyp rebuild --directory=src/native",
     "build:ts": "tsup src/index.ts --format cjs,esm --dts --clean",
     "build": "npm run build:native && npm run build:ts",
-    "prebuild": "prebuildify --napi --strip --cwd src/native --out ../../prebuilds",
+    "prebuild": "npm run build:swift && prebuildify --napi --strip --cwd src/native --out ../../prebuilds",
     "prepublishOnly": "npm run build:ts",
     "publish:all": "node scripts/publish.js"
   },
@@ -45,8 +46,8 @@
     "node-addon-api": "^8.0.0"
   },
   "optionalDependencies": {
-    "@simen-keyboard-listener/darwin-arm64": "1.1.2",
-    "@simen-keyboard-listener/win32-x64": "1.1.2"
+    "@simen-keyboard-listener/darwin-arm64": "1.1.4",
+    "@simen-keyboard-listener/win32-x64": "1.1.4"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",