node-autoit-koffi 1.0.3 → 1.0.7

package/AGENTS.md

@@ -0,0 +1,13 @@
+# AGENTS.md
+
+PROJECT RULES AND CONVENTIONS
+
+PACKAGE MANAGEMENT
+- This project uses Bun as the package manager instead of npm or yarn
+- Use `bun install` to install dependencies
+- Use `bun add <package>` to add new dependencies
+- Use `bun add -d <package>` to add dev dependencies
+- Use `bun remove <package>` to remove dependencies
+- Use `bun run <script>` to run scripts defined in package.json
+- Do NOT use npm or yarn commands in this project
+

package/CLAUDE.md

@@ -0,0 +1,118 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Development Commands
+
+```bash
+# Build (clean dist/ and compile TypeScript)
+yarn build
+
+# Build and run
+yarn start
+
+# Run tests (Node.js built-in test runner)
+node examples/index.test.js
+
+# Generate TypeScript bindings from AutoIt function definitions
+node tools/generate_code.js
+```
+
+**Note:** No linting scripts are configured. Prettier is installed but has no format script.
+
+## Architecture Overview
+
+This is a **Node.js FFI wrapper for AutoIt's Windows automation library** using Koffi. It enables Windows GUI automation (mouse, keyboard, windows) from JavaScript/TypeScript.
+
+**Data Flow:**
+```
+User Code → src/index.ts (Promise-wrapped exports) → Koffi FFI → AutoItX3 DLL → Windows API
+```
+
+**Key Components:**
+- **src/index.ts** - Main entry point with 100+ exported AutoIt functions (mostly generated code)
+- **src/util.ts** - DLL path selection (32/64-bit) and wide-string conversion
+- **src/wchar.js** - UTF-16 string handling for Windows (adapted from ref-wchar, MIT)
+- **tools/generate_code.js** - Code generator that creates TypeScript bindings from function definitions
+- **dlls/** - Native AutoItX3 DLLs (32-bit and 64-bit versions)
+
+**Critical Dependencies:**
+- `koffi` - FFI library for native DLL calls
+- `iconv-lite` - UTF-16 ↔ UTF-8 conversion
+- `ref-napi` - Buffer/pointer manipulation
+
+## Project-Specific Patterns
+
+### Generated Code - Do Not Edit Directly
+
+Most of `src/index.ts` is **generated** by `tools/generate_code.js`. Look for the `// Generated code:` comment. To add or modify AutoIt function bindings:
+1. Edit the `autoitFunctions` object in `tools/generate_code.js`
+2. Run `node tools/generate_code.js`
+3. Rebuild with `yarn build`
+
+### Lazy Function Loading Pattern
+
+All FFI functions use lazy loading - bindings are created on first call and cached in the `fn` object:
+```typescript
+if (!fn.hasOwnProperty("functionName")) {
+  fn["functionName"] = lib.func("AU3_FunctionName", "returnType", ["paramTypes"]);
+}
+```
+
+### Buffer Auto-Expansion for Strings
+
+Functions returning strings (like `clipGet`) recursively double buffer size if content is truncated:
+```typescript
+if (content.length === nBufSize - 1) {
+  resolve(clipGet(nBufSize * 2)); // Recursive doubling
+}
+```
+
+### Dual API Pattern
+
+Most functions have two versions:
+- String-based: `winActivate(szTitle, szText)` - searches for window
+- Handle-based: `winActivateByHandle(hWnd)` - direct, more efficient
+
+### Magic Constants
+
+- `AU3_INTDEFAULT = -2147483647` - indicates "use default value" for optional parameters
+- Example: `mouseClick("LEFT", AU3_INTDEFAULT, AU3_INTDEFAULT)` clicks at current position
+
+### Wide Character Handling
+
+Windows uses UTF-16LE. All string parameters use Koffi's `"string16"` type. Buffer allocations multiply by `wchar.size` (2 bytes).
+
+### Output Parameters
+
+Structs like Point/Rect are passed as output parameters using Koffi's `_Out_` prefix:
+```typescript
+fn["mouseGetPos"] = lib.func("AU3_MouseGetPos", "void", ["_Out_ LPPOINT*"]);
+```
+
+## Critical Requirements
+
+1. **Windows Only** - Requires AutoItX DLL, no cross-platform support
+2. **Must Call `init()` First** - Always `await autoit.init()` before using any functions
+3. **All Functions Are Async** - Every function returns a Promise
+4. **Architecture-Aware** - Automatically selects 32-bit or 64-bit DLL based on `os.arch()`
+
+## Types
+
+```typescript
+type Point = { x: number; y: number };
+type Rect = { left: number; top: number; right: number; bottom: number };
+```
+
+## Error Handling
+
+- Functions don't validate parameters; rely on AutoIt DLL error codes
+- Errors surface as Promise rejections
+- Use `error()` function to get last AutoIt error code
+
+## External Documentation
+
+Function behavior and parameters: [AutoIt Documentation](https://www.autoitscript.com/autoit3/docs/functions/)
+
+Function naming: `AU3_MouseMove` → `mouseMove` (camelCase conversion)
+

package/README.md

@@ -1,168 +1,168 @@
-# Node AutoIt Koffi
-
-This Node.js module provides support for all AutoIt functions, allowing users to automate Windows GUI tasks seamlessly. 
-
-## Example
-Check out an example of how to use this module in action: [Example Code](https://github.com/nullmastermind/node-autoit-koffi/blob/master/examples/index.test.js)
-
-## Installation
-To install Node AutoIt Koffi, simply run the following command:
-
-```bash
-npm install node-autoit-koffi
-```
-
-## Usage
-Here's a quick example of how you can use Node AutoIt Koffi in your Node.js application:
-
-```javascript
-const autoit = require("node-autoit-koffi");
-
-async function main() {
-  await autoit.init();
-  // Your code here
-  await autoit.mouseMove(0, 0);
-}
-
-main().catch(console.error);
-```
-
-Make sure to refer to the [AutoIt documentation](https://www.autoitscript.com/autoit3/docs/functions/) for a list of supported functions and their usage.
-
-```typescript
-type Point = {
-    x: number;
-    y: number;
-};
-type Rect = {
-    left: number;
-    top: number;
-    right: number;
-    bottom: number;
-};
-
-const init: () => Promise<void>;
-const error: () => Promise<number>;
-const autoItSetOption: (szOption: string, nValue: number) => Promise<number>;
-const clipGet: (nBufSize?: number) => Promise<string>;
-const clipPut: (szClip: string) => Promise<void>;
-const controlClick: (szTitle: string, szText: string | undefined, szControl: string, szButton?: string, nNumClicks?: number, nX?: number, nY?: number) => Promise<number>;
-const controlClickByHandle: (hWnd: number, hCtrl: number, szButton?: string, nNumClicks?: number, nX?: number, nY?: number) => Promise<number>;
-const controlCommand: (szTitle: string, szText: string | undefined, szControl: string, szCommand: string, szExtra?: string, nBufSize?: number) => Promise<string>;
-const controlCommandByHandle: (hWnd: number, hCtrl: number, szCommand: string, szExtra?: string, nBufSize?: number) => Promise<string>;
-const controlListView: (szTitle: string, szText: string | undefined, szControl: string, szCommand: string, szExtra1?: string, szExtra2?: string, nBufSize?: number) => Promise<string>;
-const controlListViewByHandle: (hWnd: number, hCtrl: number, szCommand: string, szExtra1?: string, szExtra2?: string, nBufSize?: number) => Promise<string>;
-const controlDisable: (szTitle: string, szText: string | undefined, szControl: string) => Promise<number>;
-const controlDisableByHandle: (hWnd: number, hCtrl: number) => Promise<number>;
-const controlEnable: (szTitle: string, szText: string | undefined, szControl: string) => Promise<number>;
-const controlEnableByHandle: (hWnd: number, hCtrl: number) => Promise<number>;
-const controlFocus: (szTitle: string, szText: string | undefined, szControl: string) => Promise<number>;
-const controlFocusByHandle: (hWnd: number, hCtrl: number) => Promise<number>;
-const controlGetFocus: (szTitle: string, szText?: string, nBufSize?: number) => Promise<string>;
-const controlGetFocusByHandle: (hWnd: number, nBufSize?: number) => Promise<string>;
-const controlGetHandle: (hWnd: number, szControl: string) => Promise<number>;
-const controlGetHandleAsText: (szTitle: string, szText: string | undefined, szControl: string, nBufSize?: number) => Promise<string>;
-const controlGetPos: (szTitle: string, szText: string | undefined, szControl: string) => Promise<Rect>;
-const controlGetPosByHandle: (hWnd: number, hCtrl: number) => Promise<Rect>;
-const controlGetText: (szTitle: string, szText: string | undefined, szControl: string, nBufSize?: number) => Promise<string>;
-const controlGetTextByHandle: (hWnd: number, hCtrl: number, nBufSize?: number) => Promise<string>;
-const controlHide: (szTitle: string, szText: string | undefined, szControl: string) => Promise<number>;
-const controlHideByHandle: (hWnd: number, hCtrl: number) => Promise<number>;
-const controlMove: (szTitle: string, szText: string | undefined, szControl: string, nX: number, nY: number, nWidth?: number, nHeight?: number) => Promise<number>;
-const controlMoveByHandle: (hWnd: number, hCtrl: number, nX: number, nY: number, nWidth?: number, nHeight?: number) => Promise<number>;
-const controlSend: (szTitle: string, szText: string | undefined, szControl: string, szSendText: string, nMode?: number) => Promise<number>;
-const controlSendByHandle: (hWnd: number, hCtrl: number, szSendText: string, nMode?: number) => Promise<number>;
-const controlSetText: (szTitle: string, szText: string | undefined, szControl: string, szControlText: string) => Promise<number>;
-const controlSetTextByHandle: (hWnd: number, hCtrl: number, szControlText: string) => Promise<number>;
-const controlShow: (szTitle: string, szText: string | undefined, szControl: string) => Promise<number>;
-const controlShowByHandle: (hWnd: number, hCtrl: number) => Promise<number>;
-const controlTreeView: (szTitle: string, szText: string | undefined, szControl: string, szCommand: string, szExtra1?: string, szExtra2?: string, nBufSize?: number) => Promise<string>;
-const controlTreeViewByHandle: (hWnd: number, hCtrl: number, szCommand: string, szExtra1?: string, szExtra2?: string, nBufSize?: number) => Promise<string>;
-const driveMapAdd: (szDevice: string, szShare: string, nFlags: number, szUser?: string, szPwd?: string, nBufSize?: number) => Promise<string>;
-const driveMapDel: (szDevice: string) => Promise<number>;
-const driveMapGet: (szDevice: string, nBufSize?: number) => Promise<string>;
-const isAdmin: () => Promise<number>;
-const mouseClick: (szButton?: string, nX?: number, nY?: number, nClicks?: number, nSpeed?: number) => Promise<number>;
-const mouseClickDrag: (szButton: string, nX1: number, nY1: number, nX2: number, nY2: number, nSpeed?: number) => Promise<number>;
-const mouseDown: (szButton?: string) => Promise<void>;
-const mouseGetCursor: () => Promise<number>;
-const mouseGetPos: () => Promise<Point>;
-const mouseMove: (nX: number, nY: number, nSpeed?: number) => Promise<number>;
-const mouseUp: (szButton?: string) => Promise<void>;
-const mouseWheel: (szDirection: string, nClicks: number) => Promise<void>;
-const opt: (szOption: string, nValue: number) => Promise<number>;
-const pixelChecksum: (lpRect: Rect, nStep?: number) => Promise<number>;
-const pixelGetColor: (nX: number, nY: number) => Promise<number>;
-const pixelSearch: (lpRect: Rect, nCol: number, nVar?: number, nStep?: number) => Promise<Point>;
-const processClose: (szProcess: string) => Promise<number>;
-const processExists: (szProcess: string) => Promise<number>;
-const processSetPriority: (szProcess: string, nPriority: number) => Promise<number>;
-const processWait: (szProcess: string, nTimeout?: number) => Promise<number>;
-const processWaitClose: (szProcess: string, nTimeout?: number) => Promise<number>;
-const run: (szProgram: string, szDir?: string, nShowFlag?: number) => Promise<number>;
-const runWait: (szProgram: string, szDir?: string, nShowFlag?: number) => Promise<number>;
-const runAs: (szUser: string, szDomain: string, szPassword: string, nLogonFlag: number, szProgram: string, szDir?: string, nShowFlag?: number) => Promise<number>;
-const runAsWait: (szUser: string, szDomain: string, szPassword: string, nLogonFlag: number, szProgram: string, szDir?: string, nShowFlag?: number) => Promise<number>;
-const send: (szSendText: string, nMode?: number) => Promise<void>;
-const shutdown: (nFlags: number) => Promise<number>;
-const sleep: (nMilliseconds: number) => Promise<void>;
-const statusbarGetText: (szTitle: string, szText?: string, nPart?: number, nBufSize?: number) => Promise<string>;
-const statusbarGetTextByHandle: (hWnd: number, nPart?: number, nBufSize?: number) => Promise<string>;
-const toolTip: (szTip: string, nX?: number, nY?: number) => Promise<void>;
-const winActivate: (szTitle: string, szText?: string) => Promise<number>;
-const winActivateByHandle: (hWnd: number) => Promise<number>;
-const winActive: (szTitle: string, szText: string) => Promise<number>;
-const winActiveByHandle: (hWnd: number) => Promise<number>;
-const winClose: (szTitle: string, szText?: string) => Promise<number>;
-const winCloseByHandle: (hWnd: number) => Promise<number>;
-const winExists: (szTitle: string, szText?: string) => Promise<number>;
-const winExistsByHandle: (hWnd: number) => Promise<number>;
-const winGetCaretPos: () => Promise<Point>;
-const winGetClassList: (szTitle: string, szText?: string, nBufSize?: number) => Promise<string>;
-const winGetClassListByHandle: (hWnd: number, nBufSize?: number) => Promise<string>;
-const winGetClientSize: (szTitle: string, szText?: string) => Promise<Rect>;
-const winGetClientSizeByHandle: (hWnd: number) => Promise<Rect>;
-const winGetHandle: (szTitle: string, szText?: string) => Promise<number>;
-const winGetHandleAsText: (szTitle: string, szText?: string, nBufSize?: number) => Promise<string>;
-const winGetPos: (szTitle: string, szText?: string) => Promise<Rect>;
-const winGetPosByHandle: (hWnd: number) => Promise<Rect>;
-const winGetProcess: (szTitle: string, szText?: string) => Promise<number>;
-const winGetProcessByHandle: (hWnd: number) => Promise<number>;
-const winGetState: (szTitle: string, szText?: string) => Promise<number>;
-const winGetStateByHandle: (hWnd: number) => Promise<number>;
-const winGetText: (szTitle: string, szText?: string, nBufSize?: number) => Promise<string>;
-const winGetTextByHandle: (hWnd: number, nBufSize?: number) => Promise<string>;
-const winGetTitle: (szTitle: string, szText?: string, nBufSize?: number) => Promise<string>;
-const winGetTitleByHandle: (hWnd: number, nBufSize?: number) => Promise<string>;
-const winKill: (szTitle: string, szText?: string) => Promise<number>;
-const winKillByHandle: (hWnd: number) => Promise<number>;
-const winMenuSelectItem: (szTitle: string, szText: string | undefined, szItem1: string, szItem2?: string, szItem3?: string, szItem4?: string, szItem5?: string, szItem6?: string, szItem7?: string, szItem8?: string) => Promise<number>;
-const winMenuSelectItemByHandle: (hWnd: number, szItem1: string, szItem2?: string, szItem3?: string, szItem4?: string, szItem5?: string, szItem6?: string, szItem7?: string, szItem8?: string) => Promise<number>;
-const winMinimizeAll: () => Promise<void>;
-const winMinimizeAllUndo: () => Promise<void>;
-const winMove: (szTitle: string, szText: string | undefined, nX: number, nY: number, nWidth?: number, nHeight?: number) => Promise<number>;
-const winMoveByHandle: (hWnd: number, nX: number, nY: number, nWidth?: number, nHeight?: number) => Promise<number>;
-const winSetOnTop: (szTitle: string, szText: string | undefined, nFlag: number) => Promise<number>;
-const winSetOnTopByHandle: (hWnd: number, nFlag: number) => Promise<number>;
-const winSetState: (szTitle: string, szText: string | undefined, nFlags: number) => Promise<number>;
-const winSetStateByHandle: (hWnd: number, nFlags: number) => Promise<number>;
-const winSetTitle: (szTitle: string, szText: string | undefined, szNewTitle: string) => Promise<number>;
-const winSetTitleByHandle: (hWnd: number, szNewTitle: string) => Promise<number>;
-const winSetTrans: (szTitle: string, szText: string | undefined, nTrans: number) => Promise<number>;
-const winSetTransByHandle: (hWnd: number, nTrans: number) => Promise<number>;
-const winWait: (szTitle: string, szText?: string, nTimeout?: number) => Promise<number>;
-const winWaitByHandle: (hWnd: number, nTimeout?: number) => Promise<number>;
-const winWaitActive: (szTitle: string, szText?: string, nTimeout?: number) => Promise<number>;
-const winWaitActiveByHandle: (hWnd: number, nTimeout?: number) => Promise<number>;
-const winWaitClose: (szTitle: string, szText?: string, nTimeout?: number) => Promise<number>;
-const winWaitCloseByHandle: (hWnd: number, nTimeout?: number) => Promise<number>;
-const winWaitNotActive: (szTitle: string, szText?: string, nTimeout?: number) => Promise<number>;
-const winWaitNotActiveByHandle: (hWnd: number, nTimeout?: number) => Promise<number>;
-```
-
-## Support
-If you encounter any issues or have questions, feel free to [open an issue](https://github.com/nullmastermind/node-autoit-koffi/issues) on GitHub.
-
----
-
-By incorporating Node AutoIt Koffi into your Node.js projects, you can automate Windows GUI tasks efficiently and effectively. Happy coding! 🚀
+# Node AutoIt Koffi
+
+This Node.js module provides support for all AutoIt functions, allowing users to automate Windows GUI tasks seamlessly. 
+
+## Example
+Check out an example of how to use this module in action: [Example Code](https://github.com/nullmastermind/node-autoit-koffi/blob/master/examples/index.test.js)
+
+## Installation
+To install Node AutoIt Koffi, simply run the following command:
+
+```bash
+npm install node-autoit-koffi
+```
+
+## Usage
+Here's a quick example of how you can use Node AutoIt Koffi in your Node.js application:
+
+```javascript
+const autoit = require("node-autoit-koffi");
+
+async function main() {
+  await autoit.init();
+  // Your code here
+  await autoit.mouseMove(0, 0);
+}
+
+void main();
+```
+
+Make sure to refer to the [AutoIt documentation](https://www.autoitscript.com/autoit3/docs/functions/) for a list of supported functions and their usage.
+
+```typescript
+type Point = {
+    x: number;
+    y: number;
+};
+type Rect = {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+};
+
+const init: () => Promise<void>;
+const error: () => Promise<number>;
+const autoItSetOption: (szOption: string, nValue: number) => Promise<number>;
+const clipGet: (nBufSize?: number) => Promise<string>;
+const clipPut: (szClip: string) => Promise<void>;
+const controlClick: (szTitle: string, szText: string | undefined, szControl: string, szButton?: string, nNumClicks?: number, nX?: number, nY?: number) => Promise<number>;
+const controlClickByHandle: (hWnd: number, hCtrl: number, szButton?: string, nNumClicks?: number, nX?: number, nY?: number) => Promise<number>;
+const controlCommand: (szTitle: string, szText: string | undefined, szControl: string, szCommand: string, szExtra?: string, nBufSize?: number) => Promise<string>;
+const controlCommandByHandle: (hWnd: number, hCtrl: number, szCommand: string, szExtra?: string, nBufSize?: number) => Promise<string>;
+const controlListView: (szTitle: string, szText: string | undefined, szControl: string, szCommand: string, szExtra1?: string, szExtra2?: string, nBufSize?: number) => Promise<string>;
+const controlListViewByHandle: (hWnd: number, hCtrl: number, szCommand: string, szExtra1?: string, szExtra2?: string, nBufSize?: number) => Promise<string>;
+const controlDisable: (szTitle: string, szText: string | undefined, szControl: string) => Promise<number>;
+const controlDisableByHandle: (hWnd: number, hCtrl: number) => Promise<number>;
+const controlEnable: (szTitle: string, szText: string | undefined, szControl: string) => Promise<number>;
+const controlEnableByHandle: (hWnd: number, hCtrl: number) => Promise<number>;
+const controlFocus: (szTitle: string, szText: string | undefined, szControl: string) => Promise<number>;
+const controlFocusByHandle: (hWnd: number, hCtrl: number) => Promise<number>;
+const controlGetFocus: (szTitle: string, szText?: string, nBufSize?: number) => Promise<string>;
+const controlGetFocusByHandle: (hWnd: number, nBufSize?: number) => Promise<string>;
+const controlGetHandle: (hWnd: number, szControl: string) => Promise<number>;
+const controlGetHandleAsText: (szTitle: string, szText: string | undefined, szControl: string, nBufSize?: number) => Promise<string>;
+const controlGetPos: (szTitle: string, szText: string | undefined, szControl: string) => Promise<Rect>;
+const controlGetPosByHandle: (hWnd: number, hCtrl: number) => Promise<Rect>;
+const controlGetText: (szTitle: string, szText: string | undefined, szControl: string, nBufSize?: number) => Promise<string>;
+const controlGetTextByHandle: (hWnd: number, hCtrl: number, nBufSize?: number) => Promise<string>;
+const controlHide: (szTitle: string, szText: string | undefined, szControl: string) => Promise<number>;
+const controlHideByHandle: (hWnd: number, hCtrl: number) => Promise<number>;
+const controlMove: (szTitle: string, szText: string | undefined, szControl: string, nX: number, nY: number, nWidth?: number, nHeight?: number) => Promise<number>;
+const controlMoveByHandle: (hWnd: number, hCtrl: number, nX: number, nY: number, nWidth?: number, nHeight?: number) => Promise<number>;
+const controlSend: (szTitle: string, szText: string | undefined, szControl: string, szSendText: string, nMode?: number) => Promise<number>;
+const controlSendByHandle: (hWnd: number, hCtrl: number, szSendText: string, nMode?: number) => Promise<number>;
+const controlSetText: (szTitle: string, szText: string | undefined, szControl: string, szControlText: string) => Promise<number>;
+const controlSetTextByHandle: (hWnd: number, hCtrl: number, szControlText: string) => Promise<number>;
+const controlShow: (szTitle: string, szText: string | undefined, szControl: string) => Promise<number>;
+const controlShowByHandle: (hWnd: number, hCtrl: number) => Promise<number>;
+const controlTreeView: (szTitle: string, szText: string | undefined, szControl: string, szCommand: string, szExtra1?: string, szExtra2?: string, nBufSize?: number) => Promise<string>;
+const controlTreeViewByHandle: (hWnd: number, hCtrl: number, szCommand: string, szExtra1?: string, szExtra2?: string, nBufSize?: number) => Promise<string>;
+const driveMapAdd: (szDevice: string, szShare: string, nFlags: number, szUser?: string, szPwd?: string, nBufSize?: number) => Promise<string>;
+const driveMapDel: (szDevice: string) => Promise<number>;
+const driveMapGet: (szDevice: string, nBufSize?: number) => Promise<string>;
+const isAdmin: () => Promise<number>;
+const mouseClick: (szButton?: string, nX?: number, nY?: number, nClicks?: number, nSpeed?: number) => Promise<number>;
+const mouseClickDrag: (szButton: string, nX1: number, nY1: number, nX2: number, nY2: number, nSpeed?: number) => Promise<number>;
+const mouseDown: (szButton?: string) => Promise<void>;
+const mouseGetCursor: () => Promise<number>;
+const mouseGetPos: () => Promise<Point>;
+const mouseMove: (nX: number, nY: number, nSpeed?: number) => Promise<number>;
+const mouseUp: (szButton?: string) => Promise<void>;
+const mouseWheel: (szDirection: string, nClicks: number) => Promise<void>;
+const opt: (szOption: string, nValue: number) => Promise<number>;
+const pixelChecksum: (lpRect: Rect, nStep?: number) => Promise<number>;
+const pixelGetColor: (nX: number, nY: number) => Promise<number>;
+const pixelSearch: (lpRect: Rect, nCol: number, nVar?: number, nStep?: number) => Promise<Point>;
+const processClose: (szProcess: string) => Promise<number>;
+const processExists: (szProcess: string) => Promise<number>;
+const processSetPriority: (szProcess: string, nPriority: number) => Promise<number>;
+const processWait: (szProcess: string, nTimeout?: number) => Promise<number>;
+const processWaitClose: (szProcess: string, nTimeout?: number) => Promise<number>;
+const run: (szProgram: string, szDir?: string, nShowFlag?: number) => Promise<number>;
+const runWait: (szProgram: string, szDir?: string, nShowFlag?: number) => Promise<number>;
+const runAs: (szUser: string, szDomain: string, szPassword: string, nLogonFlag: number, szProgram: string, szDir?: string, nShowFlag?: number) => Promise<number>;
+const runAsWait: (szUser: string, szDomain: string, szPassword: string, nLogonFlag: number, szProgram: string, szDir?: string, nShowFlag?: number) => Promise<number>;
+const send: (szSendText: string, nMode?: number) => Promise<void>;
+const shutdown: (nFlags: number) => Promise<number>;
+const sleep: (nMilliseconds: number) => Promise<void>;
+const statusbarGetText: (szTitle: string, szText?: string, nPart?: number, nBufSize?: number) => Promise<string>;
+const statusbarGetTextByHandle: (hWnd: number, nPart?: number, nBufSize?: number) => Promise<string>;
+const toolTip: (szTip: string, nX?: number, nY?: number) => Promise<void>;
+const winActivate: (szTitle: string, szText?: string) => Promise<number>;
+const winActivateByHandle: (hWnd: number) => Promise<number>;
+const winActive: (szTitle: string, szText: string) => Promise<number>;
+const winActiveByHandle: (hWnd: number) => Promise<number>;
+const winClose: (szTitle: string, szText?: string) => Promise<number>;
+const winCloseByHandle: (hWnd: number) => Promise<number>;
+const winExists: (szTitle: string, szText?: string) => Promise<number>;
+const winExistsByHandle: (hWnd: number) => Promise<number>;
+const winGetCaretPos: () => Promise<Point>;
+const winGetClassList: (szTitle: string, szText?: string, nBufSize?: number) => Promise<string>;
+const winGetClassListByHandle: (hWnd: number, nBufSize?: number) => Promise<string>;
+const winGetClientSize: (szTitle: string, szText?: string) => Promise<Rect>;
+const winGetClientSizeByHandle: (hWnd: number) => Promise<Rect>;
+const winGetHandle: (szTitle: string, szText?: string) => Promise<number>;
+const winGetHandleAsText: (szTitle: string, szText?: string, nBufSize?: number) => Promise<string>;
+const winGetPos: (szTitle: string, szText?: string) => Promise<Rect>;
+const winGetPosByHandle: (hWnd: number) => Promise<Rect>;
+const winGetProcess: (szTitle: string, szText?: string) => Promise<number>;
+const winGetProcessByHandle: (hWnd: number) => Promise<number>;
+const winGetState: (szTitle: string, szText?: string) => Promise<number>;
+const winGetStateByHandle: (hWnd: number) => Promise<number>;
+const winGetText: (szTitle: string, szText?: string, nBufSize?: number) => Promise<string>;
+const winGetTextByHandle: (hWnd: number, nBufSize?: number) => Promise<string>;
+const winGetTitle: (szTitle: string, szText?: string, nBufSize?: number) => Promise<string>;
+const winGetTitleByHandle: (hWnd: number, nBufSize?: number) => Promise<string>;
+const winKill: (szTitle: string, szText?: string) => Promise<number>;
+const winKillByHandle: (hWnd: number) => Promise<number>;
+const winMenuSelectItem: (szTitle: string, szText: string | undefined, szItem1: string, szItem2?: string, szItem3?: string, szItem4?: string, szItem5?: string, szItem6?: string, szItem7?: string, szItem8?: string) => Promise<number>;
+const winMenuSelectItemByHandle: (hWnd: number, szItem1: string, szItem2?: string, szItem3?: string, szItem4?: string, szItem5?: string, szItem6?: string, szItem7?: string, szItem8?: string) => Promise<number>;
+const winMinimizeAll: () => Promise<void>;
+const winMinimizeAllUndo: () => Promise<void>;
+const winMove: (szTitle: string, szText: string | undefined, nX: number, nY: number, nWidth?: number, nHeight?: number) => Promise<number>;
+const winMoveByHandle: (hWnd: number, nX: number, nY: number, nWidth?: number, nHeight?: number) => Promise<number>;
+const winSetOnTop: (szTitle: string, szText: string | undefined, nFlag: number) => Promise<number>;
+const winSetOnTopByHandle: (hWnd: number, nFlag: number) => Promise<number>;
+const winSetState: (szTitle: string, szText: string | undefined, nFlags: number) => Promise<number>;
+const winSetStateByHandle: (hWnd: number, nFlags: number) => Promise<number>;
+const winSetTitle: (szTitle: string, szText: string | undefined, szNewTitle: string) => Promise<number>;
+const winSetTitleByHandle: (hWnd: number, szNewTitle: string) => Promise<number>;
+const winSetTrans: (szTitle: string, szText: string | undefined, nTrans: number) => Promise<number>;
+const winSetTransByHandle: (hWnd: number, nTrans: number) => Promise<number>;
+const winWait: (szTitle: string, szText?: string, nTimeout?: number) => Promise<number>;
+const winWaitByHandle: (hWnd: number, nTimeout?: number) => Promise<number>;
+const winWaitActive: (szTitle: string, szText?: string, nTimeout?: number) => Promise<number>;
+const winWaitActiveByHandle: (hWnd: number, nTimeout?: number) => Promise<number>;
+const winWaitClose: (szTitle: string, szText?: string, nTimeout?: number) => Promise<number>;
+const winWaitCloseByHandle: (hWnd: number, nTimeout?: number) => Promise<number>;
+const winWaitNotActive: (szTitle: string, szText?: string, nTimeout?: number) => Promise<number>;
+const winWaitNotActiveByHandle: (hWnd: number, nTimeout?: number) => Promise<number>;
+```
+
+## Support
+If you encounter any issues or have questions, feel free to [open an issue](https://github.com/nullmastermind/node-autoit-koffi/issues) on GitHub.
+
+---
+
+By incorporating Node AutoIt Koffi into your Node.js projects, you can automate Windows GUI tasks efficiently and effectively. Happy coding! 🚀

package/biome.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.3.11/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignoreUnknown": false,
+    "includes": ["src/**"]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 100
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "suspicious": {
+        "noExplicitAny": "off"
+      }
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "single",
+      "semicolons": "always",
+      "trailingCommas": "all"
+    }
+  }
+}