(#5) Added WindowActionProvider and libnut WindowAction implementation

Author: s1hofmann

lib/provider/native/libnut-window-action.class.ts

@@ -0,0 +1,46 @@
+import libnut = require("@nut-tree/libnut");
+import { Region } from "../../region.class";
+import { WindowActionProvider } from "./window-action-provider.interface";
+
+export class WindowAction implements WindowActionProvider {
+  public getWindows(): Promise<number[]> {
+    return new Promise<number[]>((resolve, reject) => {
+      try {
+        resolve(libnut.getWindows());
+      } catch (e) {
+        reject(e);
+      }
+    });
+  }
+
+  getActiveWindow(): Promise<number> {
+    return new Promise<number>((resolve, reject) => {
+      try {
+        resolve(libnut.getActiveWindow());
+      } catch (e) {
+        reject(e);
+      }
+    });
+  }
+
+  getWindowRegion(windowHandle: number): Promise<Region> {
+    return new Promise<Region>((resolve, reject) => {
+      try {
+        const windowRect = libnut.getWindowRect(windowHandle);
+        resolve(new Region(windowRect.x, windowRect.y, windowRect.width, windowRect.height));
+      } catch (e) {
+        reject(e);
+      }
+    });
+  }
+
+  getWindowTitle(windowHandle: number): Promise<string> {
+    return new Promise<string>((resolve, reject) => {
+      try {
+        resolve(libnut.getWindowTitle(windowHandle));
+      } catch (e) {
+        reject(e);
+      }
+    });
+  }
+}

lib/provider/native/window-action-provider.interface.ts

@@ -0,0 +1,37 @@
+import { Region } from "../../region.class";
+
+/**
+ * A WindowActionProvider should provide access to a system's window system
+ *
+ * @interface WindowActionProvider
+ */
+export interface WindowActionProvider {
+  /**
+   * {@link getWindows} returns a list of window handles for further processing.
+   * These window handles may serve as input to e.g. {@link getWindowTitle}
+   *
+   * @returns A list of window handles
+   */
+  getWindows(): Promise<number[]>;
+
+  /**
+   * {@link getActiveWindow} returns the window handle of the currently active foreground window
+   *
+   * @returns The handle to the currently active foreground window
+   */
+  getActiveWindow(): Promise<number>;
+
+  /**
+   * {@link getWindowTitle} returns the title of a window addressed via its window handle
+   *
+   * @returns A string representing the title of a window addressed via its window handle
+   */
+  getWindowTitle(windowHandle: number): Promise<string>;
+
+  /**
+   * {@link getWindowRegion} returns a {@link Region} object representing the size and position of the window addressed via its window handle
+   *
+   * @returns The {@link Region} occupied by the window addressed via its window handle
+   */
+  getWindowRegion(windowHandle: number): Promise<Region>;
+}