simen-keyboard-listener 1.1.3 → 1.1.4

package/dist/index.d.mts

@@ -49,5 +49,20 @@ declare function getContextJSON(): string | null;
  * @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, getContextJSON, getFocusedInputSelectedText, getFocusedInputValue, getGlobalKeyboardListener, getSelectedTextSmart };
+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

@@ -49,5 +49,20 @@ declare function getContextJSON(): string | null;
  * @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, getContextJSON, getFocusedInputSelectedText, getFocusedInputValue, getGlobalKeyboardListener, getSelectedTextSmart };
+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

@@ -36,7 +36,8 @@ __export(index_exports, {
   getFocusedInputSelectedText: () => getFocusedInputSelectedText,
   getFocusedInputValue: () => getFocusedInputValue,
   getGlobalKeyboardListener: () => getGlobalKeyboardListener,
-  getSelectedTextSmart: () => getSelectedTextSmart
+  getSelectedTextSmart: () => getSelectedTextSmart,
+  setBlockSystemHotkeys: () => setBlockSystemHotkeys
 });
 module.exports = __toCommonJS(index_exports);
 var path = __toESM(require("path"));
@@ -45,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"
@@ -195,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();
@@ -204,7 +207,7 @@ function createGlobalKeyboardListener() {
   return getGlobalKeyboardListener();
 }
 function checkKeyboardPermission() {
-  if (process.platform !== "darwin" && process.platform !== "win32") {
+  if (!IS_MACOS && !IS_WINDOWS) {
     return false;
   }
   try {
@@ -216,7 +219,7 @@ function checkKeyboardPermission() {
 }
 var lastMacAccessibilitySettingsOpenTs = 0;
 function openMacAccessibilitySettings() {
-  if (process.platform !== "darwin") {
+  if (!IS_MACOS) {
     return;
   }
   const now = Date.now();
@@ -242,7 +245,7 @@ function ensureAccessibilityPermission(addon) {
   return false;
 }
 function getFocusedInputValue() {
-  if (process.platform !== "darwin") {
+  if (!IS_MACOS) {
     return null;
   }
   const addon = getNativeAddon();
@@ -256,7 +259,7 @@ function getFocusedInputValue() {
   }
 }
 function getFocusedInputSelectedText() {
-  if (process.platform !== "darwin") {
+  if (!IS_MACOS) {
     return null;
   }
   const addon = getNativeAddon();
@@ -270,7 +273,7 @@ function getFocusedInputSelectedText() {
   }
 }
 function getContextJSON() {
-  if (process.platform !== "darwin") return null;
+  if (!IS_MACOS) return null;
   const addon = getNativeAddon();
   if (!ensureAccessibilityPermission(addon)) return null;
   try {
@@ -280,7 +283,7 @@ function getContextJSON() {
   }
 }
 function getSelectedTextSmart() {
-  if (process.platform !== "darwin") return null;
+  if (!IS_MACOS) return null;
   const addon = getNativeAddon();
   if (!ensureAccessibilityPermission(addon)) return null;
   try {
@@ -289,6 +292,16 @@ function getSelectedTextSmart() {
     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,
@@ -297,5 +310,6 @@ function getSelectedTextSmart() {
   getFocusedInputSelectedText,
   getFocusedInputValue,
   getGlobalKeyboardListener,
-  getSelectedTextSmart
+  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();
@@ -236,7 +238,7 @@ function getFocusedInputSelectedText() {
   }
 }
 function getContextJSON() {
-  if (process.platform !== "darwin") return null;
+  if (!IS_MACOS) return null;
   const addon = getNativeAddon();
   if (!ensureAccessibilityPermission(addon)) return null;
   try {
@@ -246,7 +248,7 @@ function getContextJSON() {
   }
 }
 function getSelectedTextSmart() {
-  if (process.platform !== "darwin") return null;
+  if (!IS_MACOS) return null;
   const addon = getNativeAddon();
   if (!ensureAccessibilityPermission(addon)) return null;
   try {
@@ -255,6 +257,16 @@ function getSelectedTextSmart() {
     return null;
   }
 }
+function setBlockSystemHotkeys(block) {
+  if (!IS_WINDOWS) {
+    return;
+  }
+  try {
+    const addon = getNativeAddon();
+    addon.setBlockSystemHotkeys?.(block);
+  } catch {
+  }
+}
 export {
   checkKeyboardPermission,
   createGlobalKeyboardListener,
@@ -262,5 +274,6 @@ export {
   getFocusedInputSelectedText,
   getFocusedInputValue,
   getGlobalKeyboardListener,
-  getSelectedTextSmart
+  getSelectedTextSmart,
+  setBlockSystemHotkeys
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simen-keyboard-listener",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "Native global keyboard listener for macOS and Windows",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -46,8 +46,8 @@
     "node-addon-api": "^8.0.0"
   },
   "optionalDependencies": {
-    "@simen-keyboard-listener/darwin-arm64": "1.1.3",
-    "@simen-keyboard-listener/win32-x64": "1.1.3"
+    "@simen-keyboard-listener/darwin-arm64": "1.1.4",
+    "@simen-keyboard-listener/win32-x64": "1.1.4"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",