@maaxyz/maa-node 5.9.1 → 5.10.0-beta.1

package/dist/constant.d.ts

@@ -136,6 +136,37 @@ declare global {
             | 'PostMessageWithWindowPos',
             ScreencapOrInputMethods
         >
+
+        /**
+         * 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 DbgControllerType: Record<'CarouselImage' | 'ReplayRecording', Uint64>
         const GamepadType: Record<'Xbox360' | 'DualShock4', Uint64>
     }

package/dist/controller.d.ts

@@ -248,6 +248,16 @@ 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)
         }

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.1",
+    "version": "5.10.0-beta.1",
     "optionalDependencies": {
-        "@maaxyz/maa-node-darwin-arm64": "5.9.1",
-        "@maaxyz/maa-node-darwin-x64": "5.9.1",
-        "@maaxyz/maa-node-linux-arm64": "5.9.1",
-        "@maaxyz/maa-node-linux-x64": "5.9.1",
-        "@maaxyz/maa-node-win32-arm64": "5.9.1",
-        "@maaxyz/maa-node-win32-x64": "5.9.1"
+        "@maaxyz/maa-node-darwin-arm64": "5.10.0-beta.1",
+        "@maaxyz/maa-node-darwin-x64": "5.10.0-beta.1",
+        "@maaxyz/maa-node-linux-arm64": "5.10.0-beta.1",
+        "@maaxyz/maa-node-linux-x64": "5.10.0-beta.1",
+        "@maaxyz/maa-node-win32-arm64": "5.10.0-beta.1",
+        "@maaxyz/maa-node-win32-x64": "5.10.0-beta.1"
     }
 }