nautogui 0.3.1

package/dist/backend.js

@@ -0,0 +1,210 @@
+/**
+ * OS input backend via optional @nut-tree/nut-js (Windows / macOS / Linux).
+ */
+let nutCache;
+export async function loadNutJs() {
+    if (nutCache !== undefined)
+        return nutCache;
+    try {
+        nutCache = await import("@nut-tree/nut-js");
+        return nutCache;
+    }
+    catch {
+        nutCache = null;
+        return null;
+    }
+}
+export async function getNut() {
+    const n = await loadNutJs();
+    if (!n) {
+        throw new Error("@nut-tree/nut-js not installed");
+    }
+    return n;
+}
+export async function sleepMs(ms) {
+    const n = await getNut();
+    await n.sleep(Math.max(0, ms));
+}
+export async function screenSize() {
+    const n = await getNut();
+    return { width: await n.screen.width(), height: await n.screen.height() };
+}
+export async function mousePosition() {
+    const n = await getNut();
+    const p = await n.mouse.getPosition();
+    return { x: p.x, y: p.y };
+}
+export async function mouseSetPosition(x, y) {
+    const n = await getNut();
+    await n.mouse.setPosition({ x: Math.round(x), y: Math.round(y) });
+}
+export async function mouseLeftClick() {
+    const n = await getNut();
+    await n.mouse.leftClick();
+}
+export async function mouseRightClick() {
+    const n = await getNut();
+    await n.mouse.rightClick();
+}
+export async function mouseMiddleClick() {
+    const n = await getNut();
+    await n.mouse.click(n.Button.MIDDLE);
+}
+export async function mouseDoubleClick() {
+    const n = await getNut();
+    await n.mouse.doubleClick(n.Button.LEFT);
+}
+export async function mousePressButton(button = "left") {
+    const n = await getNut();
+    const btn = button === "right"
+        ? n.Button.RIGHT
+        : button === "middle"
+            ? n.Button.MIDDLE
+            : n.Button.LEFT;
+    await n.mouse.pressButton(btn);
+}
+export async function mouseReleaseButton(button = "left") {
+    const n = await getNut();
+    const btn = button === "right"
+        ? n.Button.RIGHT
+        : button === "middle"
+            ? n.Button.MIDDLE
+            : n.Button.LEFT;
+    await n.mouse.releaseButton(btn);
+}
+export async function mouseScrollDown(amount) {
+    const n = await getNut();
+    await n.mouse.scrollDown(amount);
+}
+export async function mouseScrollUp(amount) {
+    const n = await getNut();
+    await n.mouse.scrollUp(amount);
+}
+export async function mouseScrollLeft(amount) {
+    const n = await getNut();
+    await n.mouse.scrollLeft(amount);
+}
+export async function mouseScrollRight(amount) {
+    const n = await getNut();
+    await n.mouse.scrollRight(amount);
+}
+export async function keyboardType(text) {
+    const n = await getNut();
+    await n.keyboard.type(text);
+}
+export async function resolveNutKey(name) {
+    const n = await getNut();
+    const aliases = {
+        ctrl: "LeftControl",
+        control: "LeftControl",
+        shift: "LeftShift",
+        alt: "LeftAlt",
+        enter: "Enter",
+        return: "Enter",
+        esc: "Escape",
+        escape: "Escape",
+        tab: "Tab",
+        space: "Space",
+        backspace: "Backspace",
+        delete: "Delete",
+        del: "Delete",
+        up: "Up",
+        down: "Down",
+        left: "Left",
+        right: "Right",
+        home: "Home",
+        end: "End",
+        pageup: "PageUp",
+        pagedown: "PageDown",
+        win: "LeftWin",
+        cmd: "LeftWin",
+    };
+    const raw = name.trim();
+    const mapped = aliases[raw.toLowerCase()] ?? raw;
+    const key = n.Key[mapped];
+    if (key === undefined) {
+        throw new Error(`Unknown key: ${name}`);
+    }
+    return key;
+}
+export async function keyboardPressKey(name) {
+    const n = await getNut();
+    const key = await resolveNutKey(name);
+    await n.keyboard.pressKey(key);
+    await n.keyboard.releaseKey(key);
+}
+export async function keyboardPressCombo(keys) {
+    const n = await getNut();
+    const resolved = await Promise.all(keys.map((k) => resolveNutKey(k)));
+    await n.keyboard.pressKey(...resolved);
+    await n.keyboard.releaseKey(...resolved.reverse());
+}
+export async function keyboardKeyDown(name) {
+    const n = await getNut();
+    const key = await resolveNutKey(name);
+    await n.keyboard.pressKey(key);
+}
+export async function keyboardKeyUp(name) {
+    const n = await getNut();
+    const key = await resolveNutKey(name);
+    await n.keyboard.releaseKey(key);
+}
+export async function mouseDragPath(points) {
+    const n = await getNut();
+    await n.mouse.drag(points.map((p) => ({ x: Math.round(p.x), y: Math.round(p.y) })));
+}
+export async function captureScreenPng(dir, stem, region) {
+    const n = await getNut();
+    if (region) {
+        return n.screen.captureRegion(stem, new (await import("@nut-tree/shared")).Region(region.left, region.top, region.width, region.height), n.FileType.PNG, dir);
+    }
+    return n.screen.capture(stem, n.FileType.PNG, dir);
+}
+export async function pixelColorAt(x, y) {
+    const n = await getNut();
+    const rgba = await n.screen.colorAt({ x: Math.round(x), y: Math.round(y) });
+    return { r: rgba.R, g: rgba.G, b: rgba.B, a: rgba.A };
+}
+export async function findImageOnScreen(imagePath, opts) {
+    const n = await getNut();
+    const img = await n.loadImage(imagePath);
+    try {
+        const params = opts?.region || opts?.confidence !== undefined
+            ? new (await import("@nut-tree/shared")).OptionalSearchParameters(opts?.region
+                ? new (await import("@nut-tree/shared")).Region(opts.region.left, opts.region.top, opts.region.width, opts.region.height)
+                : undefined, opts?.confidence)
+            : undefined;
+        const region = await n.screen.find(img, params);
+        return {
+            left: region.left,
+            top: region.top,
+            width: region.width,
+            height: region.height,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export async function findAllImagesOnScreen(imagePath, opts) {
+    const n = await getNut();
+    const img = await n.loadImage(imagePath);
+    try {
+        const params = opts?.region || opts?.confidence !== undefined
+            ? new (await import("@nut-tree/shared")).OptionalSearchParameters(opts?.region
+                ? new (await import("@nut-tree/shared")).Region(opts.region.left, opts.region.top, opts.region.width, opts.region.height)
+                : undefined, opts?.confidence)
+            : undefined;
+        const regions = await n.screen.findAll(img, params);
+        return regions.map((region) => ({
+            left: region.left,
+            top: region.top,
+            width: region.width,
+            height: region.height,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=backend.js.map

package/dist/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,38 @@
+/** Global nautogui runtime settings. */
+export declare let PAUSE_SEC: number;
+/** Alias matching PAUSE (seconds). */
+export declare let PAUSE: number;
+export declare let FAILSAFE: boolean;
+export declare let MINIMUM_DURATION_SEC: number;
+/** Alias matching MINIMUM_DURATION. */
+export declare let MINIMUM_DURATION: number;
+export declare let MINIMUM_SLEEP_SEC: number;
+export declare let MINIMUM_SLEEP: number;
+export declare let DARWIN_CATCH_UP_TIME_SEC: number;
+export declare let DARWIN_CATCH_UP_TIME: number;
+export declare let LOG_SCREENSHOTS: boolean;
+export declare let LOG_SCREENSHOTS_LIMIT: number | null;
+export declare const G_LOG_SCREENSHOTS_FILENAMES: string[];
+/** When true, image locate functions throw ImageNotFoundException instead of returning null. */
+export declare let USE_IMAGE_NOT_FOUND_EXCEPTION: boolean;
+/** Corner failsafe points; updated when screen size is known. */
+export declare let FAILSAFE_POINTS: Array<{
+    x: number;
+    y: number;
+}>;
+export declare function configureNautogui(opts: {
+    pauseSec?: number;
+    pause?: number;
+    failSafe?: boolean;
+    minimumDurationSec?: number;
+    minimumDuration?: number;
+    minimumSleepSec?: number;
+    logScreenshots?: boolean;
+    logId?: boolean;
+    useImageNotFoundException?: boolean;
+}): void;
+/** useImageNotFoundException() */
+export declare function useImageNotFoundException(value?: boolean): void;
+export declare function refreshFailSafePoints(): Promise<void>;
+export { FailSafeException, ImageNotFoundException, NautoguiFailSafeError, NautoguiNotAvailableError, NautoguiException, } from "./exceptions.js";
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAIxC,eAAO,IAAI,SAAS,QAAM,CAAC;AAC3B,sCAAsC;AACtC,eAAO,IAAI,KAAK,QAAY,CAAC;AAE7B,eAAO,IAAI,QAAQ,SAAO,CAAC;AAC3B,eAAO,IAAI,oBAAoB,QAAM,CAAC;AACtC,uCAAuC;AACvC,eAAO,IAAI,gBAAgB,QAAuB,CAAC;AAEnD,eAAO,IAAI,iBAAiB,QAAO,CAAC;AACpC,eAAO,IAAI,aAAa,QAAoB,CAAC;AAE7C,eAAO,IAAI,wBAAwB,QAAO,CAAC;AAC3C,eAAO,IAAI,oBAAoB,QAA2B,CAAC;AAE3D,eAAO,IAAI,eAAe,SAAQ,CAAC;AACnC,eAAO,IAAI,qBAAqB,EAAE,MAAM,GAAG,IAAS,CAAC;AACrD,eAAO,MAAM,2BAA2B,EAAE,MAAM,EAAO,CAAC;AAExD,gGAAgG;AAChG,eAAO,IAAI,6BAA6B,SAAQ,CAAC;AAEjD,iEAAiE;AACjE,eAAO,IAAI,eAAe,EAAE,KAAK,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAoB,CAAC;AAE/E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GAAG,IAAI,CAwBP;AAED,kCAAkC;AAClC,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAE/D;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ3D;AAED,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC"}

package/dist/config.js

@@ -0,0 +1,60 @@
+/** Global nautogui runtime settings. */
+import { screenSize } from "./backend.js";
+export let PAUSE_SEC = 0.1;
+/** Alias matching PAUSE (seconds). */
+export let PAUSE = PAUSE_SEC;
+export let FAILSAFE = true;
+export let MINIMUM_DURATION_SEC = 0.1;
+/** Alias matching MINIMUM_DURATION. */
+export let MINIMUM_DURATION = MINIMUM_DURATION_SEC;
+export let MINIMUM_SLEEP_SEC = 0.05;
+export let MINIMUM_SLEEP = MINIMUM_SLEEP_SEC;
+export let DARWIN_CATCH_UP_TIME_SEC = 0.01;
+export let DARWIN_CATCH_UP_TIME = DARWIN_CATCH_UP_TIME_SEC;
+export let LOG_SCREENSHOTS = false;
+export let LOG_SCREENSHOTS_LIMIT = 10;
+export const G_LOG_SCREENSHOTS_FILENAMES = [];
+/** When true, image locate functions throw ImageNotFoundException instead of returning null. */
+export let USE_IMAGE_NOT_FOUND_EXCEPTION = false;
+/** Corner failsafe points; updated when screen size is known. */
+export let FAILSAFE_POINTS = [{ x: 0, y: 0 }];
+export function configureNautogui(opts) {
+    const pause = opts.pauseSec ?? opts.pause;
+    if (pause !== undefined) {
+        PAUSE_SEC = Math.max(0, pause);
+        PAUSE = PAUSE_SEC;
+    }
+    if (opts.failSafe !== undefined) {
+        FAILSAFE = opts.failSafe;
+    }
+    const minDur = opts.minimumDurationSec ?? opts.minimumDuration;
+    if (minDur !== undefined) {
+        MINIMUM_DURATION_SEC = Math.max(0, minDur);
+        MINIMUM_DURATION = MINIMUM_DURATION_SEC;
+    }
+    if (opts.minimumSleepSec !== undefined) {
+        MINIMUM_SLEEP_SEC = Math.max(0, opts.minimumSleepSec);
+        MINIMUM_SLEEP = MINIMUM_SLEEP_SEC;
+    }
+    if (opts.logScreenshots !== undefined) {
+        LOG_SCREENSHOTS = opts.logScreenshots;
+    }
+    if (opts.useImageNotFoundException !== undefined) {
+        USE_IMAGE_NOT_FOUND_EXCEPTION = opts.useImageNotFoundException;
+    }
+}
+/** useImageNotFoundException() */
+export function useImageNotFoundException(value) {
+    USE_IMAGE_NOT_FOUND_EXCEPTION = value ?? true;
+}
+export async function refreshFailSafePoints() {
+    const { width, height } = await screenSize();
+    FAILSAFE_POINTS = [
+        { x: 0, y: 0 },
+        { x: width - 1, y: 0 },
+        { x: 0, y: height - 1 },
+        { x: width - 1, y: height - 1 },
+    ];
+}
+export { FailSafeException, ImageNotFoundException, NautoguiFailSafeError, NautoguiNotAvailableError, NautoguiException, } from "./exceptions.js";
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -0,0 +1,16 @@
+/** Mouse button name constants (LEFT / MIDDLE / RIGHT / PRIMARY / SECONDARY). */
+export declare const LEFT: "left";
+export declare const MIDDLE: "middle";
+export declare const RIGHT: "right";
+export declare const PRIMARY: "primary";
+export declare const SECONDARY: "secondary";
+export type MouseButtonName = typeof LEFT | typeof MIDDLE | typeof RIGHT | typeof PRIMARY | typeof SECONDARY;
+/** Supported keyboard key names. */
+export declare const KEY_NAMES: readonly ["\t", "\n", "\r", " ", "!", "\"", "#", "$", "%", "&", "'", "(", ")", "*", "+", ",", "-", ".", "/", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", ":", ";", "<", "=", ">", "?", "@", "[", "\\", "]", "^", "_", "`", "a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z", "{", "|", "}", "~", "accept", "add", "alt", "altleft", "altright", "apps", "backspace", "browserback", "browserfavorites", "browserforward", "browserhome", "browserrefresh", "browsersearch", "browserstop", "capslock", "clear", "convert", "ctrl", "ctrlleft", "ctrlright", "decimal", "del", "delete", "divide", "down", "end", "enter", "esc", "escape", "execute", "f1", "f10", "f11", "f12", "f13", "f14", "f15", "f16", "f17", "f18", "f19", "f2", "f20", "f21", "f22", "f23", "f24", "f3", "f4", "f5", "f6", "f7", "f8", "f9", "final", "fn", "hanguel", "hangul", "hanja", "help", "home", "insert", "junja", "kana", "kanji", "launchapp1", "launchapp2", "launchmail", "launchmediaselect", "left", "modechange", "multiply", "nexttrack", "nonconvert", "num0", "num1", "num2", "num3", "num4", "num5", "num6", "num7", "num8", "num9", "numlock", "pagedown", "pageup", "pause", "pgdn", "pgup", "playpause", "prevtrack", "print", "printscreen", "prntscrn", "prtsc", "prtscr", "return", "right", "scrolllock", "select", "separator", "shift", "shiftleft", "shiftright", "sleep", "space", "stop", "subtract", "tab", "up", "volumedown", "volumemute", "volumeup", "win", "winleft", "winright", "yen", "command", "option", "optionleft", "optionright"];
+export declare const KEYBOARD_KEYS: readonly ["\t", "\n", "\r", " ", "!", "\"", "#", "$", "%", "&", "'", "(", ")", "*", "+", ",", "-", ".", "/", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", ":", ";", "<", "=", ">", "?", "@", "[", "\\", "]", "^", "_", "`", "a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z", "{", "|", "}", "~", "accept", "add", "alt", "altleft", "altright", "apps", "backspace", "browserback", "browserfavorites", "browserforward", "browserhome", "browserrefresh", "browsersearch", "browserstop", "capslock", "clear", "convert", "ctrl", "ctrlleft", "ctrlright", "decimal", "del", "delete", "divide", "down", "end", "enter", "esc", "escape", "execute", "f1", "f10", "f11", "f12", "f13", "f14", "f15", "f16", "f17", "f18", "f19", "f2", "f20", "f21", "f22", "f23", "f24", "f3", "f4", "f5", "f6", "f7", "f8", "f9", "final", "fn", "hanguel", "hangul", "hanja", "help", "home", "insert", "junja", "kana", "kanji", "launchapp1", "launchapp2", "launchmail", "launchmediaselect", "left", "modechange", "multiply", "nexttrack", "nonconvert", "num0", "num1", "num2", "num3", "num4", "num5", "num6", "num7", "num8", "num9", "numlock", "pagedown", "pageup", "pause", "pgdn", "pgup", "playpause", "prevtrack", "print", "printscreen", "prntscrn", "prtsc", "prtscr", "return", "right", "scrolllock", "select", "separator", "shift", "shiftleft", "shiftright", "sleep", "space", "stop", "subtract", "tab", "up", "volumedown", "volumemute", "volumeup", "win", "winleft", "winright", "yen", "command", "option", "optionleft", "optionright"];
+export type KeyboardKey = (typeof KEY_NAMES)[number];
+/** Keyboard layout strings (QWERTY / QWERTZ). */
+export declare const QWERTY = "`1234567890-=qwertyuiop[]\\asdfghjkl;'zxcvbnm,./~!@#$%^&*()_+QWERTYUIOP{}|ASDFGHJKL:\"ZXCVBNM<>?";
+export declare const QWERTZ = "=1234567890/0qwertzuiop89-asdfghjkl,\\yxcvbnm,.7+!@#$%^&*()?)QWERTZUIOP*(_ASDFGHJKL<|YXCVBNM<>&";
+export declare const VERSION = "0.3.0";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAEjF,eAAO,MAAM,IAAI,EAAG,MAAe,CAAC;AACpC,eAAO,MAAM,MAAM,EAAG,QAAiB,CAAC;AACxC,eAAO,MAAM,KAAK,EAAG,OAAgB,CAAC;AACtC,eAAO,MAAM,OAAO,EAAG,SAAkB,CAAC;AAC1C,eAAO,MAAM,SAAS,EAAG,WAAoB,CAAC;AAE9C,MAAM,MAAM,eAAe,GACvB,OAAO,IAAI,GACX,OAAO,MAAM,GACb,OAAO,KAAK,GACZ,OAAO,OAAO,GACd,OAAO,SAAS,CAAC;AAErB,oCAAoC;AACpC,eAAO,MAAM,SAAS,kjDAmMZ,CAAC;AAEX,eAAO,MAAM,aAAa,kjDAAY,CAAC;AAEvC,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,iDAAiD;AACjD,eAAO,MAAM,MAAM,qGACiF,CAAC;AACrG,eAAO,MAAM,MAAM,oGACgF,CAAC;AAEpG,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/constants.js

@@ -0,0 +1,209 @@
+/** Mouse button name constants (LEFT / MIDDLE / RIGHT / PRIMARY / SECONDARY). */
+export const LEFT = "left";
+export const MIDDLE = "middle";
+export const RIGHT = "right";
+export const PRIMARY = "primary";
+export const SECONDARY = "secondary";
+/** Supported keyboard key names. */
+export const KEY_NAMES = [
+    "\t",
+    "\n",
+    "\r",
+    " ",
+    "!",
+    '"',
+    "#",
+    "$",
+    "%",
+    "&",
+    "'",
+    "(",
+    ")",
+    "*",
+    "+",
+    ",",
+    "-",
+    ".",
+    "/",
+    "0",
+    "1",
+    "2",
+    "3",
+    "4",
+    "5",
+    "6",
+    "7",
+    "8",
+    "9",
+    ":",
+    ";",
+    "<",
+    "=",
+    ">",
+    "?",
+    "@",
+    "[",
+    "\\",
+    "]",
+    "^",
+    "_",
+    "`",
+    "a",
+    "b",
+    "c",
+    "d",
+    "e",
+    "f",
+    "g",
+    "h",
+    "i",
+    "j",
+    "k",
+    "l",
+    "m",
+    "n",
+    "o",
+    "p",
+    "q",
+    "r",
+    "s",
+    "t",
+    "u",
+    "v",
+    "w",
+    "x",
+    "y",
+    "z",
+    "{",
+    "|",
+    "}",
+    "~",
+    "accept",
+    "add",
+    "alt",
+    "altleft",
+    "altright",
+    "apps",
+    "backspace",
+    "browserback",
+    "browserfavorites",
+    "browserforward",
+    "browserhome",
+    "browserrefresh",
+    "browsersearch",
+    "browserstop",
+    "capslock",
+    "clear",
+    "convert",
+    "ctrl",
+    "ctrlleft",
+    "ctrlright",
+    "decimal",
+    "del",
+    "delete",
+    "divide",
+    "down",
+    "end",
+    "enter",
+    "esc",
+    "escape",
+    "execute",
+    "f1",
+    "f10",
+    "f11",
+    "f12",
+    "f13",
+    "f14",
+    "f15",
+    "f16",
+    "f17",
+    "f18",
+    "f19",
+    "f2",
+    "f20",
+    "f21",
+    "f22",
+    "f23",
+    "f24",
+    "f3",
+    "f4",
+    "f5",
+    "f6",
+    "f7",
+    "f8",
+    "f9",
+    "final",
+    "fn",
+    "hanguel",
+    "hangul",
+    "hanja",
+    "help",
+    "home",
+    "insert",
+    "junja",
+    "kana",
+    "kanji",
+    "launchapp1",
+    "launchapp2",
+    "launchmail",
+    "launchmediaselect",
+    "left",
+    "modechange",
+    "multiply",
+    "nexttrack",
+    "nonconvert",
+    "num0",
+    "num1",
+    "num2",
+    "num3",
+    "num4",
+    "num5",
+    "num6",
+    "num7",
+    "num8",
+    "num9",
+    "numlock",
+    "pagedown",
+    "pageup",
+    "pause",
+    "pgdn",
+    "pgup",
+    "playpause",
+    "prevtrack",
+    "print",
+    "printscreen",
+    "prntscrn",
+    "prtsc",
+    "prtscr",
+    "return",
+    "right",
+    "scrolllock",
+    "select",
+    "separator",
+    "shift",
+    "shiftleft",
+    "shiftright",
+    "sleep",
+    "space",
+    "stop",
+    "subtract",
+    "tab",
+    "up",
+    "volumedown",
+    "volumemute",
+    "volumeup",
+    "win",
+    "winleft",
+    "winright",
+    "yen",
+    "command",
+    "option",
+    "optionleft",
+    "optionright",
+];
+export const KEYBOARD_KEYS = KEY_NAMES;
+/** Keyboard layout strings (QWERTY / QWERTZ). */
+export const QWERTY = "`1234567890-=qwertyuiop[]\\asdfghjkl;'zxcvbnm,./~!@#$%^&*()_+QWERTYUIOP{}|ASDFGHJKL:\"ZXCVBNM<>?";
+export const QWERTZ = "=1234567890/0qwertzuiop89-asdfghjkl,\\yxcvbnm,.7+!@#$%^&*()?)QWERTZUIOP*(_ASDFGHJKL<|YXCVBNM<>&";
+export const VERSION = "0.3.0";
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}

package/dist/coords.d.ts

@@ -0,0 +1,12 @@
+/** Coordinate normalization (_normalizeXYArgs). */
+import { type Box } from "./region.js";
+export type ScreenPoint = {
+    x: number;
+    y: number;
+};
+export declare function normalizeXYArgs(first: number | string | Box | [number, number] | null | undefined, second: number | null | undefined, deps: {
+    position: () => Promise<ScreenPoint>;
+    locateOnScreen: (image: string) => Promise<Box | null>;
+}): Promise<ScreenPoint | null>;
+export declare function normalizeButton(button: string | number): "left" | "right" | "middle";
+//# sourceMappingURL=coords.d.ts.map

package/dist/coords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coords.d.ts","sourceRoot":"","sources":["../src/coords.ts"],"names":[],"mappings":"AAAA,mDAAmD;AAGnD,OAAO,EAAuB,KAAK,GAAG,EAAE,MAAM,aAAa,CAAC;AAE5D,MAAM,MAAM,WAAW,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnD,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EAClE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,IAAI,EAAE;IACJ,QAAQ,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;IACrC,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;CACxD,GACA,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA+B7B;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,GAAG,MAAM,GACtB,MAAM,GAAG,OAAO,GAAG,QAAQ,CAO7B"}

package/dist/coords.js

@@ -0,0 +1,46 @@
+/** Coordinate normalization (_normalizeXYArgs). */
+import { existsSync } from "node:fs";
+import { center, isImagePath } from "./region.js";
+export async function normalizeXYArgs(first, second, deps) {
+    if (first == null && second == null) {
+        return deps.position();
+    }
+    if (first == null && second != null) {
+        const p = await deps.position();
+        return { x: p.x, y: Math.round(second) };
+    }
+    if (second == null && typeof first === "number") {
+        const p = await deps.position();
+        return { x: Math.round(first), y: p.y };
+    }
+    if (typeof first === "string" && isImagePath(first) && existsSync(first)) {
+        const box = await deps.locateOnScreen(first);
+        return box ? center(box) : null;
+    }
+    if (Array.isArray(first) && first.length === 2) {
+        return { x: Math.round(first[0]), y: Math.round(first[1]) };
+    }
+    if (Array.isArray(first) && first.length === 4) {
+        return center({
+            left: first[0],
+            top: first[1],
+            width: first[2],
+            height: first[3],
+        });
+    }
+    if (typeof first === "number" && typeof second === "number") {
+        return { x: Math.round(first), y: Math.round(second) };
+    }
+    throw new Error("Invalid coordinate arguments");
+}
+export function normalizeButton(button) {
+    if (button === 1 || button === "left" || button === "primary")
+        return "left";
+    if (button === 2 || button === "middle")
+        return "middle";
+    if (button === 3 || button === "right" || button === "secondary") {
+        return "right";
+    }
+    throw new Error(`Invalid button: ${String(button)}`);
+}
+//# sourceMappingURL=coords.js.map

package/dist/coords.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coords.js","sourceRoot":"","sources":["../src/coords.ts"],"names":[],"mappings":"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"}

package/dist/display-mouse.d.ts

@@ -0,0 +1,3 @@
+/** displayMousePosition */
+export declare function displayMousePosition(xOffset?: number, yOffset?: number): Promise<void>;
+//# sourceMappingURL=display-mouse.d.ts.map

package/dist/display-mouse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-mouse.d.ts","sourceRoot":"","sources":["../src/display-mouse.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAI3B,wBAAsB,oBAAoB,CACxC,OAAO,SAAI,EACX,OAAO,SAAI,GACV,OAAO,CAAC,IAAI,CAAC,CAuBf"}