@maaxyz/maa-node 4.5.6 → 5.0.0-alpha.2

package/dist/client.d.ts

@@ -1,14 +1,19 @@
-import * as maa from './maa';
-import { Resource } from './resource';
-export declare class AgentClient {
-    handle: maa.AgentClientHandle;
-    constructor(identifier?: string);
-    destroy(): void;
-    get identifier(): string | null;
-    bind_resource(resource: Resource): void;
-    connect(): Promise<void>;
-    disconnect(): void;
-    get connected(): boolean;
-    get alive(): boolean;
-    set timeout(ms: maa.Uint64);
+declare global {
+    namespace maa {
+        class Client {
+            constructor(identifier?: string)
+
+            destroy(): void
+            get identifier(): string
+            bind_resource(resource: Resource): void
+            register_sink(tasker?: Tasker, resource?: Resource, controller?: Controller): void
+            connect(): Promise<void>
+            disconnect(): void
+            get connected(): boolean
+            get alive(): boolean
+            set timeout(ms: Uint64)
+        }
+    }
 }
+
+export {}

package/dist/constant.d.ts

@@ -0,0 +1,28 @@
+declare global {
+    namespace maa {
+        const Status: Record<'Invalid' | 'Pending' | 'Running' | 'Succeeded' | 'Failed', Status>
+        const AdbScreencapMethod: Record<
+            | 'EncodeToFileAndPull'
+            | 'Encode'
+            | 'RawWithGzip'
+            | 'RawByNetcat'
+            | 'MinicapDirect'
+            | 'MinicapStream'
+            | 'EmulatorExtras'
+            | 'All'
+            | 'Default',
+            ScreencapOrInputMethods
+        >
+        const AdbInputMethod: Record<
+            'AdbShell' | 'MinitouchAndAdbKey' | 'Maatouch' | 'EmulatorExtras' | 'All' | 'Default',
+            ScreencapOrInputMethods
+        >
+        const Win32ScreencapMethod: Record<
+            'GDI' | 'FramePool' | 'DXGI_DesktopDup',
+            ScreencapOrInputMethods
+        >
+        const Win32InputMethod: Record<'Seize' | 'SendMessage', ScreencapOrInputMethods>
+        const DbgControllerType: Record<'CarouselImage' | 'ReplayRecording', Uint64>
+    }
+}
+export {}

package/dist/context.d.ts

@@ -1,54 +1,34 @@
-import * as maa from './maa';
-import { DumpTask } from './pipeline';
-import { TaskerBase } from './tasker';
-export declare class Context {
-    #private;
-    handle: maa.ContextHandle;
-    constructor(handle: maa.ContextHandle);
-    run_task(entry: string, pipeline_override?: Record<string, unknown> | Record<string, unknown>[]): Promise<{
-        entry: string;
-        nodes: ({
-            name: string;
-            reco: {
-                name: string;
-                algorithm: string;
-                hit: boolean;
-                box: maa.Rect;
-                detail: import("./tasker").RecoDetail;
-                raw: ArrayBuffer;
-                draws: ArrayBuffer[];
-            } | null;
-            completed: boolean;
-        } | null)[];
-        status: maa.Status;
-    } | null>;
-    run_recognition(entry: string, image: ArrayBuffer | Buffer, pipeline_override?: Record<string, unknown> | Record<string, unknown>[]): Promise<{
-        name: string;
-        algorithm: string;
-        hit: boolean;
-        box: maa.Rect;
-        detail: import("./tasker").RecoDetail;
-        raw: ArrayBuffer;
-        draws: ArrayBuffer[];
-    } | null>;
-    run_action(entry: string, box: maa.Rect, reco_detail: string, pipeline_override?: Record<string, unknown> | Record<string, unknown>[]): Promise<{
-        name: string;
-        reco: {
-            name: string;
-            algorithm: string;
-            hit: boolean;
-            box: maa.Rect;
-            detail: import("./tasker").RecoDetail;
-            raw: ArrayBuffer;
-            draws: ArrayBuffer[];
-        } | null;
-        completed: boolean;
-    } | null>;
-    override_pipeline(pipeline_override: Record<string, unknown> | Record<string, unknown>[]): void;
-    override_next(node_name: string, next: string[]): void;
-    get_node_data(node_name: string): string | null;
-    get_node_data_parsed(node_name: string): DumpTask | null;
-    get task_id(): maa.TaskId;
-    get tasker(): TaskerBase;
-    clone(): Context;
+declare global {
+    namespace maa {
+        class Context {
+            constructor(handle?: string)
+
+            run_task(
+                entry: string,
+                pipeline_override?: Record<string, unknown> | Record<string, unknown>[],
+            ): Promise<TaskDetail | null>
+            run_recognition(
+                entry: string,
+                image: ImageData | Buffer,
+                pipeline_override?: Record<string, unknown> | Record<string, unknown>[],
+            ): Promise<RecoDetail | null>
+            run_action(
+                entry: string,
+                box: Rect,
+                reco_detail: string,
+                pipeline_override?: Record<string, unknown> | Record<string, unknown>[],
+            ): Promise<NodeDetail | null>
+            override_pipeline(
+                pipeline_override: Record<string, unknown> | Record<string, unknown>[],
+            ): void
+            override_next(node_name: string, next: string[]): void
+            get_node_data(node_name: string): string | null
+            get_node_data_parsed(node_name: string): DumpTask | null
+            get task_id(): TaskId
+            get tasker(): Tasker
+            clone(): Context
+        }
+    }
 }
+
+export {}

package/dist/controller.d.ts

@@ -1,158 +1,226 @@
-import { Job, JobSource } from './job';
-import maa, { ImageData } from './maa';
-import { ChainNotifyType } from './types';
-import { chain_notify_impl } from './utils';
-declare class ImageJob extends Job<maa.CtrlId, JobSource<maa.CtrlId>> {
-    #private;
-    constructor(ctrl: ControllerBase, source: JobSource<maa.CtrlId>, id: maa.CtrlId);
-    get(): ArrayBuffer | null;
-    wait(): Promise<this> & {
-        status: Promise<maa.Status>;
-        done: Promise<boolean>;
-        succeeded: Promise<boolean>;
-        failed: Promise<boolean>;
-    } & {
-        get: () => Promise<ArrayBuffer | null>;
-    };
+declare global {
+    namespace maa {
+        type Point = [x: number, y: number]
+
+        type SwipeParam = {
+            begin: Point
+            end: Point[]
+            end_hold: number[]
+            duration: number[]
+            only_hover: boolean
+            starting: number
+        }
+
+        type ControllerNotify = {
+            msg:
+                | 'Controller.Action.Starting'
+                | 'Controller.Action.Succeeded'
+                | 'Controller.Action.Failed'
+            ctrl_id: CtrlId
+            uuid: string
+        } & (
+            | {
+                  action: 'connect'
+                  param?: never
+              }
+            | {
+                  action: 'click'
+                  param: {
+                      point: Point
+                  }
+              }
+            | {
+                  action: 'long_press'
+                  param: {
+                      point: Point
+                      duration: number
+                  }
+              }
+            | {
+                  action: 'swipe'
+                  param: SwipeParam
+              }
+            | {
+                  action: 'multi_swipe'
+                  param: SwipeParam[]
+              }
+            | {
+                  action: 'touch_down' | 'touch_move' | 'touch_up'
+                  param: {
+                      contact: number
+                      point: Point
+                      pressure: number
+                  }
+              }
+            | {
+                  action: 'click_key' | 'key_down' | 'key_up'
+                  param: {
+                      keycode: number[]
+                  }
+              }
+            | {
+                  action: 'long_press_key'
+                  param: {
+                      keycode: number[]
+                      duration: number
+                  }
+              }
+            | {
+                  action: 'input_text'
+                  param: {
+                      text: string
+                  }
+              }
+            | {
+                  action: 'screencap'
+                  param?: never
+              }
+            | {
+                  action: 'start_app' | 'stop_app'
+                  param: {
+                      package: string
+                  }
+              }
+        )
+
+        class ImageJob extends Job<CtrlId, Controller, ImageData | null> {
+            constructor(source: Controller, id: CtrlId)
+        }
+
+        class Controller {
+            constructor(handle?: string)
+
+            destroy(): void
+            add_sink(cb: (ctrl: Controller, msg: ControllerNotify) => MaybePromise<void>): SinkId
+            remove_sink(id: SinkId): void
+            clear_sinks(): void
+
+            set screenshot_target_long_side(value: number)
+            set screenshot_target_short_side(value: number)
+            set screenshot_use_raw_size(value: boolean)
+
+            post_connection(): Job<CtrlId, Controller>
+            post_click(x: number, y: number): Job<CtrlId, Controller>
+            post_swipe(
+                x1: number,
+                y1: number,
+                x2: number,
+                y2: number,
+                duration: number,
+            ): Job<CtrlId, Controller>
+            post_click_key(keycode: number): Job<CtrlId, Controller>
+            post_input_text(text: string): Job<CtrlId, Controller>
+            post_start_app(intent: string): Job<CtrlId, Controller>
+            post_stop_app(intent: string): Job<CtrlId, Controller>
+            post_touch_down(
+                contact: number,
+                x: number,
+                y: number,
+                pressure: number,
+            ): Job<CtrlId, Controller>
+            post_touch_move(
+                contact: number,
+                x: number,
+                y: number,
+                pressure: number,
+            ): Job<CtrlId, Controller>
+            post_touch_up(contact: number): Job<CtrlId, Controller>
+            post_key_down(keycode: number): Job<CtrlId, Controller>
+            post_key_up(keycode: number): Job<CtrlId, Controller>
+            post_screencap(): ImageJob
+            override_pipeline(pipeline: Record<string, unknown> | Record<string, unknown>[]): void
+            override_next(node_name: string, next_list: string[]): void
+            get_node_data(node_name: string): string | null
+            get_node_data_parsed(node_name: string): DumpTask | null
+            clear(): void
+            status(id: CtrlId): Status
+            wait(id: CtrlId): Promise<Status>
+            get connected(): boolean
+            get cached_image(): ImageData | null
+            get uuid(): string | null
+        }
+
+        type AdbDevice = [
+            name: string,
+            adb_path: string,
+            address: string,
+            screencap_methods: ScreencapOrInputMethods,
+            input_methods: ScreencapOrInputMethods,
+            config: string,
+        ]
+
+        class AdbController extends Controller {
+            constructor(
+                adb_path: string,
+                address: string,
+                screencap_methods: ScreencapOrInputMethods,
+                input_methods: ScreencapOrInputMethods,
+                config: string,
+                agent?: string,
+            )
+
+            static agent_path(): string
+            static find(adb?: string): Promise<AdbDevice[] | null>
+        }
+
+        type DesktopDevice = [handle: DesktopHandle, class_name: string, window_name: string]
+
+        class Win32Controller extends Controller {
+            constructor(
+                hwnd: DesktopHandle,
+                screencap_methods: ScreencapOrInputMethods,
+                input_methods: ScreencapOrInputMethods,
+            )
+
+            static find(): Promise<DesktopDevice[] | null>
+        }
+
+        class DbgController extends Controller {
+            constructor(
+                read_path: string,
+                write_path: string,
+                type: Uint64, // DbgControllerType
+                config: string,
+            )
+        }
+
+        interface CustomControllerActor {
+            connect?(): maa.MaybePromise<boolean>
+            request_uuid?(): maa.MaybePromise<string | null>
+            start_app?(intent: string): maa.MaybePromise<boolean>
+            stop_app?(intent: string): maa.MaybePromise<boolean>
+            screencap?(): maa.MaybePromise<maa.ImageData | null>
+            click?(x: number, y: number): maa.MaybePromise<boolean>
+            swipe?(
+                x1: number,
+                y1: number,
+                x2: number,
+                y2: number,
+                duration: number,
+            ): maa.MaybePromise<boolean>
+            touch_down?(
+                contact: number,
+                x: number,
+                y: number,
+                pressure: number,
+            ): maa.MaybePromise<boolean>
+            touch_move?(
+                contact: number,
+                x: number,
+                y: number,
+                pressure: number,
+            ): maa.MaybePromise<boolean>
+            touch_up?(contact: number): maa.MaybePromise<boolean>
+            click_key?(keycode: number): maa.MaybePromise<boolean>
+            input_text?(text: string): maa.MaybePromise<boolean>
+            key_down?(keycode: number): maa.MaybePromise<boolean>
+            key_up?(keycode: number): maa.MaybePromise<boolean>
+        }
+
+        class CustomController extends Controller {
+            constructor(actor: CustomControllerActor)
+        }
+    }
 }
-type Point = [x: number, y: number];
-export type SwipeParam = {
-    begin: Point;
-    end: Point[];
-    end_hold: number[];
-    duration: number[];
-    only_hover: boolean;
-    starting: number;
-};
-export type ControllerNotify = {
-    msg: 'Action.Starting' | 'Action.Succeeded' | 'Action.Failed';
-    ctrl_id: maa.CtrlId;
-    uuid: string;
-} & ({
-    action: 'connect';
-    param?: never;
-} | {
-    action: 'click';
-    param: {
-        point: Point;
-    };
-} | {
-    action: 'long_press';
-    param: {
-        point: Point;
-        duration: number;
-    };
-} | {
-    action: 'swipe';
-    param: SwipeParam;
-} | {
-    action: 'multi_swipe';
-    param: SwipeParam[];
-} | {
-    action: 'touch_down' | 'touch_move' | 'touch_up';
-    param: {
-        contact: number;
-        point: Point;
-        pressure: number;
-    };
-} | {
-    action: 'click_key' | 'key_down' | 'key_up';
-    param: {
-        keycode: number[];
-    };
-} | {
-    action: 'long_press_key';
-    param: {
-        keycode: number[];
-        duration: number;
-    };
-} | {
-    action: 'input_text';
-    param: {
-        text: string;
-    };
-} | {
-    action: 'screencap';
-    param?: never;
-} | {
-    action: 'start_app' | 'stop_app';
-    param: {
-        package: string;
-    };
-});
-export declare class ControllerBase {
-    #private;
-    handle: maa.ControllerHandle;
-    notify(message: string, details_json: string): maa.MaybePromise<void>;
-    chain_notify: typeof chain_notify_impl;
-    chain_parsed_notify(cb: (msg: ControllerNotify) => maa.MaybePromise<void>, order?: ChainNotifyType): void;
-    constructor(handle: maa.ControllerHandle);
-    destroy(): void;
-    set screenshot_target_long_side(value: number);
-    set screenshot_target_short_side(value: number);
-    set screenshot_use_raw_size(value: boolean);
-    post_connection(): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
-    post_click(x: number, y: number): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
-    post_swipe(x1: number, y1: number, x2: number, y2: number, duration: number): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
-    post_click_key(keycode: number): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
-    post_key_down(keycode: number): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
-    post_key_up(keycode: number): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
-    post_input_text(text: string): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
-    post_start_app(intent: string): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
-    post_stop_app(intent: string): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
-    post_touch_down(contact: number, x: number, y: number, pressure: number): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
-    post_touch_move(contact: number, x: number, y: number, pressure: number): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
-    post_touch_up(contact: number): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
-    post_screencap(): ImageJob;
-    get connected(): boolean;
-    get cached_image(): ArrayBuffer | null;
-    get uuid(): string | null;
-}
-export declare class AdbController extends ControllerBase {
-    constructor(adb_path: string, address: string, screencap_methods: maa.ScreencapOrInputMethods, input_methods: maa.ScreencapOrInputMethods, config: string, agent?: string);
-    static agent_path(): string;
-    static find(adb?: string): Promise<[name: string, adb_path: string, address: string, screencap_methods: maa.Uint64, input_methods: maa.Uint64, config: string][] | null>;
-}
-export declare class Win32Controller extends ControllerBase {
-    constructor(hwnd: maa.DesktopHandle | null, screencap_methods: maa.ScreencapOrInputMethods, input_methods: maa.ScreencapOrInputMethods);
-    static find(): Promise<[handle: maa.DesktopHandle, class_name: string, window_name: string][] | null>;
-}
-export declare class DbgController extends ControllerBase {
-    constructor(read_path: string, write_path: string, type: maa.Uint64, config: string);
-}
-export declare abstract class CustomControllerActor {
-    abstract connect(): maa.MaybePromise<boolean>;
-    abstract request_uuid(): maa.MaybePromise<string | null>;
-    abstract start_app(intent: string): maa.MaybePromise<boolean>;
-    abstract stop_app(intent: string): maa.MaybePromise<boolean>;
-    abstract screencap(): maa.MaybePromise<ImageData | null>;
-    abstract click(x: number, y: number): maa.MaybePromise<boolean>;
-    abstract swipe(x1: number, y1: number, x2: number, y2: number, duration: number): maa.MaybePromise<boolean>;
-    abstract touch_down(contact: number, x: number, y: number, pressure: number): maa.MaybePromise<boolean>;
-    abstract touch_move(contact: number, x: number, y: number, pressure: number): maa.MaybePromise<boolean>;
-    abstract touch_up(contact: number): maa.MaybePromise<boolean>;
-    abstract click_key(keycode: number): maa.MaybePromise<boolean>;
-    abstract input_text(text: string): maa.MaybePromise<boolean>;
-    abstract key_down(keycode: number): maa.MaybePromise<boolean>;
-    abstract key_up(keycode: number): maa.MaybePromise<boolean>;
-}
-export declare class CustomControllerActorDefaultImpl extends CustomControllerActor {
-    connect(): maa.MaybePromise<boolean>;
-    request_uuid(): maa.MaybePromise<string | null>;
-    start_app(intent: string): maa.MaybePromise<boolean>;
-    stop_app(intent: string): maa.MaybePromise<boolean>;
-    screencap(): maa.MaybePromise<ImageData | null>;
-    click(x: number, y: number): maa.MaybePromise<boolean>;
-    swipe(x1: number, y1: number, x2: number, y2: number, duration: number): maa.MaybePromise<boolean>;
-    touch_down(contact: number, x: number, y: number, pressure: number): maa.MaybePromise<boolean>;
-    touch_move(contact: number, x: number, y: number, pressure: number): maa.MaybePromise<boolean>;
-    touch_up(contact: number): maa.MaybePromise<boolean>;
-    click_key(keycode: number): maa.MaybePromise<boolean>;
-    input_text(text: string): maa.MaybePromise<boolean>;
-    key_down(keycode: number): maa.MaybePromise<boolean>;
-    key_up(keycode: number): maa.MaybePromise<boolean>;
-}
-export declare class CustomController extends ControllerBase {
-    constructor(actor: CustomControllerActor);
-}
-export {};
+
+export {}

package/dist/global.d.ts

@@ -1,9 +1,17 @@
-import * as maa from './maa';
-export declare const Global: {
-    readonly version: string;
-    log_dir: string;
-    save_draw: boolean;
-    stdout_level: keyof typeof maa.LoggingLevel;
-    debug_mode: boolean;
-    config_init_option(user_path: string, default_json?: string): void;
-};
+declare global {
+    namespace maa {
+        const Global: {
+            get version_from_macro(): string
+            get version(): string
+            set log_dir(value: string)
+            set save_draw(value: boolean)
+            set stdout_level(
+                value: 'Off' | 'Fatal' | 'Error' | 'Warn' | 'Info' | 'Debug' | 'Trace' | 'All',
+            )
+            set debug_mode(value: boolean)
+            config_init_option(user_path: string, default_json?: string): void
+        }
+    }
+}
+
+export {}

package/dist/index-client.d.ts

@@ -1,12 +1,12 @@
-import './maa-client.js';
-export * as api from './maa';
-export * from './job';
-export * from './controller';
-export * from './resource';
-export * from './tasker';
-export * from './context';
-export * from './global';
-export * from './pi';
-export * from './types';
-export * from './pipeline';
-export * from './client';
+/// <reference path="./client.d.ts" />
+/// <reference path="./constant.d.ts" />
+/// <reference path="./context.d.ts" />
+/// <reference path="./controller.d.ts" />
+/// <reference path="./global.d.ts" />
+/// <reference path="./job.d.ts" />
+/// <reference path="./pipeline.d.ts" />
+/// <reference path="./resource.d.ts" />
+/// <reference path="./tasker.d.ts" />
+/// <reference path="./types.d.ts" />
+
+export {}