@miniben90/x-win 1.5.1 → 1.7.0

package/README.md

@@ -1,10 +1,12 @@
+# @miniben90/x-win
+
 [![CI](https://github.com/miniben-90/x-win/actions/workflows/CI.yml/badge.svg)](https://github.com/miniben-90/x-win/actions/workflows/CI.yml)
 [![Node version](https://img.shields.io/node/v/@miniben90/x-win.svg)](https://www.npmjs.com/package/@miniben90/x-win)
 ![npm type definitions](https://img.shields.io/npm/types/@miniben90/x-win)
+![NPM License](https://img.shields.io/npm/l/@miniben90/x-win)
+![NPM Version](https://img.shields.io/npm/v/%40miniben90%2Fx-win)
 
-# @miniben90/x-win
-
-This project uses Rust and napi-rs to make it easy to obtain the active window or an array of open windows. It works on Microsoft Windows (10, 11), [Linux (with X server)](#linux), and [macOS](#darwin).
+This project uses Rust and napi-rs to make it easy to obtain the active window or an array of open windows. It works on Microsoft Windows (10, 11), [Linux (with X server)](#linux), and [macOS 10.6+](#darwin).
 
 ## How to install
 
@@ -16,7 +18,7 @@ npm i @miniben90/x-win
 yarn add @miniben90/x-win
 ```
 
-## How to use
+## How to use x-win
 
 ### Get information about the currently active window
 
@@ -56,6 +58,18 @@ console.log(currentWindow);
 }
 ```
 
+You can also use asynchronous methods instead. To do so, you just have to use `activeWindowAsync`, for example:
+
+```typescript
+import { activeWindowAsync, type WindowInfo } from '@miniben90/x-win';
+
+activeWindow()
+.then((currentWindow: WindowInfo) => {
+  console.log(currentWindow);
+});
+
+```
+
 ### Get a list of open windows with information
 
 `exemple.ts`:
@@ -94,6 +108,18 @@ console.log(windows);
 }]
 ```
 
+You can also use asynchronous methods instead. To do so, you just have to use `openWindowsAsync`, for example:
+
+```typescript
+import { openWindowsAsync, type WindowInfo } from '@miniben90/x-win';
+
+openWindowsAsync()
+.then((windows: WindowInfo[]) => {
+  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).
@@ -135,7 +161,7 @@ sudo apt install libxcb1-dev libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0
 > ⚠️**Warning**
 > Recovery url is not available on linux
 
-# Darwin
+# Darwin (version 10.6+)
 
 ## Screen recording permission introduced in macOS 10.15 Catalina
 

package/index.d.ts

@@ -40,7 +40,7 @@ export interface WindowInfo {
   url: string
 }
 /**
- * Retrieve information about currently active window.
+ * Retrieve information the about currently active window.
  * Returns an object of `WindowInfo`.
  *
  * # Example
@@ -55,7 +55,24 @@ export interface WindowInfo {
 */
 export function activeWindow(): WindowInfo
 /**
- * Retrieve information about currently open windows.
+ * Retrieve information about the currently active window as a promise.
+ * Returns an object of `WindowInfo`.
+ *
+ * # Example
+ * ```javascript
+ * activeWindow()
+ * .then(currentWindow => {
+ *   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 activeWindowAsync(): Promise<WindowInfo>
+/**
+ * Retrieve information about the currently open windows.
  * Returns an array of `WindowInfo`, each containing details about a specific open window.
  *
  * # Example
@@ -71,6 +88,25 @@ export function activeWindow(): WindowInfo
  * It is recommended to use this function within a worker to mitigate potential recovery issues on MacOS.
 */
 export function openWindows(): Array<WindowInfo>
+/**
+ * Retrieve information about the currently open windows as a promise.
+ * Returns an array of `WindowInfo`, each containing details about a specific open window.
+ *
+ * # Example
+ * ```javascript
+ * openWindows()
+ * .then(windows => {
+ *   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 openWindowsAsync(): Promise<Array<WindowInfo>>
 /**
  * Subscribe an observer thread to monitor changes in the active window.
  *

package/index.js

@@ -281,10 +281,12 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { activeWindow, openWindows, subscribeActiveWindow, unsubscribeActiveWindow, unsubscribeAllActiveWindow } = nativeBinding
+const { activeWindow, activeWindowAsync, openWindows, openWindowsAsync, subscribeActiveWindow, unsubscribeActiveWindow, unsubscribeAllActiveWindow } = nativeBinding
 
 module.exports.activeWindow = activeWindow
+module.exports.activeWindowAsync = activeWindowAsync
 module.exports.openWindows = openWindows
+module.exports.openWindowsAsync = openWindowsAsync
 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.5.1",
+  "version": "1.7.0",
   "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.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"
+    "@miniben90/x-win-win32-x64-msvc": "1.7.0",
+    "@miniben90/x-win-darwin-x64": "1.7.0",
+    "@miniben90/x-win-linux-x64-gnu": "1.7.0",
+    "@miniben90/x-win-darwin-arm64": "1.7.0",
+    "@miniben90/x-win-win32-arm64-msvc": "1.7.0",
+    "@miniben90/x-win-win32-ia32-msvc": "1.7.0",
+    "@miniben90/x-win-darwin-universal": "1.7.0"
   }
 }