@maaxyz/maa-node 5.9.2 → 5.10.0-beta.2

package/dist/constant.d.ts

@@ -136,7 +136,37 @@ declare global {
             | 'PostMessageWithWindowPos',
             ScreencapOrInputMethods
         >
-        const DbgControllerType: Record<'CarouselImage' | 'ReplayRecording', Uint64>
+
+        /**
+         * MacOS screencap method.
+         *
+         * No bitwise OR, select ONE method only.
+         *
+         * Default: ScreenCaptureKit
+         *
+         * | Method          | Speed     | Compatibility | Require Permission | Background Support | Notes                            |
+         * |-----------------|-----------|---------------|--------------------|--------------------|----------------------------------|
+         * | ScreenCaptureKit| Very Fast | High          | Screen Recording   | Yes                | Requires macOS 14.0+             |
+         */
+        const MacOSScreencapMethod: Record<'ScreenCaptureKit', ScreencapOrInputMethods>
+
+        /**
+         * MacOS input method.
+         *
+         * No bitwise OR, select ONE method only.
+         *
+         * Default: GlobalEvent
+         *
+         * | Method      | Compatibility | Require Permission | Background Support | Notes                            |
+         * |-------------|---------------|--------------------|--------------------|----------------------------------|
+         * | GlobalEvent | High          | Accessibility      | No                 |                                  |
+         * | PostToPid   | Medium        | Accessibility      | Yes                |                                  |
+         */
+        const MacOSInputMethod: Record<
+            | 'GlobalEvent'
+            | 'PostToPid',
+            ScreencapOrInputMethods
+        >
         const GamepadType: Record<'Xbox360' | 'DualShock4', Uint64>
     }
 }

package/dist/controller.d.ts

@@ -186,13 +186,13 @@ declare global {
             ): Job<CtrlId, Controller>
             post_touch_up(contact: number): Job<CtrlId, Controller>
             /**
-             * Post a relative move action. Currently only supported by Win32 controller.
+             * Post a relative move action. Supported by Win32, MacOS, and custom controllers that implement relative_move.
              */
             post_relative_move(dx: number, dy: number): Job<CtrlId, Controller>
             post_key_down(keycode: number): Job<CtrlId, Controller>
             post_key_up(keycode: number): Job<CtrlId, Controller>
             /**
-             * Post a scroll action. Supported by Win32 controller and custom controllers that implement scroll.
+             * Post a scroll action. Supported by Win32, MacOS, and custom controllers that implement scroll.
              * Using multiples of 120 (WHEEL_DELTA) is recommended for best compatibility.
              */
             post_scroll(dx: number, dy: number): Job<CtrlId, Controller>
@@ -248,16 +248,36 @@ declare global {
             static find(): Promise<DesktopDevice[] | null>
         }
 
+        class MacOSController extends Controller {
+            constructor(
+                window_id: number,
+                screencap_method: ScreencapOrInputMethods,
+                input_method: ScreencapOrInputMethods,
+            )
+
+            static find(): Promise<DesktopDevice[] | null>
+        }
+
         class PlayCoverController extends Controller {
             constructor(address: string, uuid: string)
         }
 
         class DbgController extends Controller {
+            constructor(read_path: string)
+        }
+
+        class ReplayController extends Controller {
+            constructor(recording_path: string)
+        }
+
+        /**
+         * Proxy controller that wraps an existing controller and records all operations.
+         * The recorded file can be replayed using ReplayController.
+         */
+        class RecordController extends Controller {
             constructor(
-                read_path: string,
-                write_path: string,
-                type: Uint64, // DbgControllerType
-                config: string,
+                inner: Controller,
+                recording_path: string,
             )
         }
 
@@ -322,6 +342,8 @@ declare global {
             key_down?(keycode: number): maa.MaybePromise<boolean>
             key_up?(keycode: number): maa.MaybePromise<boolean>
             scroll?(dx: number, dy: number): maa.MaybePromise<boolean>
+            relative_move?(dx: number, dy: number): maa.MaybePromise<boolean>
+            shell?(cmd: string, timeout: number): maa.MaybePromise<string | null>
             inactive?(): maa.MaybePromise<boolean>
             get_info?(): maa.MaybePromise<string | null>
         }

package/dist/global.d.ts

@@ -1,6 +1,7 @@
 declare global {
     namespace maa {
         type StdoutLevel = 'Off' | 'Fatal' | 'Error' | 'Warn' | 'Info' | 'Debug' | 'Trace' | 'All'
+        type MacOSPermission = 'ScreenCapture' | 'Accessibility'
 
         const Global: {
             get version_from_macro(): string
@@ -15,6 +16,10 @@ declare global {
             config_init_option(user_path: string, default_json?: string): void
 
             resize_image(image: ArrayBuffer, width: number, height: number): ArrayBuffer
+
+            macos_check_permission(perm: MacOSPermission): boolean
+            macos_request_permission(perm: MacOSPermission): Promise<boolean>
+            macos_reveal_permission_settings(perm: MacOSPermission): boolean
         }
     }
 }

package/package.json

@@ -20,13 +20,13 @@
     "engines": {
         "node": ">= 20.0.0"
     },
-    "version": "5.9.2",
+    "version": "5.10.0-beta.2",
     "optionalDependencies": {
-        "@maaxyz/maa-node-darwin-arm64": "5.9.2",
-        "@maaxyz/maa-node-darwin-x64": "5.9.2",
-        "@maaxyz/maa-node-linux-arm64": "5.9.2",
-        "@maaxyz/maa-node-linux-x64": "5.9.2",
-        "@maaxyz/maa-node-win32-arm64": "5.9.2",
-        "@maaxyz/maa-node-win32-x64": "5.9.2"
+        "@maaxyz/maa-node-darwin-arm64": "5.10.0-beta.2",
+        "@maaxyz/maa-node-darwin-x64": "5.10.0-beta.2",
+        "@maaxyz/maa-node-linux-arm64": "5.10.0-beta.2",
+        "@maaxyz/maa-node-linux-x64": "5.10.0-beta.2",
+        "@maaxyz/maa-node-win32-arm64": "5.10.0-beta.2",
+        "@maaxyz/maa-node-win32-x64": "5.10.0-beta.2"
     }
 }