@miniben90/x-win 1.4.0 → 1.5.1

package/README.md

@@ -94,6 +94,36 @@ console.log(windows);
 }]
 ```
 
+### Subscribe to get the current active window
+
+Thread will be start to check every `100ms` for a new active window (checking window title, window id and process id).
+
+* `subscribeActiveWindow`: Create a subscription with a callback function
+* `unsubscribeActiveWindow`: Remove a specific subscription
+* `unsubscribeAllActiveWindow`: Remove all threads
+
+
+```typescript
+import { subscribeActiveWindow, unsubscribeActiveWindow, unsubscribeAllActiveWindow } from '@miniben90/x-win';
+
+const a = subscribeActiveWindow(activeWindow => {
+  console.log('test a', activeWindow);
+});
+
+const b = subscribeActiveWindow(activeWindow => {
+  console.log('test b', activeWindow);
+});
+
+
+const c = subscribeActiveWindow(activeWindow => {
+  console.log('test c', activeWindow);
+});
+
+setTimeout(() => unsubscribeActiveWindow(c), 5000);
+
+setTimeout(() => unsubscribeAllActiveWindow(), 10000);
+```
+
 # Linux
 
 Dependencies are required to be installed for development purposes.
@@ -103,7 +133,7 @@ sudo apt install libxcb1-dev libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0
 ```
 
 > ⚠️**Warning**
-> Recovery url is not available for linux dist
+> Recovery url is not available on linux
 
 # Darwin
 

package/index.d.ts

@@ -39,5 +39,94 @@ export interface WindowInfo {
   usage: UsageInfo
   url: string
 }
+/**
+ * Retrieve information about currently active window.
+ * Returns an object of `WindowInfo`.
+ *
+ * # Example
+ * ```javascript
+ * const currentWindow = activeWindow();
+ * console.log(currentWindow);
+ * ```
+ *
+ * # Information about Electron
+ *
+ * It is recommended to use this function within a worker to mitigate potential recovery issues on MacOS.
+*/
 export function activeWindow(): WindowInfo
+/**
+ * Retrieve information about currently open windows.
+ * Returns an array of `WindowInfo`, each containing details about a specific open window.
+ *
+ * # Example
+ * ```javascript
+ * const windows = openWindows();
+ * for (let i = 0; i < windows.length; i++) {
+ *   console.log(i, windows[i]);
+ * }
+ * ```
+ *
+ * # Information about Electron
+ *
+ * It is recommended to use this function within a worker to mitigate potential recovery issues on MacOS.
+*/
 export function openWindows(): Array<WindowInfo>
+/**
+ * Subscribe an observer thread to monitor changes in the active window.
+ *
+ * # Example
+ * ```javascript
+ * const a = subscribeActiveWindow((info) => {
+ *   t.log(a, info);
+ * });
+ * const b = subscribeActiveWindow((info) => {
+ *   t.log(b, info);
+ * });
+ * const c = subscribeActiveWindow((info) => {
+ *   t.log(c, info);
+ * });
+ *
+ * unsubscribeAllActiveWindow();
+ * ```
+*/
+export function subscribeActiveWindow(callback: (info: WindowInfo) => void): number
+/**
+ * Terminate and unsubscribe a specific observer using their ID.
+ *
+ * # Example
+ * ```javascript
+ * const a = subscribeActiveWindow((info) => {
+ *   t.log(a, info);
+ * });
+ * const b = subscribeActiveWindow((info) => {
+ *   t.log(b, info);
+ * });
+ * const c = subscribeActiveWindow((info) => {
+ *   t.log(c, info);
+ * });
+ *
+ * unsubscribeActiveWindow(a);
+ * unsubscribeActiveWindow(b);
+ * unsubscribeActiveWindow(c);
+ * ```
+*/
+export function unsubscribeActiveWindow(threadId: number): void
+/**
+ * Terminate and unsubscribe all observer threads monitoring changes in the active window.
+ *
+ * # Example
+ * ```javascript
+ * const a = subscribeActiveWindow((info) => {
+ *   t.log(a, info);
+ * });
+ * const b = subscribeActiveWindow((info) => {
+ *   t.log(b, info);
+ * });
+ * const c = subscribeActiveWindow((info) => {
+ *   t.log(c, info);
+ * });
+ *
+ * unsubscribeAllActiveWindow();
+ * ```
+*/
+export function unsubscribeAllActiveWindow(): void

package/index.js

@@ -281,7 +281,10 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { activeWindow, openWindows } = nativeBinding
+const { activeWindow, openWindows, subscribeActiveWindow, unsubscribeActiveWindow, unsubscribeAllActiveWindow } = nativeBinding
 
 module.exports.activeWindow = activeWindow
 module.exports.openWindows = openWindows
+module.exports.subscribeActiveWindow = subscribeActiveWindow
+module.exports.unsubscribeActiveWindow = unsubscribeActiveWindow
+module.exports.unsubscribeAllActiveWindow = unsubscribeAllActiveWindow

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@miniben90/x-win",
   "description": "This package allows you to retrieve precise information about active and open windows on Windows, MacOS, and Linux. You can obtain the position, size, title, and other memory of windows.",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "main": "index.js",
   "types": "index.d.ts",
   "files": [
@@ -61,12 +61,12 @@
   },
   "packageManager": "yarn@4.0.2",
   "optionalDependencies": {
-    "@miniben90/x-win-win32-x64-msvc": "1.4.0",
-    "@miniben90/x-win-darwin-x64": "1.4.0",
-    "@miniben90/x-win-linux-x64-gnu": "1.4.0",
-    "@miniben90/x-win-darwin-arm64": "1.4.0",
-    "@miniben90/x-win-win32-arm64-msvc": "1.4.0",
-    "@miniben90/x-win-win32-ia32-msvc": "1.4.0",
-    "@miniben90/x-win-darwin-universal": "1.4.0"
+    "@miniben90/x-win-win32-x64-msvc": "1.5.1",
+    "@miniben90/x-win-darwin-x64": "1.5.1",
+    "@miniben90/x-win-linux-x64-gnu": "1.5.1",
+    "@miniben90/x-win-darwin-arm64": "1.5.1",
+    "@miniben90/x-win-win32-arm64-msvc": "1.5.1",
+    "@miniben90/x-win-win32-ia32-msvc": "1.5.1",
+    "@miniben90/x-win-darwin-universal": "1.5.1"
   }
 }