simen-keyboard-listener 1.1.17 → 1.1.19

package/README.md

@@ -145,6 +145,21 @@ interface IGlobalKeyEvent {
 }
 ```
 
+### Context APIs (macOS & Windows)
+
+这些 API 在 macOS 和 Windows 上都可用：
+
+- `getSelectedTextSmart(): string | null` - 获取选中文本（必要时模拟 Cmd+C / Ctrl+C）
+- `getContextJSON(): string | null` - 获取完整上下文（JSON）
+- `getFrontmostAppInfo(): IAppInfo | null` - 获取前台应用信息
+- `getFocusedElementInfo(): IElementInfo | null` - 获取焦点元素信息
+- `getFocusedTextInfo(): ITextInfo | null` - 获取文本信息（选中/输入框等）
+- `getFocusedDOMInfo(): IDOMInfo | null` - 获取浏览器 DOM 信息（仅浏览器应用）
+
+**平台差异：**
+- macOS: 使用 Accessibility API，需要辅助功能权限
+- Windows: 使用 UI Automation API，无需特殊权限
+
 ## Supported Keys
 
 - **Modifiers**: FN (macOS), SHIFT, CTRL, ALT, META (Cmd/Win)

package/dist/index.d.mts

@@ -853,6 +853,47 @@ interface IGlobalKeyEvent {
 type IGlobalKeyDownMap = Record<string, boolean>;
 type IGlobalKeyListener = (event: IGlobalKeyEvent, isDown: IGlobalKeyDownMap) => void;
 type IPermissionLostListener = () => void;
+/**
+ * Frontmost app info - lightweight app context
+ */
+interface IFrontmostInfo {
+    readonly app: {
+        readonly name: string;
+        readonly bundleId: string;
+        readonly pid: number;
+        readonly appType: 'browser' | 'wechat' | 'editor' | 'terminal' | 'other';
+    };
+    readonly window: {
+        readonly title: string | null;
+        readonly url: string | null;
+    };
+}
+/**
+ * Unified page context info - the main context API structure
+ */
+interface IPageContextInfo {
+    readonly app: {
+        readonly name: string;
+        readonly bundleId: string;
+        readonly appType: 'browser' | 'wechat' | 'editor' | 'terminal' | 'other';
+    };
+    readonly window: {
+        readonly title: string | null;
+        readonly url: string | null;
+    };
+    readonly focusedElement: {
+        readonly role: string;
+        readonly isEditable: boolean;
+        readonly value: string | null;
+        readonly placeholder: string | null;
+        readonly label: string | null;
+    };
+    readonly selectedText: string | null;
+    readonly cursor: {
+        readonly position: number | null;
+        readonly line: number | null;
+    } | null;
+}
 interface IGlobalKeyboardListener {
     addListener(listener: IGlobalKeyListener): void;
     removeListener(listener: IGlobalKeyListener): void;
@@ -882,17 +923,32 @@ declare function createGlobalKeyboardListener(): IGlobalKeyboardListener;
  * Call this before starting the listener to provide better UX when permission is missing.
  */
 declare function checkKeyboardPermission(): boolean;
-declare function getFocusedInputValue(): string | null;
-declare function getFocusedInputSelectedText(): string | null;
 /**
- * 获取完整上下文信息（JSON 格式）
- * 包含：应用信息、焦点元素、选中文本、DOM 信息等
- * @returns JSON 字符串或 null
+ * Check if the currently focused element is editable
+ * @returns true if focused element is editable, false otherwise
+ */
+declare function isEditable(): boolean;
+/**
+ * Get the value of the currently focused input element
+ * @returns input value string or null
  */
-declare function getContextJSON(): string | null;
+declare function getFocusedValue(): string | null;
+/**
+ * Get frontmost app info (lightweight)
+ * Includes: app info, window title/url
+ * @returns frontmost info or null
+ */
+declare function getFrontmostInfo(): IFrontmostInfo | null;
+/**
+ * Get unified page context info
+ * Includes: app info, window info, focused element, selected text, cursor position
+ * @returns page context or null
+ */
+declare function getPageContext(): IPageContextInfo | null;
 /**
  * 智能获取选中文本
- * 优先用 Accessibility API，失败则用模拟 Cmd+C（支持微信等）
+ * - macOS: 优先用 Accessibility API，失败则用模拟 Cmd+C
+ * - Windows: 优先用 UI Automation，失败则用模拟 Ctrl+C
  * @returns 选中文本或 null
  */
 declare function getSelectedTextSmart(): string | null;
@@ -911,5 +967,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 IFrontmostInfo, type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, type IPageContextInfo, 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, getDesktopItems, getDesktopPath, getFileMetadata, getFilesMetadata, getFinderContext, getFinderCurrentFolder, getFinderSelection, getFinderWindows, getFocusedValue, getFrontmostApp$1 as getFrontmostApp, getFrontmostFromRunning, getFrontmostInfo, getGlobalKeyboardListener, getPageContext, getRecentDocuments, getRecentFiles, getRunningApps, getSelectedTextSmart, getSystemContext$1 as getSystemContext, isAppRunning, isEditable, isOsascriptAvailable, index as powershell, readFileContent, readMultipleFiles, setBlockSystemHotkeys, setBlockedShortcuts };

package/dist/index.d.ts

@@ -853,6 +853,47 @@ interface IGlobalKeyEvent {
 type IGlobalKeyDownMap = Record<string, boolean>;
 type IGlobalKeyListener = (event: IGlobalKeyEvent, isDown: IGlobalKeyDownMap) => void;
 type IPermissionLostListener = () => void;
+/**
+ * Frontmost app info - lightweight app context
+ */
+interface IFrontmostInfo {
+    readonly app: {
+        readonly name: string;
+        readonly bundleId: string;
+        readonly pid: number;
+        readonly appType: 'browser' | 'wechat' | 'editor' | 'terminal' | 'other';
+    };
+    readonly window: {
+        readonly title: string | null;
+        readonly url: string | null;
+    };
+}
+/**
+ * Unified page context info - the main context API structure
+ */
+interface IPageContextInfo {
+    readonly app: {
+        readonly name: string;
+        readonly bundleId: string;
+        readonly appType: 'browser' | 'wechat' | 'editor' | 'terminal' | 'other';
+    };
+    readonly window: {
+        readonly title: string | null;
+        readonly url: string | null;
+    };
+    readonly focusedElement: {
+        readonly role: string;
+        readonly isEditable: boolean;
+        readonly value: string | null;
+        readonly placeholder: string | null;
+        readonly label: string | null;
+    };
+    readonly selectedText: string | null;
+    readonly cursor: {
+        readonly position: number | null;
+        readonly line: number | null;
+    } | null;
+}
 interface IGlobalKeyboardListener {
     addListener(listener: IGlobalKeyListener): void;
     removeListener(listener: IGlobalKeyListener): void;
@@ -882,17 +923,32 @@ declare function createGlobalKeyboardListener(): IGlobalKeyboardListener;
  * Call this before starting the listener to provide better UX when permission is missing.
  */
 declare function checkKeyboardPermission(): boolean;
-declare function getFocusedInputValue(): string | null;
-declare function getFocusedInputSelectedText(): string | null;
 /**
- * 获取完整上下文信息（JSON 格式）
- * 包含：应用信息、焦点元素、选中文本、DOM 信息等
- * @returns JSON 字符串或 null
+ * Check if the currently focused element is editable
+ * @returns true if focused element is editable, false otherwise
+ */
+declare function isEditable(): boolean;
+/**
+ * Get the value of the currently focused input element
+ * @returns input value string or null
  */
-declare function getContextJSON(): string | null;
+declare function getFocusedValue(): string | null;
+/**
+ * Get frontmost app info (lightweight)
+ * Includes: app info, window title/url
+ * @returns frontmost info or null
+ */
+declare function getFrontmostInfo(): IFrontmostInfo | null;
+/**
+ * Get unified page context info
+ * Includes: app info, window info, focused element, selected text, cursor position
+ * @returns page context or null
+ */
+declare function getPageContext(): IPageContextInfo | null;
 /**
  * 智能获取选中文本
- * 优先用 Accessibility API，失败则用模拟 Cmd+C（支持微信等）
+ * - macOS: 优先用 Accessibility API，失败则用模拟 Cmd+C
+ * - Windows: 优先用 UI Automation，失败则用模拟 Ctrl+C
  * @returns 选中文本或 null
  */
 declare function getSelectedTextSmart(): string | null;
@@ -911,5 +967,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 IFrontmostInfo, type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, type IPageContextInfo, 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, getDesktopItems, getDesktopPath, getFileMetadata, getFilesMetadata, getFinderContext, getFinderCurrentFolder, getFinderSelection, getFinderWindows, getFocusedValue, getFrontmostApp$1 as getFrontmostApp, getFrontmostFromRunning, getFrontmostInfo, getGlobalKeyboardListener, getPageContext, getRecentDocuments, getRecentFiles, getRunningApps, getSelectedTextSmart, getSystemContext$1 as getSystemContext, isAppRunning, isEditable, isOsascriptAvailable, index as powershell, readFileContent, readMultipleFiles, setBlockSystemHotkeys, setBlockedShortcuts };

package/dist/index.js

@@ -40,7 +40,6 @@ __export(index_exports, {
   getAgentContext: () => getAgentContext,
   getClipboardContent: () => getClipboardContent,
   getClipboardText: () => getClipboardText,
-  getContextJSON: () => getContextJSON,
   getDesktopItems: () => getDesktopItems,
   getDesktopPath: () => getDesktopPath,
   getFileMetadata: () => getFileMetadata,
@@ -49,22 +48,25 @@ __export(index_exports, {
   getFinderCurrentFolder: () => getFinderCurrentFolder,
   getFinderSelection: () => getFinderSelection,
   getFinderWindows: () => getFinderWindows,
-  getFocusedInputSelectedText: () => getFocusedInputSelectedText,
-  getFocusedInputValue: () => getFocusedInputValue,
+  getFocusedValue: () => getFocusedValue,
   getFrontmostApp: () => getFrontmostApp,
   getFrontmostFromRunning: () => getFrontmostFromRunning,
+  getFrontmostInfo: () => getFrontmostInfo,
   getGlobalKeyboardListener: () => getGlobalKeyboardListener,
+  getPageContext: () => getPageContext,
   getRecentDocuments: () => getRecentDocuments,
   getRecentFiles: () => getRecentFiles,
   getRunningApps: () => getRunningApps,
   getSelectedTextSmart: () => getSelectedTextSmart,
   getSystemContext: () => getSystemContext,
   isAppRunning: () => isAppRunning,
+  isEditable: () => isEditable,
   isOsascriptAvailable: () => isOsascriptAvailable,
   powershell: () => powershell_exports,
   readFileContent: () => readFileContent,
   readMultipleFiles: () => readMultipleFiles,
-  setBlockSystemHotkeys: () => setBlockSystemHotkeys
+  setBlockSystemHotkeys: () => setBlockSystemHotkeys,
+  setBlockedShortcuts: () => setBlockedShortcuts
 });
 module.exports = __toCommonJS(index_exports);
 var path = __toESM(require("path"));
@@ -2288,6 +2290,14 @@ async function getSystemContext2(options) {
 
 // src/index.ts
 var import_meta = {};
+function tryParseJSON(json) {
+  if (!json) return null;
+  try {
+    return JSON.parse(json);
+  } catch {
+    return null;
+  }
+}
 var IS_MACOS2 = process.platform === "darwin";
 var IS_WINDOWS2 = process.platform === "win32";
 var PLATFORM_PACKAGES = {
@@ -2325,8 +2335,7 @@ function getNativeAddon() {
     try {
       const candidate = localRequire(packageName);
       const hasCoreFunctions = candidate && typeof candidate.start === "function" && typeof candidate.stop === "function" && typeof candidate.isRunning === "function" && typeof candidate.checkPermission === "function";
-      const hasMacOSFunctions = IS_MACOS2 ? typeof candidate.getFocusedInputValue === "function" && typeof candidate.getFocusedInputSelectedText === "function" : true;
-      if (hasCoreFunctions && hasMacOSFunctions) {
+      if (hasCoreFunctions) {
         nativeAddon = candidate;
         return nativeAddon;
       }
@@ -2488,48 +2497,50 @@ function ensureAccessibilityPermission(addon) {
   openMacAccessibilitySettings();
   return false;
 }
-function getFocusedInputValue() {
-  if (!IS_MACOS2) {
-    return null;
-  }
+function isEditable() {
+  if (!IS_MACOS2 && !IS_WINDOWS2) return false;
   const addon = getNativeAddon();
-  if (!ensureAccessibilityPermission(addon)) {
-    return null;
-  }
+  if (IS_MACOS2 && !ensureAccessibilityPermission(addon)) return false;
   try {
-    return addon.getFocusedInputValue();
+    return addon.isEditable?.() ?? false;
   } catch {
-    return null;
+    return false;
   }
 }
-function getFocusedInputSelectedText() {
-  if (!IS_MACOS2) {
-    return null;
-  }
+function getFocusedValue() {
+  if (!IS_MACOS2 && !IS_WINDOWS2) return null;
   const addon = getNativeAddon();
-  if (!ensureAccessibilityPermission(addon)) {
+  if (IS_MACOS2 && !ensureAccessibilityPermission(addon)) return null;
+  try {
+    return addon.getFocusedValue?.() ?? null;
+  } catch {
     return null;
   }
+}
+function getFrontmostInfo() {
+  if (!IS_MACOS2 && !IS_WINDOWS2) return null;
+  const addon = getNativeAddon();
+  if (IS_MACOS2 && !ensureAccessibilityPermission(addon)) return null;
   try {
-    return addon.getFocusedInputSelectedText();
+    return tryParseJSON(addon.getFrontmostInfoJSON?.() ?? null);
   } catch {
     return null;
   }
 }
-function getContextJSON() {
-  if (!IS_MACOS2) return null;
+function getPageContext() {
+  if (!IS_MACOS2 && !IS_WINDOWS2) return null;
   const addon = getNativeAddon();
-  if (!ensureAccessibilityPermission(addon)) return null;
+  if (IS_MACOS2 && !ensureAccessibilityPermission(addon)) return null;
   try {
-    return addon.getContextJSON?.() ?? null;
+    return tryParseJSON(addon.getPageContextJSON?.() ?? null);
   } catch {
     return null;
   }
 }
 function getSelectedTextSmart() {
-  if (!IS_MACOS2) return null;
+  if (!IS_MACOS2 && !IS_WINDOWS2) return null;
   const addon = getNativeAddon();
-  if (!ensureAccessibilityPermission(addon)) return null;
+  if (IS_MACOS2 && !ensureAccessibilityPermission(addon)) return null;
   try {
     return addon.getSelectedTextSmart?.() ?? null;
   } catch {
@@ -2546,6 +2557,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,
@@ -2558,7 +2579,6 @@ function setBlockSystemHotkeys(block) {
   getAgentContext,
   getClipboardContent,
   getClipboardText,
-  getContextJSON,
   getDesktopItems,
   getDesktopPath,
   getFileMetadata,
@@ -2567,20 +2587,23 @@ function setBlockSystemHotkeys(block) {
   getFinderCurrentFolder,
   getFinderSelection,
   getFinderWindows,
-  getFocusedInputSelectedText,
-  getFocusedInputValue,
+  getFocusedValue,
   getFrontmostApp,
   getFrontmostFromRunning,
+  getFrontmostInfo,
   getGlobalKeyboardListener,
+  getPageContext,
   getRecentDocuments,
   getRecentFiles,
   getRunningApps,
   getSelectedTextSmart,
   getSystemContext,
   isAppRunning,
+  isEditable,
   isOsascriptAvailable,
   powershell,
   readFileContent,
   readMultipleFiles,
-  setBlockSystemHotkeys
+  setBlockSystemHotkeys,
+  setBlockedShortcuts
 });

package/dist/index.mjs

@@ -2231,6 +2231,14 @@ async function getSystemContext2(options) {
 }
 
 // src/index.ts
+function tryParseJSON(json) {
+  if (!json) return null;
+  try {
+    return JSON.parse(json);
+  } catch {
+    return null;
+  }
+}
 var IS_MACOS2 = process.platform === "darwin";
 var IS_WINDOWS2 = process.platform === "win32";
 var PLATFORM_PACKAGES = {
@@ -2268,8 +2276,7 @@ function getNativeAddon() {
     try {
       const candidate = localRequire(packageName);
       const hasCoreFunctions = candidate && typeof candidate.start === "function" && typeof candidate.stop === "function" && typeof candidate.isRunning === "function" && typeof candidate.checkPermission === "function";
-      const hasMacOSFunctions = IS_MACOS2 ? typeof candidate.getFocusedInputValue === "function" && typeof candidate.getFocusedInputSelectedText === "function" : true;
-      if (hasCoreFunctions && hasMacOSFunctions) {
+      if (hasCoreFunctions) {
         nativeAddon = candidate;
         return nativeAddon;
       }
@@ -2431,48 +2438,50 @@ function ensureAccessibilityPermission(addon) {
   openMacAccessibilitySettings();
   return false;
 }
-function getFocusedInputValue() {
-  if (!IS_MACOS2) {
-    return null;
-  }
+function isEditable() {
+  if (!IS_MACOS2 && !IS_WINDOWS2) return false;
   const addon = getNativeAddon();
-  if (!ensureAccessibilityPermission(addon)) {
-    return null;
-  }
+  if (IS_MACOS2 && !ensureAccessibilityPermission(addon)) return false;
   try {
-    return addon.getFocusedInputValue();
+    return addon.isEditable?.() ?? false;
   } catch {
-    return null;
+    return false;
   }
 }
-function getFocusedInputSelectedText() {
-  if (!IS_MACOS2) {
-    return null;
-  }
+function getFocusedValue() {
+  if (!IS_MACOS2 && !IS_WINDOWS2) return null;
   const addon = getNativeAddon();
-  if (!ensureAccessibilityPermission(addon)) {
+  if (IS_MACOS2 && !ensureAccessibilityPermission(addon)) return null;
+  try {
+    return addon.getFocusedValue?.() ?? null;
+  } catch {
     return null;
   }
+}
+function getFrontmostInfo() {
+  if (!IS_MACOS2 && !IS_WINDOWS2) return null;
+  const addon = getNativeAddon();
+  if (IS_MACOS2 && !ensureAccessibilityPermission(addon)) return null;
   try {
-    return addon.getFocusedInputSelectedText();
+    return tryParseJSON(addon.getFrontmostInfoJSON?.() ?? null);
   } catch {
     return null;
   }
 }
-function getContextJSON() {
-  if (!IS_MACOS2) return null;
+function getPageContext() {
+  if (!IS_MACOS2 && !IS_WINDOWS2) return null;
   const addon = getNativeAddon();
-  if (!ensureAccessibilityPermission(addon)) return null;
+  if (IS_MACOS2 && !ensureAccessibilityPermission(addon)) return null;
   try {
-    return addon.getContextJSON?.() ?? null;
+    return tryParseJSON(addon.getPageContextJSON?.() ?? null);
   } catch {
     return null;
   }
 }
 function getSelectedTextSmart() {
-  if (!IS_MACOS2) return null;
+  if (!IS_MACOS2 && !IS_WINDOWS2) return null;
   const addon = getNativeAddon();
-  if (!ensureAccessibilityPermission(addon)) return null;
+  if (IS_MACOS2 && !ensureAccessibilityPermission(addon)) return null;
   try {
     return addon.getSelectedTextSmart?.() ?? null;
   } catch {
@@ -2489,6 +2498,16 @@ function setBlockSystemHotkeys(block) {
   } catch {
   }
 }
+function setBlockedShortcuts(shortcuts) {
+  if (!IS_MACOS2) {
+    return;
+  }
+  try {
+    const addon = getNativeAddon();
+    addon.setBlockedShortcuts?.(shortcuts);
+  } catch {
+  }
+}
 export {
   checkKeyboardPermission,
   createGlobalKeyboardListener,
@@ -2500,7 +2519,6 @@ export {
   getAgentContext,
   getClipboardContent,
   getClipboardText,
-  getContextJSON,
   getDesktopItems,
   getDesktopPath,
   getFileMetadata,
@@ -2509,20 +2527,23 @@ export {
   getFinderCurrentFolder,
   getFinderSelection,
   getFinderWindows,
-  getFocusedInputSelectedText,
-  getFocusedInputValue,
+  getFocusedValue,
   getFrontmostApp,
   getFrontmostFromRunning,
+  getFrontmostInfo,
   getGlobalKeyboardListener,
+  getPageContext,
   getRecentDocuments,
   getRecentFiles,
   getRunningApps,
   getSelectedTextSmart,
   getSystemContext,
   isAppRunning,
+  isEditable,
   isOsascriptAvailable,
   powershell_exports as powershell,
   readFileContent,
   readMultipleFiles,
-  setBlockSystemHotkeys
+  setBlockSystemHotkeys,
+  setBlockedShortcuts
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simen-keyboard-listener",
-  "version": "1.1.17",
+  "version": "1.1.19",
   "description": "Native global keyboard listener for macOS and Windows",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -16,7 +16,7 @@
     "dist"
   ],
   "scripts": {
-    "build:swift": "cd src/native && swiftc -O -parse-as-library -c ContextHelper.swift -o ContextHelper.o",
+    "build:swift": "cd src/native && MACOSX_DEPLOYMENT_TARGET=11.0 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",
@@ -49,8 +49,8 @@
     "node-addon-api": "^8.0.0"
   },
   "optionalDependencies": {
-    "@simen-keyboard-listener/darwin-arm64": "1.1.17",
-    "@simen-keyboard-listener/win32-x64": "1.1.17"
+    "@simen-keyboard-listener/darwin-arm64": "1.1.19",
+    "@simen-keyboard-listener/win32-x64": "1.1.19"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",