node-native-win-utils 1.4.0 → 2.1.0

package/README.md

@@ -67,9 +67,7 @@ To use the package, import the necessary functions, types, and classes:
 
 import {
 
-keyDownHandler,
-
-keyUpHandler,
+KeyboardListener
 
 getWindowData,
 
@@ -93,38 +91,30 @@ OpenCV,
 
   
 
-## Key Event Listeners
+## Keyboard Event Listener
 
   
 
-The package provides `keyDownHandler` and `keyUpHandler` functions, which allow you to register callbacks for key down and key up events, respectively. The callbacks receive the `keyCode` as a parameter:
+The package provides KeyboardListener singletone class, which allow you to register event listeners for key down and key up events, respectively. The event callbacks receive the `keyCode` as a parameter:
 
   
 
 ```javascript
 
-keyDownHandler((keyCode) => {
-
-console.log("Key down:", keyCode);
-
-});
-
-  
-
-// Key down: 8
-
-  
-
-keyUpHandler((keyCode) => {
-
-console.log("Key up:", keyCode);
-
-});
-
-  
-
-// Key up: 8
-
+const listener = KeyboardListener.listener()
+
+listener.on("keyDown", (data: {
+        keyCode: number;
+        keyName: string;
+      }) => {
+//your code
+})
+listener.on("keyUp", (data: {
+        keyCode: number;
+        keyName: string;
+      }) => {
+    //your code
+})
 ```
 
 ## Key Press
@@ -473,18 +463,16 @@ Writes the current image to a file specified by the `path`.
 
 | Function        | Parameters                                                                                   | Return Type |
 |-----------------|----------------------------------------------------------------------------------------------|-------------|
-| keyDownHandler  | `callback: (keyCode: number) => void`                                                         | `void`      |
-| keyUpHandler    | `callback: (keyCode: number) => void`                                                         | `void`      |
-| getWindowData   | `windowName: string`                                                                         | `WindowData`|
+| getWindowData   | `windowName: string`                                                                          | `WindowData`|
 | captureWindow   | `windowName: string, outputPath: string`                                                      | `void`      |
 | mouseMove       | `posX: number, posY: number`                                                                  | `boolean`   |
 | mouseClick      | `button?: "left" \| "middle" \| "right"`                                                      | `boolean`   |
-| mouseDrag       | `startX: number, startY: number, endX: number, endY: number, speed?: number`                | `boolean`   |
+| mouseDrag       | `startX: number, startY: number, endX: number, endY: number, speed?: number`                  | `boolean`   |
 | typeString      | `stringToType: string, delay?: number`                                                        | `boolean`   |
-| captureWindowN  | `windowName: string`                                                                         | `Buffer`    |
-| keyPress        | `keyCode: number, repeat?: number`                                                           | `boolean`   |
-
-
+| captureWindowN  | `windowName: string`                                                                          | `Buffer`    |
+| keyPress        | `keyCode: number, repeat?: number`                                                            | `boolean`   |
+| textRecognition | `trainedDataPath: string, dataLang: string, imagePath: string`                                | `string`    |
+| captureScreenToFile | `path: string`                                                                            | `boolean`   |
   
 
 ## Examples
@@ -493,7 +481,10 @@ Writes the current image to a file specified by the `path`.
 
 Here are some examples of using the package:
 
-  
+```javascript
+console.log(textRecognition(path.join(__dirname, 'traineddata'), 'eng', path.join(__dirname, 'images', '1.jpg'))) // ---> <recognized text>
+
+```
 
 ```javascript
 
@@ -577,10 +568,6 @@ Please note that the above example demonstrates the usage of different methods a
 
 import {
 
-keyDownHandler,
-
-keyUpHandler,
-
 getWindowData,
 
 captureWindow,
@@ -599,34 +586,6 @@ KeyListener,
 
   
 
-// Register key event handlers
-
-  
-
-keyDownHandler((keyCode) => {
-
-console.log("Key down:", keyCode);
-
-});
-
-  
-
-// Key down: 123
-
-  
-
-keyUpHandler((keyCode) => {
-
-console.log("Key up:", keyCode);
-
-});
-
-  
-
-// Key up: 123
-
-  
-
 // Retrieve window data
 
   
@@ -699,11 +658,11 @@ typeString("Hello, world!", 100); // Type with a delay of 100ms between characte
 
   
 
-// Use KeyListener class
+// Use KeyboardListener class
 
   
 
-const  listener  =  new  KeyListener();
+const  listener  =  KeyboardListener.listener();
 
   
 
@@ -734,18 +693,6 @@ console.log("Key up:", data.keyCode, data.keyName);
 
 ```
 
-# TODO
-
-  
-
-- Write proper tests
-
-- Add more useful functions
-
-- Fix issue with Windows scale for font,text,apps
-
-  
-
 [OpenCV License](https://github.com/opencv/opencv/blob/master/LICENSE)
 [MIT License](https://github.com/T-Rumibul/node-native-win-utils/blob/main/LICENSE)
   

package/binding.gyp

@@ -17,6 +17,8 @@
             "libraries": [
                 "dwmapi.lib",
                 "windowsapp.lib",
+                "-lgdi32", 
+                "-lgdiplus",
                 "<!(node -p \"require('path').resolve('libs/libjpeg-turbo.lib')\")",
                 "<!(node -p \"require('path').resolve('libs/libpng.lib')\")",
                 "<!(node -p \"require('path').resolve('libs/zlib.lib')\")",

package/dist/dirnameLocal.cjs

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__dirnameLocal = void 0;
+exports.__dirnameLocal = __dirname;

package/dist/dirnameLocal.d.cts

@@ -0,0 +1 @@
+export declare const __dirnameLocal: string;

package/dist/dirnameLocal.d.mts

@@ -0,0 +1 @@
+export declare const __dirnameLocal: string;

package/dist/dirnameLocal.mjs

@@ -0,0 +1,2 @@
+import * as url from 'url';
+export const __dirnameLocal = url.fileURLToPath(new URL('.', import.meta.url));

package/dist/{index.js → index.cjs}

@@ -3,18 +3,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.textRecognition = exports.KeyCodeHelper = exports.rawPressKey = exports.typeString = exports.mouseDrag = exports.mouseClick = exports.mouseMove = exports.captureWindowN = exports.getWindowData = exports.keyUpHandler = exports.keyDownHandler = exports.OpenCV = exports.KeyListener = void 0;
+exports.OpenCV = exports.KeyboardListener = exports.textRecognition = exports.KeyCodeHelper = exports.rawPressKey = exports.typeString = exports.mouseDrag = exports.mouseClick = exports.mouseMove = exports.captureWindowN = exports.getWindowData = void 0;
 exports.captureWindow = captureWindow;
 exports.keyPress = keyPress;
-const EventEmitter = require("events");
+exports.captureScreenToFile = captureScreenToFile;
+//@ts-nocheck 
+const events_1 = __importDefault(require("events"));
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
-const bindings = require("node-gyp-build")(path_1.default.resolve(__dirname, ".."));
-const keyCodes_1 = require("./keyCodes");
-Object.defineProperty(exports, "KeyCodeHelper", { enumerable: true, get: function () { return keyCodes_1.KeyCodeHelper; } });
-const { keyDownHandler, keyUpHandler, getWindowData, captureWindowN, mouseMove, mouseClick, mouseDrag, typeString, pressKey, imread, imwrite, matchTemplate, blur, bgrToGray, drawRectangle, getRegion, textRecognition } = bindings;
-exports.keyDownHandler = keyDownHandler;
-exports.keyUpHandler = keyUpHandler;
+// @ts-ignore
+const nodeGypBuild = require("node-gyp-build");
+const keyCodes_cjs_1 = require("./keyCodes.cjs");
+Object.defineProperty(exports, "KeyCodeHelper", { enumerable: true, get: function () { return keyCodes_cjs_1.KeyCodeHelper; } });
+const dirnameLocal_cjs_1 = require("./dirnameLocal.cjs");
+const bindings = nodeGypBuild(path_1.default.resolve(dirnameLocal_cjs_1.__dirnameLocal, ".."));
+const { setKeyDownCallback, setKeyUpCallback, unsetKeyDownCallback, unsetKeyUpCallback, getWindowData, captureWindowN, captureScreenAsync, mouseMove, mouseClick, mouseDrag, typeString, pressKey, imread, imwrite, matchTemplate, blur, bgrToGray, drawRectangle, getRegion, textRecognition } = bindings;
 exports.getWindowData = getWindowData;
 exports.captureWindowN = captureWindowN;
 exports.mouseMove = mouseMove;
@@ -37,22 +40,37 @@ function captureWindow(windowName, path) {
     fs_1.default.writeFileSync(path, new Uint8Array(buffer));
     return true;
 }
+/**
+ * Captures a screen and saves it to a file.
+ * @param path - The file path to save the captured image.
+ * @returns True if the capture and save operation is successful, otherwise false.
+ */
+function captureScreenToFile(path) {
+    return new Promise((resolve, reject) => {
+        captureScreenAsync().then((buffer) => {
+            fs_1.default.writeFileSync(path, new Uint8Array(buffer));
+            resolve(true);
+        }).catch((err => {
+            reject(err);
+        }));
+    });
+}
 /**
  * Represents a class to listen to keyboard events.
  * @extends EventEmitter
  */
-class KeyListener extends EventEmitter {
+class KeyboardListenerPrivate extends events_1.default {
     constructor() {
         super();
-        keyDownHandler((keyCode) => {
-            const keyName = keyCodes_1.keyCodes.get(keyCode.toString());
+        setKeyDownCallback((keyCode) => {
+            const keyName = keyCodes_cjs_1.keyCodes.get(keyCode.toString());
             this.emit("keyDown", {
                 keyCode,
                 keyName,
             });
         });
-        keyUpHandler((keyCode) => {
-            const keyName = keyCodes_1.keyCodes.get(keyCode.toString());
+        setKeyUpCallback((keyCode) => {
+            const keyName = keyCodes_cjs_1.keyCodes.get(keyCode.toString());
             this.emit("keyUp", {
                 keyCode,
                 keyName,
@@ -60,7 +78,20 @@ class KeyListener extends EventEmitter {
         });
     }
 }
-exports.KeyListener = KeyListener;
+class KeyboardListener {
+    static listenerInstance = null;
+    static listener() {
+        if (!this.listenerInstance)
+            this.listenerInstance = new KeyboardListenerPrivate();
+        return this.listenerInstance;
+    }
+    static destroy() {
+        this.listenerInstance = null;
+        unsetKeyDownCallback();
+        unsetKeyUpCallback();
+    }
+}
+exports.KeyboardListener = KeyboardListener;
 /**
  * Represents the OpenCV class that provides image processing functionality.
  */
@@ -154,7 +185,7 @@ function keyPress(keyCode, repeat) {
                 reject('Something went wrong');
             return resolve(true);
         }
-        for (let i = 0; i < repeat; i++) {
+        for (let i = 0; i <= repeat; i++) {
             let result = rawPressKey(keyCode);
             if (!result)
                 reject('Something went wrong');

package/dist/{index.d.ts → index.d.cts}

@@ -1,5 +1,5 @@
-import EventEmitter = require("events");
-import { KeyCodeHelper } from "./keyCodes";
+import EventEmitter from 'events';
+import { KeyCodeHelper } from "./keyCodes.cjs";
 /**
  * Represents the data of a window.
  */
@@ -35,15 +35,15 @@ export type MatchData = {
 export type GetWindowData = (windowName: string) => WindowData;
 export type CaptureWindow = (windowName: string) => Buffer;
 /**
- * The handler to listen to key-down events.
+ * The handler to listen to key-events.
  * @param callback - The callback function to handle key-down events.
  */
-export type KeyDownHandler = (callback: (keyCode: number) => void) => void;
+export type SetKeyCallback = (callback: (keyCode: number) => void) => void;
 /**
- * The handler to listen to key-up events.
- * @param callback - The callback function to handle key-up events.
+ * The handler to stop thread listening to key-events.
+ * @param callback - The callback function to handle key-down events.
  */
-export type KeyUpHandler = (callback: (keyCode: number) => void) => void;
+export type UnsetKeyCallback = () => void;
 /**
  * Function type for moving the mouse.
  */
@@ -81,7 +81,8 @@ export type BgrToGray = (image: ImageData) => ImageData;
 export type DrawRectangle = (image: ImageData, start: Point, end: Point, rgb: Color, thickness: number) => ImageData;
 export type GetRegion = (image: ImageData, region: ROI) => ImageData;
 export type TextRecognition = (trainedDataPath: string, dataLang: string, imagePath: string) => string;
-declare const keyDownHandler: KeyDownHandler, keyUpHandler: KeyUpHandler, getWindowData: GetWindowData, captureWindowN: CaptureWindow, mouseMove: MouseMove, mouseClick: MouseClick, mouseDrag: MouseDrag, typeString: TypeString, textRecognition: TextRecognition;
+export type CaptureScreenAsync = () => Promise<Buffer>;
+declare const getWindowData: GetWindowData, captureWindowN: CaptureWindow, mouseMove: MouseMove, mouseClick: MouseClick, mouseDrag: MouseDrag, typeString: TypeString, textRecognition: TextRecognition;
 declare const rawPressKey: PressKey;
 /**
  * Captures a window and saves it to a file.
@@ -90,7 +91,13 @@ declare const rawPressKey: PressKey;
  * @returns True if the capture and save operation is successful, otherwise false.
  */
 declare function captureWindow(windowName: string, path: string): boolean;
-export interface KeyListener extends EventEmitter {
+/**
+ * Captures a screen and saves it to a file.
+ * @param path - The file path to save the captured image.
+ * @returns True if the capture and save operation is successful, otherwise false.
+ */
+declare function captureScreenToFile(path: string): Promise<boolean>;
+interface KeyboardListenerPrivate extends EventEmitter {
     /**
      * Event: Fires when a key is pressed down.
      * @param event - The event name ('keyDown').
@@ -114,13 +121,18 @@ export interface KeyListener extends EventEmitter {
  * Represents a class to listen to keyboard events.
  * @extends EventEmitter
  */
-export declare class KeyListener extends EventEmitter {
+declare class KeyboardListenerPrivate extends EventEmitter {
     constructor();
 }
+declare class KeyboardListener {
+    private static listenerInstance;
+    static listener(): KeyboardListenerPrivate;
+    static destroy(): void;
+}
 /**
  * Represents the OpenCV class that provides image processing functionality.
  */
-export declare class OpenCV {
+declare class OpenCV {
     imageData: ImageData;
     /**
      * Represents the OpenCV class that provides image processing functionality.
@@ -176,4 +188,4 @@ export declare class OpenCV {
     imwrite(path: string): void;
 }
 declare function keyPress(keyCode: number, repeat?: number): Promise<boolean>;
-export { keyDownHandler, keyUpHandler, getWindowData, captureWindow, captureWindowN, mouseMove, mouseClick, mouseDrag, typeString, keyPress, rawPressKey, KeyCodeHelper, textRecognition };
+export { getWindowData, captureWindow, captureWindowN, mouseMove, mouseClick, mouseDrag, typeString, keyPress, rawPressKey, KeyCodeHelper, textRecognition, captureScreenToFile, KeyboardListener, OpenCV };

package/dist/index.d.mts

@@ -0,0 +1,191 @@
+import EventEmitter from 'events';
+import { KeyCodeHelper } from "./keyCodes.mjs";
+/**
+ * Represents the data of a window.
+ */
+export type WindowData = {
+    width: number;
+    height: number;
+    x: number;
+    y: number;
+};
+/**
+ * Represents the data of an image.
+ */
+export type ImageData = {
+    width: number;
+    height: number;
+    data: Uint8Array;
+};
+/**
+ * Represents the result of a template matching operation.
+ */
+export type MatchData = {
+    minValue: number;
+    maxValue: number;
+    minLocation: {
+        x: number;
+        y: number;
+    };
+    maxLocation: {
+        x: number;
+        y: number;
+    };
+};
+export type GetWindowData = (windowName: string) => WindowData;
+export type CaptureWindow = (windowName: string) => Buffer;
+/**
+ * The handler to listen to key-events.
+ * @param callback - The callback function to handle key-down events.
+ */
+export type SetKeyCallback = (callback: (keyCode: number) => void) => void;
+/**
+ * The handler to stop thread listening to key-events.
+ * @param callback - The callback function to handle key-down events.
+ */
+export type UnsetKeyCallback = () => void;
+/**
+ * Function type for moving the mouse.
+ */
+export type MouseMove = (posX: number, posY: number) => boolean;
+/**
+ * Function type for simulating a mouse click.
+ */
+export type MouseClick = (button?: "left" | "middle" | "right") => boolean;
+/**
+ * Function type for simulating typing.
+ */
+export type TypeString = (stringToType: string, delay?: number) => boolean;
+/**
+ * Function type for simulating key press and release.
+ */
+export type PressKey = (keyCode: number) => boolean;
+/**
+ * Function type for simulating a mouse drag operation.
+ */
+export type MouseDrag = (starX: number, startY: number, endX: Number, endY: number, speed?: number) => boolean;
+/**
+ * Represents a point in a two-dimensional space.
+ */
+export type Point = [x: number, y: number];
+export type Color = [r: number, g: number, b: number];
+/**
+ * Represents a region of interest in an image.
+ */
+export type ROI = [x: number, y: number, width: number, height: number];
+export type Imread = (path: string) => ImageData;
+export type Imwrite = (image: ImageData) => Buffer;
+export type MatchTemplate = (image: ImageData, template: ImageData, method?: number | null, mask?: ImageData) => MatchData;
+export type Blur = (image: ImageData, sizeX: number, sizeY: number) => ImageData;
+export type BgrToGray = (image: ImageData) => ImageData;
+export type DrawRectangle = (image: ImageData, start: Point, end: Point, rgb: Color, thickness: number) => ImageData;
+export type GetRegion = (image: ImageData, region: ROI) => ImageData;
+export type TextRecognition = (trainedDataPath: string, dataLang: string, imagePath: string) => string;
+export type CaptureScreenAsync = () => Promise<Buffer>;
+declare const getWindowData: GetWindowData, captureWindowN: CaptureWindow, mouseMove: MouseMove, mouseClick: MouseClick, mouseDrag: MouseDrag, typeString: TypeString, textRecognition: TextRecognition;
+declare const rawPressKey: PressKey;
+/**
+ * Captures a window and saves it to a file.
+ * @param windowName - The name of the window to capture.
+ * @param path - The file path to save the captured image.
+ * @returns True if the capture and save operation is successful, otherwise false.
+ */
+declare function captureWindow(windowName: string, path: string): boolean;
+/**
+ * Captures a screen and saves it to a file.
+ * @param path - The file path to save the captured image.
+ * @returns True if the capture and save operation is successful, otherwise false.
+ */
+declare function captureScreenToFile(path: string): Promise<boolean>;
+interface KeyboardListenerPrivate extends EventEmitter {
+    /**
+     * Event: Fires when a key is pressed down.
+     * @param event - The event name ('keyDown').
+     * @param callback - The callback function to handle the event.
+     */
+    on(event: "keyDown", callback: (data: {
+        keyCode: number;
+        keyName: string;
+    }) => void): this;
+    /**
+     * Event: Fires when a key is released.
+     * @param event - The event name ('keyUp').
+     * @param callback - The callback function to handle the event.
+     */
+    on(event: "keyUp", callback: (data: {
+        keyCode: number;
+        keyName: string;
+    }) => void): this;
+}
+/**
+ * Represents a class to listen to keyboard events.
+ * @extends EventEmitter
+ */
+declare class KeyboardListenerPrivate extends EventEmitter {
+    constructor();
+}
+declare class KeyboardListener {
+    private static listenerInstance;
+    static listener(): KeyboardListenerPrivate;
+    static destroy(): void;
+}
+/**
+ * Represents the OpenCV class that provides image processing functionality.
+ */
+declare class OpenCV {
+    imageData: ImageData;
+    /**
+     * Represents the OpenCV class that provides image processing functionality.
+     */
+    constructor(image: string | ImageData);
+    /**
+     * The width of the image.
+     */
+    get width(): number;
+    /**
+     * The height of the image.
+     */
+    get height(): number;
+    /**
+     * Matches a template image within the current image.
+     * @param template - The template image data to search for.
+     * @param method - The template matching method (optional).
+     * @param mask - The optional mask image data to apply the operation (optional).
+     * @returns The result of the template matching operation.
+     */
+    matchTemplate(template: ImageData, method?: number | null, mask?: ImageData): MatchData;
+    /**
+     * Applies a blur filter to the image.
+     * @param sizeX - The horizontal size of the blur filter.
+     * @param sizeY - The vertical size of the blur filter.
+     * @returns A new OpenCV instance with the blurred image data.
+     */
+    blur(sizeX: number, sizeY: number): OpenCV;
+    /**
+     * Converts the image from BGR to grayscale.
+     * @returns A new OpenCV instance with the grayscale image data.
+     */
+    bgrToGray(): OpenCV;
+    /**
+     * Draws a rectangle on the image.
+     * @param start - The starting point of the rectangle.
+     * @param end - The ending point of the rectangle.
+     * @param rgb - The color (RGB) of the rectangle.
+     * @param thickness - The thickness of the rectangle's border.
+     * @returns A new OpenCV instance with the image containing the drawn rectangle.
+     */
+    drawRectangle(start: Point, end: Point, rgb: Color, thickness: number): OpenCV;
+    /**
+     * Extracts a region of interest (ROI) from the image.
+     * @param region - The region of interest defined as [x, y, width, height].
+     * @returns A new OpenCV instance with the extracted region of interest.
+     */
+    getRegion(region: ROI): OpenCV;
+    /**
+     * Writes the image data to a file.
+     * @param path - The file path to save the image.
+     */
+    imwrite(path: string): void;
+}
+declare function keyPress(keyCode: number, repeat?: number): Promise<boolean>;
+export { getWindowData, captureWindow, captureWindowN, mouseMove, mouseClick, mouseDrag, typeString, keyPress, rawPressKey, KeyCodeHelper, textRecognition, captureScreenToFile, KeyboardListener, OpenCV };