@aspiresys/visor 1.3.5 → 1.4.1

package/dist/app.js

@@ -65,7 +65,7 @@ async function openApp(target) {
         if (!resolved) {
             throw new Error(`App not found: ${target}`);
         }
-        const firstPath = resolved.split("\n")[0].trim();
+        const firstPath = resolved.split('\n')[0].trim();
         (0, logger_1.log)(`[APP] Resolved path: ${firstPath}`);
         (0, child_process_1.exec)(`start "" "${firstPath}"`);
         await new Promise((r) => setTimeout(r, 5000));
@@ -117,6 +117,6 @@ async function execDetached(command) {
     (0, child_process_1.spawn)(command, [], {
         detached: true,
         shell: true,
-        stdio: "ignore",
+        stdio: 'ignore',
     }).unref();
 }

package/dist/config.js

@@ -5,6 +5,6 @@ exports.visorConfig = {
     initialized: false,
     scaleFactor: 1,
     debug: true,
-    imagePath: "",
-    outputPath: ""
+    imagePath: '',
+    outputPath: '',
 };

package/dist/dialog.js

@@ -15,18 +15,18 @@ function execAsync(command) {
         });
     });
 }
-async function alert(message, title = "Visor") {
+async function alert(message, title = 'Visor') {
     const command = `powershell -Command "Add-Type -AssemblyName PresentationFramework; [System.Windows.MessageBox]::Show('${message}','${title}') | Out-Null"`;
     await execAsync(command);
 }
-async function confirm(message, title = "Visor") {
+async function confirm(message, title = 'Visor') {
     const command = `powershell -Command "Add-Type -AssemblyName PresentationFramework; ` +
         `$result=[System.Windows.MessageBox]::Show('${message}','${title}','YesNo'); ` +
         `Write-Output $result"`;
     const result = await execAsync(command);
-    return result.trim() === "Yes";
+    return result.trim() === 'Yes';
 }
-async function prompt(message, title = "Visor") {
+async function prompt(message, title = 'Visor') {
     const command = `powershell -Command "Add-Type -AssemblyName Microsoft.VisualBasic; ` +
         `[Microsoft.VisualBasic.Interaction]::InputBox('${message}','${title}')"`;
     return await execAsync(command);

package/dist/display.js

@@ -13,7 +13,7 @@ function getWindowsScaleFactor() {
         const calculatedScale = Math.round((hardwareWidth / logicalWidth) * 100);
         return calculatedScale / 100;
     }
-    catch (error) {
+    catch {
         try {
             const regCmd = `powershell -NoProfile -Command "(Get-ItemProperty 'HKCU:\\Control Panel\\Desktop\\PerMonitorSettings\\*').DpiScale | Select-Object -First 1"`;
             const regVal = parseInt((0, child_process_1.execSync)(regCmd).toString().trim(), 10);
@@ -22,7 +22,7 @@ function getWindowsScaleFactor() {
                 return (indexMap[regVal] || 100) / 100;
             }
         }
-        catch (e) {
+        catch {
             return 1;
         }
         return 1;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { Key, Button, Point } from "@nut-tree-fork/nut-js";
-import { Offset, Region } from "./types";
+import { Key, Button, Point } from '@nut-tree-fork/nut-js';
+import { Offset, Region } from './types';
 declare class Visor {
     private mouse;
     private keyboard;
@@ -8,109 +8,124 @@ declare class Visor {
     private configWarningShown;
     private checkConfig;
     /**
-   * Moves the mouse cursor to the
-   * center of a specific screen region.
-   *
-   * Region coordinates typically come from:
-   * - visor.find()
-   * - visor.findAll()
-   * - OCR text matching
-   * - Visor Inspector
-   *
-   * Display scaling is automatically
-   * applied using the configured
-   * scale factor.
-   *
-   * @param region Screen region coordinates.
-   * @param offset Offset coords.
-   *
-   * @example
-   * await visor.moveToRegion({
-   *   x: 100,
-   *   y: 200,
-   *   width: 150,
-   *   height: 50
-   * });
-   */
+     * Returns the currently installed
+     * Visor package version.
+     *
+     * Useful for:
+     * - debugging
+     * - support tickets
+     * - framework validation
+     *
+     * @returns Package version string.
+     *
+     * @example
+     * console.log(visor.version());
+     */
+    version(): string;
+    /**
+     * Moves the mouse cursor to the
+     * center of a specific screen region.
+     *
+     * Region coordinates typically come from:
+     * - visor.find()
+     * - visor.findAll()
+     * - OCR text matching
+     * - Visor Inspector
+     *
+     * Display scaling is automatically
+     * applied using the configured
+     * scale factor.
+     *
+     * @param region Screen region coordinates.
+     * @param offset Offset coords.
+     *
+     * @example
+     * await visor.moveToRegion({
+     *   x: 100,
+     *   y: 200,
+     *   width: 150,
+     *   height: 50
+     * });
+     */
     moveToRegion(region: Region, offset?: Offset): Promise<void>;
     /**
-   * Performs a left mouse click at the
-   * center of a specific screen region.
-   *
-   * Region coordinates typically come from:
-   * - visor.find()
-   * - visor.findAll()
-   * - OCR text matching
-   * - Visor Inspector
-   *
-   * Display scaling is automatically
-   * applied using the configured
-   * scale factor.
-   *
-   * @param region Screen region coordinates.
-   * @param offset Offset coords.
-   *
-   * @example
-   * await visor.clickRegion({
-   *   x: 100,
-   *   y: 200,
-   *   width: 150,
-   *   height: 50
-   * });
-   */
+     * Performs a left mouse click at the
+     * center of a specific screen region.
+     *
+     * Region coordinates typically come from:
+     * - visor.find()
+     * - visor.findAll()
+     * - OCR text matching
+     * - Visor Inspector
+     *
+     * Display scaling is automatically
+     * applied using the configured
+     * scale factor.
+     *
+     * @param region Screen region coordinates.
+     * @param offset Offset coords.
+     *
+     * @example
+     * await visor.clickRegion({
+     *   x: 100,
+     *   y: 200,
+     *   width: 150,
+     *   height: 50
+     * });
+     */
     clickRegion(region: Region, offset?: Offset): Promise<void>;
     /**
-   * Performs a double left mouse click
-   * at the center of a specific
-   * screen region.
-   *
-   * Region coordinates typically come from:
-   * - visor.find()
-   * - visor.findAll()
-   * - OCR text matching
-   * - Visor Inspector
-   *
-   * Display scaling is automatically
-   * applied using the configured
-   * scale factor.
-   *
-   * @param region Screen region coordinates.
-   * @param offset Offset coords.
-   *
-   * @example
-   * await visor.doubleClickRegion({
-   *   x: 100,
-   *   y: 200,
-   *   width: 150,
-   *   height: 50
-   * });
-   */
+     * Performs a double left mouse click
+     * at the center of a specific
+     * screen region.
+     *
+     * Region coordinates typically come from:
+     * - visor.find()
+     * - visor.findAll()
+     * - OCR text matching
+     * - Visor Inspector
+     *
+     * Display scaling is automatically
+     * applied using the configured
+     * scale factor.
+     *
+     * @param region Screen region coordinates.
+     * @param offset Offset coords.
+     *
+     * @example
+     * await visor.doubleClickRegion({
+     *   x: 100,
+     *   y: 200,
+     *   width: 150,
+     *   height: 50
+     * });
+     */
     doubleClickRegion(region: Region, offset?: Offset): Promise<void>;
     /**
-   * Performs a right mouse click at the
-   * center of a specific screen region.
-   *
-   * Region coordinates typically come from:
-   * - visor.find()
-   * - visor.findAll()
-   * - OCR text matching
-   * - Visor Inspector
-   *
-   * Display scaling is automatically
-   * applied using the configured
-   * scale factor.
-   *
-   * @param region Screen region coordinates.
-   * @param offset Offset coords.
-   *
-   * @example
-   * await visor.rightClickRegion({
-   *   x: 100,
-   *   y: 200,
-   *   width: 150,
-   *   height: 50
-   * });
-   */
+     * Performs a right mouse click at the
+     * center of a specific screen region.
+     *
+     * Region coordinates typically come from:
+     * - visor.find()
+     * - visor.findAll()
+     * - OCR text matching
+     * - Visor Inspector
+     *
+     * Display scaling is automatically
+     * applied using the configured
+     * scale factor.
+     *
+     * @param region Screen region coordinates.
+     * @param offset Offset coords.
+     *
+     * @example
+     * await visor.rightClickRegion({
+     *   x: 100,
+     *   y: 200,
+     *   width: 150,
+     *   height: 50
+     * });
+     */
     rightClickRegion(region: Region, offset?: Offset): Promise<void>;
     /**
      * Finds an image on screen using OpenCV
@@ -770,6 +785,7 @@ declare class Visor {
      *   visor.getImagePath();
      */
     getImagePath(): string;
+    showConfig(): void;
     /**
      * Sets the default output path
      * used for visual automation APIs.
@@ -998,22 +1014,22 @@ declare class Visor {
      */
     terminateOCR(): Promise<void>;
     /**
-   * Executes a command and returns output.
-   *
-   * @example
-   * const output =
-   *   await visor.exec("ipconfig");
-   */
+     * Executes a command and returns output.
+     *
+     * @example
+     * const output =
+     *   await visor.exec("ipconfig");
+     */
     exec(command: string): Promise<string>;
     /**
-   * Starts a command without waiting
-   * for completion.
-   *
-   * @example
-   * await visor.execDetached(
-   *   "notepad"
-   * );
-   */
+     * Starts a command without waiting
+     * for completion.
+     *
+     * @example
+     * await visor.execDetached(
+     *   "notepad"
+     * );
+     */
     execDetached(command: string): Promise<void>;
     /**
      * Pastes text using keyboard automation.
@@ -1025,36 +1041,37 @@ declare class Visor {
      */
     paste(text: string): Promise<void>;
     /**
-   * Generates a alert box.
-   *
-   * @param message Text to display.
-   * @param title Title of the alert.
-   *
-   * @example
-   * await visor.alert("Execution Completed");
-   */
+     * Generates a alert box.
+     *
+     * @param message Text to display.
+     * @param title Title of the alert.
+     *
+     * @example
+     * await visor.alert("Execution Completed");
+     */
     alert(message: string, title?: string): Promise<void>;
     /**
-   * Generates a conform box with Yes/No.
-   *
-   * @param message Text to display.
-   * @param title Title of the window.
-   *
-   * @example
-   * await visor.conform("Continue Execution?");
-   */
+     * Generates a conform box with Yes/No.
+     *
+     * @param message Text to display.
+     * @param title Title of the window.
+     *
+     * @example
+     * await visor.conform("Continue Execution?");
+     */
     confirm(message: string, title?: string): Promise<boolean>;
     /**
-    * Generates a input box.
-    *
-    * @param message Text to display.
-    * @param title Title of the window.
-    *
-    * @example
-    * await visor.input("Enter Email");
-    */
+     * Generates a input box.
+     *
+     * @param message Text to display.
+     * @param title Title of the window.
+     *
+     * @example
+     * await visor.input("Enter Email");
+     */
     input(message: string, title?: string): Promise<string>;
 }
 export declare const visor: Visor;
-export { Region } from "./types";
-export type { Offset } from "./types";
+export { Region } from './types';
+export type { Offset } from './types';
+export { initializeOCR } from './ocr';