ms-types 0.0.49 → 0.0.50

package/package.json

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

package/types/action.d.ts

@@ -138,22 +138,6 @@ declare namespace action {
     endY: number,
     duration?: number
   ): boolean;
-  /**
-   * 执行组合操作
-   * @param actions 操作列表
-   * @returns 执行组合操作是否成功
-   * @example action.actions({
-   *  "type": "pointer",
-   *   "id": "pointer1",
-   *   "parameters": { "pointerType": "touch" },
-   *   "actions": [
-   *     { "type": "pointerMove", "duration": 0, "x": x1, "y": y1 },
-   *     { "type": "pointerDown", "button": 0 },
-   *     { "type": "pointerUp", "button": 0 }
-   *   ]
-   * })
-   */
-  function actions(actions: Record<string, any>): boolean;
   /**
    * 输入文本
    * @param text 文本内容
@@ -198,4 +182,109 @@ declare namespace action {
     button: "home" | "volumeup" | "volumedown" | "power" | "snapshot",
     duration?: number
   ): boolean;
+
+  /**
+   * 创建 WebDriver Actions 构建器，支持链式调用构建复杂的多点触控动作
+   * @returns WDAActionBuilder 实例
+   * @example const builder = action.createActionBuilder()
+   */
+  function createActionBuilder(): ActionBuilder;
+
+  /**
+   * ActionBuilder 构建器接口
+   * 支持链式调用构建复杂的多点触控动作
+   */
+  interface ActionBuilder {
+    /**
+     * 添加一个指针（手指）
+     * @param id 指针编号，如 1-10
+     * @returns PointerBuilder 用于配置该指针的动作
+     * @example builder.addPointer(1).moveTo(100, 100).tap(200, 200).done()
+     */
+    addPointer(id: number): PointerBuilder;
+
+    /**
+     * 快速创建单点点击
+     * @param x X 坐标
+     * @param y Y 坐标
+     * @param duration 点击持续时间，如果未定义则默认为 20ms
+     * @returns 返回自身，支持链式调用
+     * @example builder.singleTap(100, 100, 50).execute()
+     */
+    singleTap(x: number, y: number, duration?: number): ActionBuilder;
+
+    /**
+     * 快速创建多点点击
+     * @param points 点击坐标数组，每个元素包含 x 和 y 坐标
+     * @param duration 点击持续时间，如果未定义则默认为 20ms
+     * @returns 返回自身，支持链式调用
+     * @example builder.multiTap([{x: 100, y: 100}, {x: 200, y: 200}], 50).execute()
+     */
+    multiTap(
+      points: Array<{ x: number; y: number }>,
+      duration?: number
+    ): ActionBuilder;
+
+    /**
+     * 执行构建的动作
+     * @returns 执行是否成功
+     * @example const success = builder.execute()
+     */
+    execute(): boolean;
+  }
+
+  /**
+   * 指针构建器接口
+   * 用于配置单个指针（手指）的动作序列
+   */
+  interface PointerBuilder {
+    /**
+     * 移动到指定坐标
+     * @param x X 坐标
+     * @param y Y 坐标
+     * @param duration 移动持续时间，如果未定义则默认为 0ms
+     * @returns 返回自身，支持链式调用
+     * @example pointer.moveTo(100, 100, 200)
+     */
+    moveTo(x: number, y: number, duration?: number): PointerBuilder;
+
+    /**
+     * 按下手指
+     * @returns 返回自身，支持链式调用
+     * @example pointer.down()
+     */
+    down(): PointerBuilder;
+
+    /**
+     * 抬起手指
+     * @returns 返回自身，支持链式调用
+     * @example pointer.up()
+     */
+    up(): PointerBuilder;
+
+    /**
+     * 延迟指定时间（暂停）
+     * @param duration 延迟时间（毫秒），如果未定义则默认为 20ms
+     * @returns 返回自身，支持链式调用
+     * @example pointer.stay(100)
+     */
+    stay(duration?: number): PointerBuilder;
+
+    /**
+     * 执行点击动作（移动 -> 按下 -> 暂停 -> 抬起）
+     * @param x X 坐标
+     * @param y Y 坐标
+     * @param duration 按下持续时间，如果未定义则默认为 20ms
+     * @returns 返回自身，支持链式调用
+     * @example pointer.tap(100, 100, 50)
+     */
+    tap(x: number, y: number, duration?: number): PointerBuilder;
+
+    /**
+     * 完成当前指针配置，返回到主构建器
+     * @returns 返回 WDAActionBuilder，可以继续添加其他指针
+     * @example pointer.done().addPointer(2)
+     */
+    done(): ActionBuilder;
+  }
 }