simen-keyboard-listener 1.1.16 → 1.1.18

package/dist/index.d.mts

@@ -911,5 +911,28 @@ declare function getSelectedTextSmart(): string | null;
  * @param block true = block all system hotkeys, false = allow normal behavior
  */
 declare function setBlockSystemHotkeys(block: boolean): void;
+/**
+ * Set the list of shortcut combinations that should block fn key (keyCode 179) events.
+ * This is used to prevent macOS emoji panel from appearing when using fn-based shortcuts.
+ *
+ * When enabled, the native event tap will return NULL for keyCode 179 events that match
+ * the blocked shortcuts, effectively preventing the emoji panel from opening.
+ *
+ * macOS only - no-op on other platforms.
+ *
+ * @param shortcuts Array of shortcut strings to block. Format: modifiers joined by "+",
+ *                  in order: ctrl, alt, shift, cmd, fn
+ *
+ * @example
+ * // Block single fn key press (prevents emoji panel)
+ * setBlockedShortcuts(['fn']);
+ *
+ * // Block fn and shift+fn combinations
+ * setBlockedShortcuts(['fn', 'shift+fn']);
+ *
+ * // Clear all blocked shortcuts (restore normal behavior)
+ * setBlockedShortcuts([]);
+ */
+declare function setBlockedShortcuts(shortcuts: string[]): void;
 
-export { type IAgentContext$1 as IAgentContext, type IAgentContextOptions$1 as IAgentContextOptions, type IClipboardContent$1 as IClipboardContent, type IDesktopItem$1 as IDesktopItem, type IExecuteOptions$1 as IExecuteOptions, type IExecuteResult$1 as IExecuteResult, type IFileContent$1 as IFileContent, type IFileMetadata$1 as IFileMetadata, type IFinderContext, type IFinderItem, type IFinderSelection, type IFinderWindow, type IFinderWindowInfo, type IFinderWindowItem, type IFrontmostApp$1 as IFrontmostApp, type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, type IPermissionLostListener, type IReadFileOptions$1 as IReadFileOptions, type IRecentFile$1 as IRecentFile, type IRunningApp$1 as IRunningApp, type ISelectedItem$1 as ISelectedItem, type ISystemContext$1 as ISystemContext, checkKeyboardPermission, createGlobalKeyboardListener, escapeForAppleScript, executeAndParse$1 as executeAndParse, executeAppleScript, executeAppleScriptLines, executeMultilineAndParse$1 as executeMultilineAndParse, getAgentContext$1 as getAgentContext, getClipboardContent$1 as getClipboardContent, getClipboardText$1 as getClipboardText, getContextJSON, getDesktopItems, getDesktopPath, getFileMetadata, getFilesMetadata, getFinderContext, getFinderCurrentFolder, getFinderSelection, getFinderWindows, getFocusedInputSelectedText, getFocusedInputValue, getFrontmostApp$1 as getFrontmostApp, getFrontmostFromRunning, getGlobalKeyboardListener, getRecentDocuments, getRecentFiles, getRunningApps, getSelectedTextSmart, getSystemContext$1 as getSystemContext, isAppRunning, isOsascriptAvailable, index as powershell, readFileContent, readMultipleFiles, setBlockSystemHotkeys };
+export { type IAgentContext$1 as IAgentContext, type IAgentContextOptions$1 as IAgentContextOptions, type IClipboardContent$1 as IClipboardContent, type IDesktopItem$1 as IDesktopItem, type IExecuteOptions$1 as IExecuteOptions, type IExecuteResult$1 as IExecuteResult, type IFileContent$1 as IFileContent, type IFileMetadata$1 as IFileMetadata, type IFinderContext, type IFinderItem, type IFinderSelection, type IFinderWindow, type IFinderWindowInfo, type IFinderWindowItem, type IFrontmostApp$1 as IFrontmostApp, type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, type IPermissionLostListener, type IReadFileOptions$1 as IReadFileOptions, type IRecentFile$1 as IRecentFile, type IRunningApp$1 as IRunningApp, type ISelectedItem$1 as ISelectedItem, type ISystemContext$1 as ISystemContext, checkKeyboardPermission, createGlobalKeyboardListener, escapeForAppleScript, executeAndParse$1 as executeAndParse, executeAppleScript, executeAppleScriptLines, executeMultilineAndParse$1 as executeMultilineAndParse, getAgentContext$1 as getAgentContext, getClipboardContent$1 as getClipboardContent, getClipboardText$1 as getClipboardText, getContextJSON, getDesktopItems, getDesktopPath, getFileMetadata, getFilesMetadata, getFinderContext, getFinderCurrentFolder, getFinderSelection, getFinderWindows, getFocusedInputSelectedText, getFocusedInputValue, getFrontmostApp$1 as getFrontmostApp, getFrontmostFromRunning, getGlobalKeyboardListener, getRecentDocuments, getRecentFiles, getRunningApps, getSelectedTextSmart, getSystemContext$1 as getSystemContext, isAppRunning, isOsascriptAvailable, index as powershell, readFileContent, readMultipleFiles, setBlockSystemHotkeys, setBlockedShortcuts };

package/dist/index.d.ts

@@ -911,5 +911,28 @@ declare function getSelectedTextSmart(): string | null;
  * @param block true = block all system hotkeys, false = allow normal behavior
  */
 declare function setBlockSystemHotkeys(block: boolean): void;
+/**
+ * Set the list of shortcut combinations that should block fn key (keyCode 179) events.
+ * This is used to prevent macOS emoji panel from appearing when using fn-based shortcuts.
+ *
+ * When enabled, the native event tap will return NULL for keyCode 179 events that match
+ * the blocked shortcuts, effectively preventing the emoji panel from opening.
+ *
+ * macOS only - no-op on other platforms.
+ *
+ * @param shortcuts Array of shortcut strings to block. Format: modifiers joined by "+",
+ *                  in order: ctrl, alt, shift, cmd, fn
+ *
+ * @example
+ * // Block single fn key press (prevents emoji panel)
+ * setBlockedShortcuts(['fn']);
+ *
+ * // Block fn and shift+fn combinations
+ * setBlockedShortcuts(['fn', 'shift+fn']);
+ *
+ * // Clear all blocked shortcuts (restore normal behavior)
+ * setBlockedShortcuts([]);
+ */
+declare function setBlockedShortcuts(shortcuts: string[]): void;
 
-export { type IAgentContext$1 as IAgentContext, type IAgentContextOptions$1 as IAgentContextOptions, type IClipboardContent$1 as IClipboardContent, type IDesktopItem$1 as IDesktopItem, type IExecuteOptions$1 as IExecuteOptions, type IExecuteResult$1 as IExecuteResult, type IFileContent$1 as IFileContent, type IFileMetadata$1 as IFileMetadata, type IFinderContext, type IFinderItem, type IFinderSelection, type IFinderWindow, type IFinderWindowInfo, type IFinderWindowItem, type IFrontmostApp$1 as IFrontmostApp, type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, type IPermissionLostListener, type IReadFileOptions$1 as IReadFileOptions, type IRecentFile$1 as IRecentFile, type IRunningApp$1 as IRunningApp, type ISelectedItem$1 as ISelectedItem, type ISystemContext$1 as ISystemContext, checkKeyboardPermission, createGlobalKeyboardListener, escapeForAppleScript, executeAndParse$1 as executeAndParse, executeAppleScript, executeAppleScriptLines, executeMultilineAndParse$1 as executeMultilineAndParse, getAgentContext$1 as getAgentContext, getClipboardContent$1 as getClipboardContent, getClipboardText$1 as getClipboardText, getContextJSON, getDesktopItems, getDesktopPath, getFileMetadata, getFilesMetadata, getFinderContext, getFinderCurrentFolder, getFinderSelection, getFinderWindows, getFocusedInputSelectedText, getFocusedInputValue, getFrontmostApp$1 as getFrontmostApp, getFrontmostFromRunning, getGlobalKeyboardListener, getRecentDocuments, getRecentFiles, getRunningApps, getSelectedTextSmart, getSystemContext$1 as getSystemContext, isAppRunning, isOsascriptAvailable, index as powershell, readFileContent, readMultipleFiles, setBlockSystemHotkeys };
+export { type IAgentContext$1 as IAgentContext, type IAgentContextOptions$1 as IAgentContextOptions, type IClipboardContent$1 as IClipboardContent, type IDesktopItem$1 as IDesktopItem, type IExecuteOptions$1 as IExecuteOptions, type IExecuteResult$1 as IExecuteResult, type IFileContent$1 as IFileContent, type IFileMetadata$1 as IFileMetadata, type IFinderContext, type IFinderItem, type IFinderSelection, type IFinderWindow, type IFinderWindowInfo, type IFinderWindowItem, type IFrontmostApp$1 as IFrontmostApp, type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, type IPermissionLostListener, type IReadFileOptions$1 as IReadFileOptions, type IRecentFile$1 as IRecentFile, type IRunningApp$1 as IRunningApp, type ISelectedItem$1 as ISelectedItem, type ISystemContext$1 as ISystemContext, checkKeyboardPermission, createGlobalKeyboardListener, escapeForAppleScript, executeAndParse$1 as executeAndParse, executeAppleScript, executeAppleScriptLines, executeMultilineAndParse$1 as executeMultilineAndParse, getAgentContext$1 as getAgentContext, getClipboardContent$1 as getClipboardContent, getClipboardText$1 as getClipboardText, getContextJSON, getDesktopItems, getDesktopPath, getFileMetadata, getFilesMetadata, getFinderContext, getFinderCurrentFolder, getFinderSelection, getFinderWindows, getFocusedInputSelectedText, getFocusedInputValue, getFrontmostApp$1 as getFrontmostApp, getFrontmostFromRunning, getGlobalKeyboardListener, getRecentDocuments, getRecentFiles, getRunningApps, getSelectedTextSmart, getSystemContext$1 as getSystemContext, isAppRunning, isOsascriptAvailable, index as powershell, readFileContent, readMultipleFiles, setBlockSystemHotkeys, setBlockedShortcuts };

package/dist/index.js

@@ -64,7 +64,8 @@ __export(index_exports, {
   powershell: () => powershell_exports,
   readFileContent: () => readFileContent,
   readMultipleFiles: () => readMultipleFiles,
-  setBlockSystemHotkeys: () => setBlockSystemHotkeys
+  setBlockSystemHotkeys: () => setBlockSystemHotkeys,
+  setBlockedShortcuts: () => setBlockedShortcuts
 });
 module.exports = __toCommonJS(index_exports);
 var path = __toESM(require("path"));
@@ -2546,6 +2547,16 @@ function setBlockSystemHotkeys(block) {
   } catch {
   }
 }
+function setBlockedShortcuts(shortcuts) {
+  if (!IS_MACOS2) {
+    return;
+  }
+  try {
+    const addon = getNativeAddon();
+    addon.setBlockedShortcuts?.(shortcuts);
+  } catch {
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   checkKeyboardPermission,
@@ -2582,5 +2593,6 @@ function setBlockSystemHotkeys(block) {
   powershell,
   readFileContent,
   readMultipleFiles,
-  setBlockSystemHotkeys
+  setBlockSystemHotkeys,
+  setBlockedShortcuts
 });

package/dist/index.mjs

@@ -2489,6 +2489,16 @@ function setBlockSystemHotkeys(block) {
   } catch {
   }
 }
+function setBlockedShortcuts(shortcuts) {
+  if (!IS_MACOS2) {
+    return;
+  }
+  try {
+    const addon = getNativeAddon();
+    addon.setBlockedShortcuts?.(shortcuts);
+  } catch {
+  }
+}
 export {
   checkKeyboardPermission,
   createGlobalKeyboardListener,
@@ -2524,5 +2534,6 @@ export {
   powershell_exports as powershell,
   readFileContent,
   readMultipleFiles,
-  setBlockSystemHotkeys
+  setBlockSystemHotkeys,
+  setBlockedShortcuts
 };

package/package.json

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