illuma-rpa 1.0.0

package/.github/workflows/publish.yml

@@ -0,0 +1,129 @@
+name: Build & Publish
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to publish'
+        required: true
+        default: '1.0.0'
+
+jobs:
+  build-native:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows-latest
+            platform: win32
+            arch: x64
+          - os: macos-13
+            platform: darwin
+            arch: x64
+          - os: macos-14
+            platform: darwin
+            arch: arm64
+          - os: ubuntu-latest
+            platform: linux
+            arch: x64
+
+    runs-on: ${{ matrix.os }}
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+      
+      - name: Install Linux dependencies
+        if: matrix.platform == 'linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y cmake libxtst-dev libpng++-dev
+      
+      - name: Build native module
+        working-directory: libnut-core
+        run: |
+          npm install
+          npm run build:release
+      
+      - name: Create platform package
+        shell: bash
+        run: |
+          PKG_NAME="illuma-rpa-${{ matrix.platform }}-${{ matrix.arch }}"
+          VERSION="${{ github.event.inputs.version || github.ref_name }}"
+          VERSION="${VERSION#v}"  # Remove 'v' prefix if present
+          
+          mkdir -p packages/${PKG_NAME}
+          cp libnut-core/build/Release/libnut.node packages/${PKG_NAME}/
+          cp libnut-core/index.js packages/${PKG_NAME}/
+          cp libnut-core/index.d.ts packages/${PKG_NAME}/
+          
+          cat > packages/${PKG_NAME}/package.json << EOF
+          {
+            "name": "${PKG_NAME}",
+            "version": "${VERSION}",
+            "description": "Native bindings for illuma-rpa (${{ matrix.platform }}-${{ matrix.arch }})",
+            "main": "index.js",
+            "types": "index.d.ts",
+            "license": "Apache-2.0",
+            "os": ["${{ matrix.platform }}"],
+            "cpu": ["${{ matrix.arch }}"],
+            "files": ["libnut.node", "index.js", "index.d.ts"]
+          }
+          EOF
+      
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: illuma-rpa-${{ matrix.platform }}-${{ matrix.arch }}
+          path: packages/illuma-rpa-${{ matrix.platform }}-${{ matrix.arch }}
+
+  publish:
+    needs: build-native
+    runs-on: ubuntu-latest
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+      
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: packages
+      
+      - name: List packages
+        run: ls -la packages/
+      
+      - name: Publish platform packages
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          for pkg in packages/illuma-rpa-*/; do
+            echo "Publishing $pkg"
+            cd "$pkg"
+            npm publish --access public || echo "Failed to publish $pkg"
+            cd -
+          done
+      
+      - name: Install dependencies
+        run: npm install
+      
+      - name: Build main package
+        run: npm run build
+      
+      - name: Publish main package
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm publish --access public

package/LICENSE

@@ -0,0 +1,107 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work.
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      patent license to make, have made, use, offer to sell, sell, import,
+      and otherwise transfer the Work.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file.
+
+   5. Submission of Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND.
+
+   8. Limitation of Liability.
+
+   9. Accepting Warranty or Additional Liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2024 Illuma (based on nut.js by Simon Hofmann)
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,202 @@
+# illuma-rpa
+
+Cross-platform desktop automation for Node.js. Control mouse, keyboard, and capture screenshots programmatically.
+
+[![npm version](https://img.shields.io/npm/v/illuma-rpa.svg)](https://www.npmjs.com/package/illuma-rpa)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+
+## Features
+
+- 🖱️ **Mouse control** - move, click, double-click, drag, scroll
+- ⌨️ **Keyboard control** - type text, press keys, key combinations
+- 📸 **Screen capture** - full screen or region screenshots
+- 🪟 **Window management** - get active window, list windows, focus, resize
+- 🌐 **Cross-platform** - Windows, macOS, Linux (x64 & ARM64)
+- ⚡ **Pre-built binaries** - no compilation required
+
+## Installation
+
+```bash
+npm install illuma-rpa
+```
+
+## Quick Start
+
+```typescript
+import { mouse, keyboard, screen, Key } from 'illuma-rpa';
+
+// Move mouse to position
+await mouse.moveTo(100, 200);
+
+// Click
+await mouse.click();
+await mouse.click('right');
+await mouse.doubleClick();
+
+// Drag
+await mouse.drag(100, 100, 300, 300);
+
+// Scroll
+await mouse.scroll('down', 3);
+
+// Type text
+await keyboard.type('Hello, World!');
+
+// Press keys
+await keyboard.press(Key.Enter);
+await keyboard.press(Key.Ctrl, Key.C);  // Ctrl+C
+
+// Take screenshot
+const screenshot = await screen.capture();
+console.log(`Screenshot: ${screenshot.width}x${screenshot.height}`);
+
+// Capture region
+const region = await screen.captureRegion(0, 0, 500, 500);
+```
+
+## API Reference
+
+### Mouse
+
+```typescript
+import { mouse } from 'illuma-rpa';
+
+// Move
+await mouse.moveTo(x, y);
+await mouse.moveSmooth(x, y);  // Smooth movement
+
+// Click
+await mouse.click();                    // Left click
+await mouse.click('right');             // Right click
+await mouse.click('middle');            // Middle click
+await mouse.doubleClick();
+
+// Drag
+await mouse.drag(startX, startY, endX, endY);
+
+// Scroll
+await mouse.scroll('up', 3);
+await mouse.scroll('down', 3);
+
+// Get position
+const pos = mouse.getPosition();
+console.log(pos.x, pos.y);
+```
+
+### Keyboard
+
+```typescript
+import { keyboard, Key } from 'illuma-rpa';
+
+// Type text
+await keyboard.type('Hello');
+await keyboard.typeDelayed('Hello', 50);  // 50ms between chars
+
+// Press single key
+await keyboard.press(Key.Enter);
+await keyboard.press(Key.Tab);
+
+// Key combinations
+await keyboard.press(Key.Ctrl, Key.C);     // Copy
+await keyboard.press(Key.Ctrl, Key.V);     // Paste
+await keyboard.press(Key.Alt, Key.Tab);    // Switch window
+
+// Hold and release
+await keyboard.hold(Key.Shift);
+await keyboard.type('hello');  // Types "HELLO"
+await keyboard.release(Key.Shift);
+```
+
+### Screen
+
+```typescript
+import { screen } from 'illuma-rpa';
+
+// Full screenshot
+const shot = await screen.capture();
+console.log(shot.width, shot.height);
+console.log(shot.image);  // Raw pixel buffer
+
+// Region screenshot
+const region = await screen.captureRegion(x, y, width, height);
+
+// Get screen size
+const size = screen.getSize();
+console.log(size.width, size.height);
+```
+
+### Window
+
+```typescript
+import { window } from 'illuma-rpa';
+
+// Get active window
+const active = await window.getActive();
+console.log(active.title);
+
+// List all windows
+const windows = await window.getAll();
+
+// Focus window
+await window.focus(windowHandle);
+
+// Resize/move window
+await window.resize(handle, { width: 800, height: 600 });
+await window.move(handle, { x: 100, y: 100 });
+```
+
+## Key Reference
+
+```typescript
+import { Key } from 'illuma-rpa';
+
+// Modifiers
+Key.Ctrl, Key.Alt, Key.Shift, Key.Meta (Win/Cmd)
+
+// Navigation
+Key.Up, Key.Down, Key.Left, Key.Right
+Key.Home, Key.End, Key.PageUp, Key.PageDown
+
+// Editing
+Key.Enter, Key.Tab, Key.Backspace, Key.Delete, Key.Escape, Key.Space
+
+// Function keys
+Key.F1, Key.F2, ... Key.F12
+```
+
+## Use with Electron
+
+```typescript
+// In Electron main process
+import { mouse, keyboard, screen } from 'illuma-rpa';
+
+ipcMain.handle('click', async (_, x, y) => {
+  await mouse.moveTo(x, y);
+  await mouse.click();
+});
+
+ipcMain.handle('screenshot', async () => {
+  return await screen.capture();
+});
+```
+
+## Building from Source
+
+If you need to build the native binaries yourself:
+
+```bash
+# Prerequisites:
+# Windows: npm install -g windows-build-tools
+# macOS: xcode-select --install
+# Linux: sudo apt-get install cmake libxtst-dev libpng++-dev
+
+cd libnut-core
+npm install
+npm run build:release
+```
+
+## License
+
+Apache-2.0
+
+Based on [libnut-core](https://github.com/nut-tree/libnut-core) and [nut.js](https://github.com/nut-tree/nut.js).

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * illuma-rpa
+ * Cross-platform desktop automation for Node.js
+ */
+export { mouse, Mouse } from './mouse';
+export { keyboard, Keyboard, Key } from './keyboard';
+export { screen, Screen, Screenshot } from './screen';
+export { window, Window, WindowInfo } from './window';
+export { loadNativeBinding } from './native';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * illuma-rpa
+ * Cross-platform desktop automation for Node.js
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadNativeBinding = exports.Window = exports.window = exports.Screen = exports.screen = exports.Key = exports.Keyboard = exports.keyboard = exports.Mouse = exports.mouse = void 0;
+var mouse_1 = require("./mouse");
+Object.defineProperty(exports, "mouse", { enumerable: true, get: function () { return mouse_1.mouse; } });
+Object.defineProperty(exports, "Mouse", { enumerable: true, get: function () { return mouse_1.Mouse; } });
+var keyboard_1 = require("./keyboard");
+Object.defineProperty(exports, "keyboard", { enumerable: true, get: function () { return keyboard_1.keyboard; } });
+Object.defineProperty(exports, "Keyboard", { enumerable: true, get: function () { return keyboard_1.Keyboard; } });
+Object.defineProperty(exports, "Key", { enumerable: true, get: function () { return keyboard_1.Key; } });
+var screen_1 = require("./screen");
+Object.defineProperty(exports, "screen", { enumerable: true, get: function () { return screen_1.screen; } });
+Object.defineProperty(exports, "Screen", { enumerable: true, get: function () { return screen_1.Screen; } });
+var window_1 = require("./window");
+Object.defineProperty(exports, "window", { enumerable: true, get: function () { return window_1.window; } });
+Object.defineProperty(exports, "Window", { enumerable: true, get: function () { return window_1.Window; } });
+var native_1 = require("./native");
+Object.defineProperty(exports, "loadNativeBinding", { enumerable: true, get: function () { return native_1.loadNativeBinding; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,iCAAuC;AAA9B,8FAAA,KAAK,OAAA;AAAE,8FAAA,KAAK,OAAA;AACrB,uCAAqD;AAA5C,oGAAA,QAAQ,OAAA;AAAE,oGAAA,QAAQ,OAAA;AAAE,+FAAA,GAAG,OAAA;AAChC,mCAAsD;AAA7C,gGAAA,MAAM,OAAA;AAAE,gGAAA,MAAM,OAAA;AACvB,mCAAsD;AAA7C,gGAAA,MAAM,OAAA;AAAE,gGAAA,MAAM,OAAA;AACvB,mCAA6C;AAApC,2GAAA,iBAAiB,OAAA"}

package/dist/keyboard.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Keyboard control module
+ */
+/**
+ * Key constants for keyboard input
+ */
+export declare const Key: {
+    readonly Ctrl: "control";
+    readonly Control: "control";
+    readonly Alt: "alt";
+    readonly Shift: "shift";
+    readonly Meta: "command";
+    readonly Win: "command";
+    readonly Cmd: "command";
+    readonly Up: "up";
+    readonly Down: "down";
+    readonly Left: "left";
+    readonly Right: "right";
+    readonly Home: "home";
+    readonly End: "end";
+    readonly PageUp: "pageup";
+    readonly PageDown: "pagedown";
+    readonly Enter: "enter";
+    readonly Return: "enter";
+    readonly Tab: "tab";
+    readonly Backspace: "backspace";
+    readonly Delete: "delete";
+    readonly Escape: "escape";
+    readonly Esc: "escape";
+    readonly Space: "space";
+    readonly Insert: "insert";
+    readonly F1: "f1";
+    readonly F2: "f2";
+    readonly F3: "f3";
+    readonly F4: "f4";
+    readonly F5: "f5";
+    readonly F6: "f6";
+    readonly F7: "f7";
+    readonly F8: "f8";
+    readonly F9: "f9";
+    readonly F10: "f10";
+    readonly F11: "f11";
+    readonly F12: "f12";
+    readonly PrintScreen: "printscreen";
+    readonly CapsLock: "capslock";
+    readonly NumLock: "numlock";
+    readonly ScrollLock: "scrolllock";
+};
+export type KeyType = typeof Key[keyof typeof Key] | string;
+export declare class Keyboard {
+    private delay;
+    /**
+     * Set delay between key presses (ms)
+     */
+    setDelay(ms: number): void;
+    /**
+     * Type a string of text
+     */
+    type(text: string): Promise<void>;
+    /**
+     * Type text with delay between characters
+     */
+    typeDelayed(text: string, delayMs?: number): Promise<void>;
+    /**
+     * Press and release a key or key combination
+     */
+    press(...keys: KeyType[]): Promise<void>;
+    /**
+     * Hold a key down
+     */
+    hold(...keys: KeyType[]): Promise<void>;
+    /**
+     * Release a held key
+     */
+    release(...keys: KeyType[]): Promise<void>;
+    /**
+     * Press a key combination (e.g., Ctrl+C)
+     */
+    combo(...keys: KeyType[]): Promise<void>;
+}
+export declare const keyboard: Keyboard;
+//# sourceMappingURL=keyboard.d.ts.map

package/dist/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../src/keyboard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCN,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC;AAE5D,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAK;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK1B;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpE;;OAEG;IACG,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9C;;OAEG;IACG,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C;;OAEG;IACG,OAAO,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD;;OAEG;IACG,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/C;AAGD,eAAO,MAAM,QAAQ,UAAiB,CAAC"}

package/dist/keyboard.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * Keyboard control module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.keyboard = exports.Keyboard = exports.Key = void 0;
+const native_1 = require("./native");
+/**
+ * Key constants for keyboard input
+ */
+exports.Key = {
+    // Modifiers
+    Ctrl: 'control',
+    Control: 'control',
+    Alt: 'alt',
+    Shift: 'shift',
+    Meta: 'command', // Win key on Windows, Cmd on macOS
+    Win: 'command',
+    Cmd: 'command',
+    // Navigation
+    Up: 'up',
+    Down: 'down',
+    Left: 'left',
+    Right: 'right',
+    Home: 'home',
+    End: 'end',
+    PageUp: 'pageup',
+    PageDown: 'pagedown',
+    // Editing
+    Enter: 'enter',
+    Return: 'enter',
+    Tab: 'tab',
+    Backspace: 'backspace',
+    Delete: 'delete',
+    Escape: 'escape',
+    Esc: 'escape',
+    Space: 'space',
+    Insert: 'insert',
+    // Function keys
+    F1: 'f1', F2: 'f2', F3: 'f3', F4: 'f4',
+    F5: 'f5', F6: 'f6', F7: 'f7', F8: 'f8',
+    F9: 'f9', F10: 'f10', F11: 'f11', F12: 'f12',
+    // Other
+    PrintScreen: 'printscreen',
+    CapsLock: 'capslock',
+    NumLock: 'numlock',
+    ScrollLock: 'scrolllock',
+};
+class Keyboard {
+    constructor() {
+        this.delay = 0;
+    }
+    /**
+     * Set delay between key presses (ms)
+     */
+    setDelay(ms) {
+        this.delay = ms;
+        (0, native_1.getNative)().setKeyboardDelay(ms);
+    }
+    /**
+     * Type a string of text
+     */
+    async type(text) {
+        (0, native_1.getNative)().typeString(text);
+    }
+    /**
+     * Type text with delay between characters
+     */
+    async typeDelayed(text, delayMs = 50) {
+        // Convert delay to characters per minute
+        const cpm = Math.round(60000 / delayMs);
+        (0, native_1.getNative)().typeStringDelayed(text, cpm);
+    }
+    /**
+     * Press and release a key or key combination
+     */
+    async press(...keys) {
+        if (keys.length === 0)
+            return;
+        if (keys.length === 1) {
+            (0, native_1.getNative)().keyTap(keys[0]);
+        }
+        else {
+            // Last key is the main key, others are modifiers
+            const mainKey = keys[keys.length - 1];
+            const modifiers = keys.slice(0, -1);
+            (0, native_1.getNative)().keyTap(mainKey, modifiers);
+        }
+    }
+    /**
+     * Hold a key down
+     */
+    async hold(...keys) {
+        for (const key of keys) {
+            (0, native_1.getNative)().keyToggle(key, 'down');
+        }
+    }
+    /**
+     * Release a held key
+     */
+    async release(...keys) {
+        for (const key of keys) {
+            (0, native_1.getNative)().keyToggle(key, 'up');
+        }
+    }
+    /**
+     * Press a key combination (e.g., Ctrl+C)
+     */
+    async combo(...keys) {
+        await this.press(...keys);
+    }
+}
+exports.Keyboard = Keyboard;
+// Export singleton instance
+exports.keyboard = new Keyboard();
+//# sourceMappingURL=keyboard.js.map

package/dist/keyboard.js.map

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