ms-types 0.1.19 → 0.1.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-types",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "type": "module",
   "license": "MIT",
   "publishConfig": {

package/types/action.d.ts

@@ -22,7 +22,7 @@ declare namespace action {
     y: number,
     duration?: number,
     jitter?: boolean
-  ): boolean;
+  ): boolean | Promise<boolean>;
   /**
    * 随机点击
    * @param x1 区域左上角x坐标
@@ -39,7 +39,7 @@ declare namespace action {
     x2: number,
     y2: number,
     duration?: number
-  ): boolean;
+  ): boolean | Promise<boolean>;
   /**
    * 双击
    * @param x 坐标x
@@ -56,7 +56,7 @@ declare namespace action {
     duration?: number,
     interval?: number,
     jitter?: boolean
-  ): boolean;
+  ): boolean | Promise<boolean>;
   /**
    * 随机双击
    * @param x1 区域左上角x坐标
@@ -75,7 +75,7 @@ declare namespace action {
     y2: number,
     duration?: number,
     interval?: number
-  ): boolean;
+  ): boolean | Promise<boolean>;
   /**
    * 滑动
    * @param startX 起始坐标x
@@ -96,7 +96,7 @@ declare namespace action {
     duration?: number,
     jitter?: boolean,
     steps?: number
-  ): boolean;
+  ): boolean | Promise<boolean>;
   /**
    * 长按滑动
    * @param startX 起始坐标x
@@ -121,7 +121,7 @@ declare namespace action {
     touch_up_duration?: number,
     jitter?: boolean,
     steps?: number
-  ): boolean;
+  ): boolean | Promise<boolean>;
   /**
    * 3点曲线滑动（先快后慢，拟人化轨迹）
    * 使用二次贝塞尔曲线算法，添加随机偏移和时间抖动，模拟真实人手操作
@@ -143,40 +143,42 @@ declare namespace action {
     endX: number,
     endY: number,
     duration?: number
-  ): boolean;
+  ): boolean | Promise<boolean>;
   /**
    * 输入文本
    * @param text 文本内容
    * @returns 输入文本是否成功
    * @example action.input("123456")
    */
-  function input(text: string): boolean;
+  function input(text: string): boolean | Promise<boolean>;
   /**
    * 删除文本
    * @param count 删除数量 默认为1
    * @returns 删除文本是否成功
    * @example action.backspace(1)
    */
-  function backspace(count?: number): boolean;
+  function backspace(count?: number): boolean | Promise<boolean>;
   /**
    * 调用回车
    * @returns 调用回车是否成功
    * @example action.enter()
    */
-  function enter(): boolean;
+  function enter(): boolean | Promise<boolean>;
   /**
    * 返回首页
    * @returns 返回首页是否成功
    * @example action.homeScreen()
    */
-  function homeScreen(): boolean;
+  function homeScreen(): boolean | Promise<boolean>;
   /**
    * 按下按钮
    * @param button 按钮 home 按下home键 volumeup 按下音量上键 volumedown 按下音量下键
    * @returns 按下按钮是否成功
    * @example action.pressButton("home")
    */
-  function pressButton(button: "home" | "volumeup" | "volumedown"): boolean;
+  function pressButton(
+    button: "home" | "volumeup" | "volumedown"
+  ): boolean | Promise<boolean>;
   /**
    * 模拟按下HID按钮
    * @param button HID按钮 home 按下home键 volumeup 按下音量上键 volumedown 按下音量下键 power 按下电源键 snapshot 按下截图键
@@ -187,7 +189,7 @@ declare namespace action {
   function pressHidButton(
     button: "home" | "volumeup" | "volumedown" | "power" | "snapshot",
     duration?: number
-  ): boolean;
+  ): boolean | Promise<boolean>;
 
   /**
    * 创建 ActionBuilder 构建器，支持链式调用构建复杂的多点触控动作

package/types/hid.d.ts

@@ -278,7 +278,7 @@ declare namespace hid {
    * 获取剪切板内容
    * @returns 剪切板内容
    */
-  function getClipboard(): string | null;
+  function getClipboard(): string;
 
   /**
    * 执行自定义按钮

package/types/node.d.ts

@@ -144,6 +144,12 @@ declare interface NodeInfo {
  * 节点选择器 包含节点选择、节点操作等功能
  */
 declare class NodeSelector {
+  /**
+   * 获取节点 xml 字符串
+   * @param timeout 超时时间，单位毫秒 默认为 5000 毫秒
+   * @returns 节点 xml 字符串
+   */
+  xml(timeout?: number): string | null;
   /**
    * 获取节点信息
    * @param timeout 超时时间，单位毫秒 默认为 5000 毫秒

package/types/system.d.ts

@@ -2,6 +2,16 @@
  * 系统模块 包含系统操作、系统信息等功能
  */
 declare namespace system {
+  type AppInfo = {
+    bundleId: string;
+    name: string;
+    pid: number;
+    processArguments: {
+      env: Record<string, any>;
+      args: string[];
+    };
+  } | null;
+
   /**
    * 启动应用
    * @param bundleId 应用bundleId
@@ -18,7 +28,7 @@ declare namespace system {
     bundleId: string,
     args?: string[],
     env?: Record<string, any>
-  ): boolean;
+  ): boolean | Promise<boolean>;
   /**
    * 关闭应用
    * @param bundleId 应用bundleId
@@ -29,7 +39,7 @@ declare namespace system {
    *   logi("关闭成功")
    * }
    */
-  function stopApp(bundleId: string): boolean;
+  function stopApp(bundleId: string): boolean | Promise<boolean>;
   /**
    * 激活应用 没启动就会启动 启动了就会进入前台
    * @param bundleId 应用bundleId
@@ -40,7 +50,8 @@ declare namespace system {
    *   logi("激活成功")
    * }
    */
-  function activateApp(bundleId: string): boolean;
+  function activateApp(bundleId: string): boolean | Promise<boolean>;
+
   /**
    * 获取当前在前台的应用信息
    * @returns 当前在前台的应用信息
@@ -50,15 +61,7 @@ declare namespace system {
    *   logi(info.name)
    * }
    */
-  function activateAppInfo(): {
-    bundleId: string;
-    name: string;
-    pid: number;
-    processArguments: {
-      env: Record<string, any>;
-      args: string[];
-    };
-  } | null;
+  function activateAppInfo(): AppInfo | Promise<AppInfo>;
   /**
    * 获取系统是否锁屏
    * @returns 是否锁屏
@@ -68,7 +71,7 @@ declare namespace system {
    *   logi("锁屏")
    * }
    */
-  function isLocked(): boolean;
+  function isLocked(): boolean | Promise<boolean>;
   /**
    * 锁屏
    * @returns 是否锁屏成功
@@ -78,7 +81,7 @@ declare namespace system {
    *   logi("锁屏成功")
    * }
    */
-  function lock(): boolean;
+  function lock(): boolean | Promise<boolean>;
   /**
    * 解锁 如果有密码 会停在解锁界面
    * @returns 是否解锁成功
@@ -88,7 +91,7 @@ declare namespace system {
    *   logi("解锁成功")
    * }
    */
-  function unlock(): boolean;
+  function unlock(): boolean | Promise<boolean>;
   /**
    * 设置剪贴板 APP 在前台运行时才能设置
    * @param text 剪贴板内容
@@ -109,7 +112,7 @@ declare namespace system {
    *   logi(text)
    * }
    */
-  function getClipboard(): string | null;
+  function getClipboard(): string;
   /**
    * 打开URL
    * @param url URL
@@ -120,7 +123,7 @@ declare namespace system {
    *   logi("打开成功")
    * }
    */
-  function openURL(url: string): boolean;
+  function openURL(url: string): boolean | Promise<boolean>;
   /**
    * 通知
    * @param msg 通知内容
@@ -176,7 +179,7 @@ declare namespace system {
    *   logi("WDA 启动成功")
    * }
    */
-  function startWDA(): boolean;
+  function startWDA(): boolean | Promise<boolean>;
   /**
    * 获取 WDA 状态
    * @returns WDA 是否正在运行
@@ -188,5 +191,5 @@ declare namespace system {
    *   logi("WDA 服务未运行")
    * }
    */
-  function getWDAStatus(): boolean;
+  function getWDAStatus(): boolean | Promise<boolean>;
 }

package/types/zh//345/212/250/344/275/234/346/250/241/345/235/227.d.ts

@@ -24,7 +24,7 @@ declare namespace $动作 {
     坐标y: 数字,
     按下持续时间?: 数字,
     抖动?: 布尔值
-  ): 布尔值;
+  ): 布尔值 | Promise<布尔值>;
   /**
    * 随机点击
    * @param 区域左上角x坐标
@@ -41,7 +41,7 @@ declare namespace $动作 {
     区域右下角x坐标: 数字,
     区域右下角y坐标: 数字,
     按下持续时间?: 数字
-  ): 布尔值;
+  ): 布尔值 | Promise<布尔值>;
   /**
    * 双击
    * @param 坐标x
@@ -58,7 +58,7 @@ declare namespace $动作 {
     按下持续时间?: 数字,
     间隔时间?: 数字,
     抖动?: 布尔值
-  ): 布尔值;
+  ): 布尔值 | Promise<布尔值>;
   /**
    * 随机双击
    * @param 区域左上角x坐标
@@ -77,7 +77,7 @@ declare namespace $动作 {
     区域右下角y坐标: 数字,
     按下持续时间?: 数字,
     间隔时间?: 数字
-  ): 布尔值;
+  ): 布尔值 | Promise<布尔值>;
   /**
    * 滑动
    * @param 起始x坐标
@@ -98,7 +98,7 @@ declare namespace $动作 {
     滑动持续时间?: 数字,
     抖动?: 布尔值,
     步数?: 数字
-  ): 布尔值;
+  ): 布尔值 | Promise<布尔值>;
   /**
    * 长按滑动
    * @param 起始x坐标
@@ -123,7 +123,7 @@ declare namespace $动作 {
     松开持续时间?: 数字,
     抖动?: 布尔值,
     步数?: 数字
-  ): 布尔值;
+  ): 布尔值 | Promise<布尔值>;
   /**
    * 3点曲线滑动（先快后慢，拟人化轨迹）
    * 使用二次贝塞尔曲线算法，添加随机偏移和时间抖动，模拟真实人手操作
@@ -145,40 +145,42 @@ declare namespace $动作 {
     目标x坐标: 数字,
     目标y坐标: 数字,
     滑动持续时间?: 数字
-  ): 布尔值;
+  ): 布尔值 | Promise<布尔值>;
   /**
    * 输入文本
    * @param text 文本内容
    * @returns 输入文本是否成功
    * @example $动作.输入文本("123456")
    */
-  function 输入文本(文本: 字符串): 布尔值;
+  function 输入文本(文本: 字符串): 布尔值 | Promise<布尔值>;
   /**
    * 删除文本
    * @param 删除数量 默认为1
    * @returns 删除文本是否成功
    * @example $动作.删除文本(1)
    */
-  function 删除文本(删除数量?: 数字): 布尔值;
+  function 删除文本(删除数量?: 数字): 布尔值 | Promise<布尔值>;
   /**
    * 调用回车
    * @returns 调用回车是否成功
    * @example $动作.回车()
    */
-  function 回车(): 布尔值;
+  function 回车(): 布尔值 | Promise<布尔值>;
   /**
    * 返回首页
    * @returns 返回首页是否成功
    * @example $动作.回到主页()
    */
-  function 回到主页(): 布尔值;
+  function 回到主页(): 布尔值 | Promise<布尔值>;
   /**
    * 按下按钮
    * @param 按键 按钮 home 按下home键 volumeup 按下音量上键 volumedown 按下音量下键
    * @returns 按下按钮是否成功
    * @example $动作.按键("home")
    */
-  function 按键(按键: "home" | "volumeup" | "volumedown"): 布尔值;
+  function 按键(
+    按键: "home" | "volumeup" | "volumedown"
+  ): 布尔值 | Promise<布尔值>;
   /**
    * 模拟按下HID按钮
    * @param 按键 HID按钮 home 按下home键 volumeup 按下音量上键 volumedown 按下音量下键 power 按下电源键 snapshot 按下截图键
@@ -189,7 +191,7 @@ declare namespace $动作 {
   function 按键HID(
     按键: "home" | "volumeup" | "volumedown" | "power" | "snapshot",
     持续时间?: 数字
-  ): 布尔值;
+  ): 布尔值 | Promise<布尔值>;
 
   /**
    * 创建 动作构建器，支持链式调用构建复杂的多点触控动作

package/types/zh//347/263/273/347/273/237/346/250/241/345/235/227.d.ts

@@ -3,6 +3,15 @@
  * 系统模块 包含系统操作、系统信息等功能
  */
 declare namespace $系统 {
+  type APP信息 = {
+    bundleId: string;
+    name: string;
+    pid: number;
+    processArguments: {
+      env: Record<string, any>;
+      args: string[];
+    };
+  } | null;
   /**
    * 启动应用
    * @param bundleId 应用bundleId
@@ -19,7 +28,7 @@ declare namespace $系统 {
     bundleId: 字符串,
     args?: 字符串[],
     env?: 字典<任意类型>
-  ): 布尔值;
+  ): 布尔值 | Promise<布尔值>;
   /**
    * 停止应用
    * @param bundleId 应用bundleId
@@ -27,10 +36,10 @@ declare namespace $系统 {
    * @example
    * const 是否关闭成功 = $系统.停止应用("cn.magicnode.script")
    * if (是否关闭成功) {
-     *   $打印信息日志("关闭成功")
-     * }
+   *   $打印信息日志("关闭成功")
+   * }
    */
-  function 停止应用(bundleId: 字符串): 布尔值;
+  function 停止应用(bundleId: 字符串): 布尔值 | Promise<布尔值>;
   /**
    * 激活应用 没启动就会启动 启动了就会进入前台
    * @param bundleId 应用bundleId
@@ -41,7 +50,7 @@ declare namespace $系统 {
    *   $打印信息日志("激活成功")
    * }
    */
-  function 把应用切入前台(bundleId: 字符串): 布尔值;
+  function 把应用切入前台(bundleId: 字符串): 布尔值 | Promise<布尔值>;
   /**
    * 获取当前在前台的应用信息
    * @returns 当前在前台的应用信息
@@ -51,15 +60,7 @@ declare namespace $系统 {
    *   $打印信息日志(info.name)
    * }
    */
-  function 获取当前运行的应用(): {
-    bundleId: 字符串;
-    name: 字符串;
-    pid: 数字;
-    processArguments: {
-      env: 字典<任意类型>;
-      args: 字符串[];
-    };
-  } | null;
+  function 获取当前运行的应用(): APP信息 | Promise<APP信息>;
   /**
    * 获取系统是否锁屏
    * @returns 是否锁屏
@@ -69,7 +70,7 @@ declare namespace $系统 {
    *   $打印信息日志("锁屏")
    * }
    */
-  function 是否锁屏(): 布尔值;
+  function 是否锁屏(): 布尔值 | Promise<布尔值>;
   /**
    * 锁屏
    * @returns 是否锁屏成功
@@ -79,7 +80,7 @@ declare namespace $系统 {
    *   $打印信息日志("锁屏成功")
    * }
    */
-  function 锁屏(): 布尔值;
+  function 锁屏(): 布尔值 | Promise<布尔值>;
   /**
    * 解锁 如果有密码 会停在解锁界面
    * @returns 是否解锁成功
@@ -89,7 +90,7 @@ declare namespace $系统 {
    *   $打印信息日志("解锁成功")
    * }
    */
-  function 解锁(): 布尔值;
+  function 解锁(): 布尔值 | Promise<布尔值>;
   /**
    * 设置剪贴板 APP 在前台运行时才能设置
    * @param text 剪贴板内容
@@ -121,7 +122,7 @@ declare namespace $系统 {
    *   $打印信息日志("打开成功")
    * }
    */
-  function 打开URL(URL: 字符串): 布尔值;
+  function 打开URL(URL: 字符串): 布尔值 | Promise<布尔值>;
   /**
    * 通知
    * @param msg 通知内容
@@ -177,7 +178,7 @@ declare namespace $系统 {
    *   $打印信息日志("WDA 启动成功")
    * }
    */
-  function 启动WDA服务(): 布尔值;
+  function 启动WDA服务(): 布尔值 | Promise<布尔值>;
   /**
    * 获取 WDA 状态
    * @returns WDA 是否正在运行
@@ -189,5 +190,5 @@ declare namespace $系统 {
    *   $打印信息日志("WDA 服务未运行")
    * }
    */
-  function 获取WDA状态(): 布尔值;
+  function 获取WDA状态(): 布尔值 | Promise<布尔值>;
 }

package/types/zh//350/212/202/347/202/271/346/250/241/345/235/227.d.ts

@@ -145,6 +145,12 @@ declare interface $节点信息 {
  * 节点选择器 包含节点选择、节点操作等功能
  */
 declare class $节点选择器 {
+  /**
+   * 获取节点 xml 字符串
+   * @param 超时时间 单位毫秒 默认为 5000 毫秒
+   * @returns 节点 xml 字符串
+   */
+  xml(超时时间?: 数字): 字符串 | null;
   /**
    * 获取节点信息
    * @param 超时时间 单位毫秒 默认为 5000 毫秒