assistsx-js 0.2.1 → 0.2.3

package/dist/step-DnFA4DEb.d.ts

@@ -0,0 +1,1196 @@
+/**
+ * 与 Android AssistsCore.NodeLookupScope / HTTP scope 查询参数一致的字符串取值。
+ */
+type NodeLookupScope = "active_window" | "all_windows";
+/** 与 AssistsCore.NodeLookupScope.ActiveWindow 对应 */
+declare const NODE_LOOKUP_SCOPE_ACTIVE_WINDOW: NodeLookupScope;
+/** 与 AssistsCore.NodeLookupScope.AllWindows 对应 */
+declare const NODE_LOOKUP_SCOPE_ALL_WINDOWS: NodeLookupScope;
+
+declare class Bounds {
+    readonly left: number;
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+    readonly width: number;
+    readonly height: number;
+    readonly centerX: number;
+    readonly centerY: number;
+    readonly exactCenterX: number;
+    readonly exactCenterY: number;
+    readonly isEmpty: boolean;
+    constructor(left: number, top: number, right: number, bottom: number, width: number, height: number, centerX: number, centerY: number, exactCenterX: number, exactCenterY: number, isEmpty: boolean);
+    /**
+     * 判断该 Bounds 是否在屏幕内（满足基本几何有效性）
+     * @returns {boolean}
+     */
+    isInScreen(): boolean;
+    static from(data: {
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+        width: number;
+        height: number;
+        centerX: number;
+        centerY: number;
+        exactCenterX: number;
+        exactCenterY: number;
+        isEmpty: boolean;
+    }): Bounds;
+    static fromJSON(json: string): Bounds;
+    static fromData(data: any): Bounds;
+    toJSON(): {
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+        width: number;
+        height: number;
+        centerX: number;
+        centerY: number;
+        exactCenterX: number;
+        exactCenterY: number;
+        isEmpty: boolean;
+    };
+    clone(): Bounds;
+}
+
+/**
+ * 节点类
+ * 表示界面上的一个可交互元素，包含元素的属性和可执行的操作
+ */
+
+declare class NodeAsync {
+    private node;
+    /**
+     * 构造函数
+     * @param node Node实例
+     */
+    constructor(node: Node);
+    /**
+     * 查找第一个匹配标签的父节点
+     * @param className 类名
+     * @returns 父节点
+     */
+    findFirstParentByTags(className: string): Promise<Node>;
+    /**
+     * 对节点执行点击手势
+     * @param offsetX X轴偏移
+     * @param offsetY Y轴偏移
+     * @param switchWindowIntervalDelay 窗口切换延迟
+     * @param clickDuration 点击持续时间
+     * @returns 是否点击成功
+     */
+    clickNodeByGesture({ offsetX, offsetY, switchWindowIntervalDelay, clickDuration, }?: {
+        offsetX?: number;
+        offsetY?: number;
+        switchWindowIntervalDelay?: number;
+        clickDuration?: number;
+    }): Promise<boolean>;
+    /**
+     * 对节点执行双击手势
+     * @param offsetX X轴偏移
+     * @param offsetY Y轴偏移
+     * @param switchWindowIntervalDelay 窗口切换延迟
+     * @param clickDuration 点击持续时间
+     * @param clickInterval 点击间隔
+     * @returns 是否双击成功
+     */
+    doubleClickNodeByGesture({ offsetX, offsetY, switchWindowIntervalDelay, clickDuration, clickInterval, }?: {
+        offsetX?: number;
+        offsetY?: number;
+        switchWindowIntervalDelay?: number;
+        clickDuration?: number;
+        clickInterval?: number;
+    }): Promise<boolean>;
+    longPressNodeByGestureAutoPaste(text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, }?: {
+        matchedPackageName?: string;
+        matchedText?: string;
+        timeoutMillis?: number;
+        longPressDuration?: number;
+    }): Promise<boolean>;
+    /**
+     * 在当前节点范围内通过标签查找节点
+     * @param className 类名
+     * @param filterText 文本过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
+     */
+    findByTags(className: string, { filterText, filterViewId, filterDes, }?: {
+        filterText?: string;
+        filterViewId?: string;
+        filterDes?: string;
+    }): Promise<Node[]>;
+    /**
+     * 在当前节点范围内通过ID查找节点
+     * @param id 节点ID
+     * @param filterClass 类名过滤
+     * @param filterText 文本过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
+     */
+    findById(id: string, { filterClass, filterText, filterDes, }?: {
+        filterClass?: string;
+        filterText?: string;
+        filterDes?: string;
+    }): Promise<Node[]>;
+    /**
+     * 在当前节点范围内通过文本查找节点
+     * @param text 要查找的文本
+     * @param filterClass 类名过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
+     */
+    findByText(text: string, { filterClass, filterViewId, filterDes, }?: {
+        filterClass?: string;
+        filterViewId?: string;
+        filterDes?: string;
+    }): Promise<Node[]>;
+    /**
+     * 向前滚动节点
+     * @returns 是否滚动成功
+     */
+    scrollForward(): Promise<boolean>;
+    /**
+     * 向后滚动节点
+     * @returns 是否滚动成功
+     */
+    scrollBackward(): Promise<boolean>;
+    /**
+     * 检查节点是否可见
+     * @param compareNode 比较节点
+     * @param isFullyByCompareNode 是否完全可见
+     * @returns 是否可见
+     */
+    isVisible({ compareNode, isFullyByCompareNode, }?: {
+        compareNode?: Node;
+        isFullyByCompareNode?: boolean;
+    }): Promise<boolean>;
+    /**
+     * 对节点进行截图
+     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
+     * @returns 截图路径
+     */
+    takeScreenshot(overlayHiddenScreenshotDelayMillis?: number): Promise<string>;
+    /**
+     * 设置节点文本
+     * @param text 要设置的文本
+     * @returns 是否设置成功
+     */
+    setNodeText(text: string): Promise<boolean>;
+    paste(text: string): Promise<boolean>;
+    focus(): Promise<boolean>;
+    /**
+     * 点击节点
+     * @returns 是否点击成功
+     */
+    click(): Promise<boolean>;
+    /**
+     * 长按节点
+     * @returns 是否长按成功
+     */
+    longClick(): Promise<boolean>;
+    /**
+     * 查找第一个可点击的父节点
+     * @returns 可点击的父节点
+     */
+    findFirstParentClickable(): Promise<Node>;
+    /**
+     * 获取节点在屏幕中的边界
+     * @returns 边界对象
+     */
+    getBoundsInScreen(): Promise<Bounds>;
+    /**
+     * 获取节点的所有子节点
+     * @returns 子节点数组
+     */
+    getNodes(): Promise<Node[]>;
+    /**
+     * 获取节点的直接子节点
+     * @returns 子节点数组
+     */
+    getChildren(): Promise<Node[]>;
+    /**
+     * 从JSON字符串创建节点实例
+     * @param json JSON字符串
+     * @returns 节点实例
+     */
+    static fromJSON(json: string): Node;
+    /**
+     * 从普通对象创建节点实例
+     * @param data 对象数据
+     * @returns 节点实例
+     */
+    static from(data: any): Node;
+    /**
+     * JSON.parse的reviver函数，用于将解析的JSON对象转换为Node实例
+     * @param key 属性键
+     * @param value 属性值
+     * @returns 转换后的值
+     */
+    static reviver(key: string, value: any): any;
+    /**
+     * 创建新的节点实例
+     * @param params 节点参数对象
+     * @returns 节点实例
+     */
+    static create(params: {
+        nodeId: string;
+        text: string;
+        des: string;
+        viewId: string;
+        className: string;
+        isScrollable: boolean;
+        isClickable: boolean;
+        isEnabled: boolean;
+        stepId: string | undefined;
+        hintText: string;
+        isCheckable: boolean;
+        isChecked: boolean;
+        isFocusable: boolean;
+        isFocused: boolean;
+        isLongClickable: boolean;
+        isPassword: boolean;
+        isSelected: boolean;
+        isVisibleToUser: boolean;
+        drawingOrder: number;
+        bounds?: Bounds;
+        /** @deprecated 请使用 bounds 替代 */
+        boundsInScreen?: Bounds;
+    }): Node;
+    /**
+     * 从JSON数组创建节点数组
+     * @param array JSON数组
+     * @returns 节点数组
+     */
+    static fromJSONArray(array: Array<any>): Node[];
+}
+
+/**
+ * 节点类
+ * 表示界面上的一个可交互元素，包含元素的属性和可执行的操作
+ */
+
+declare class Node {
+    /**
+     * 节点唯一标识
+     */
+    nodeId: string;
+    /**
+     * 节点文本内容
+     */
+    text: string;
+    /**
+     * 节点描述信息
+     */
+    des: string;
+    /**
+     * 节点视图ID
+     */
+    viewId: string;
+    /**
+     * 节点类名
+     */
+    className: string;
+    /**
+     * 是否可滚动
+     */
+    isScrollable: boolean;
+    /**
+     * 是否可点击
+     */
+    isClickable: boolean;
+    /**
+     * 是否启用
+     */
+    isEnabled: boolean;
+    /**
+     * 所属步骤ID
+     */
+    stepId: string | undefined;
+    /**
+     * 提示文本
+     */
+    hintText: string;
+    /**
+     * 是否可选择
+     */
+    isCheckable: boolean;
+    /**
+     * 是否已选中
+     */
+    isChecked: boolean;
+    /**
+     * 是否可聚焦
+     */
+    isFocusable: boolean;
+    /**
+     * 是否已聚焦
+     */
+    isFocused: boolean;
+    /**
+     * 是否可长按
+     */
+    isLongClickable: boolean;
+    /**
+     * 是否为密码字段
+     */
+    isPassword: boolean;
+    /**
+     * 是否已选中
+     */
+    isSelected: boolean;
+    /**
+     * 是否对用户可见
+     */
+    isVisibleToUser: boolean;
+    /**
+     * 绘制顺序
+     */
+    drawingOrder: number;
+    /**
+     * 节点在屏幕中的边界
+     */
+    bounds: Bounds;
+    /**
+     * 节点在屏幕中的边界
+     * @deprecated 请使用 bounds 字段替代
+     */
+    get boundsInScreen(): Bounds;
+    /**
+     * 构造函数
+     * @param params 节点参数对象
+     */
+    constructor(params: {
+        nodeId: string;
+        text: string;
+        des: string;
+        viewId: string;
+        className: string;
+        isScrollable: boolean;
+        isClickable: boolean;
+        isEnabled: boolean;
+        stepId: string | undefined;
+        hintText: string;
+        isCheckable: boolean;
+        isChecked: boolean;
+        isFocusable: boolean;
+        isFocused: boolean;
+        isLongClickable: boolean;
+        isPassword: boolean;
+        isSelected: boolean;
+        isVisibleToUser: boolean;
+        drawingOrder: number;
+        /** @deprecated 请使用 bounds 替代 */
+        boundsInScreen?: Bounds | any;
+        bounds?: Bounds | any;
+    });
+    get async(): NodeAsync;
+    /**
+     * 查找第一个匹配标签的父节点
+     * @param className 类名
+     * @returns 父节点
+     */
+    findFirstParentByTags(className: string): Node;
+    /**
+     * 对节点执行点击手势
+     * @param offsetX X轴偏移
+     * @param offsetY Y轴偏移
+     * @param switchWindowIntervalDelay 窗口切换延迟
+     * @param clickDuration 点击持续时间
+     * @returns 是否点击成功
+     */
+    clickNodeByGesture({ offsetX, offsetY, switchWindowIntervalDelay, clickDuration, }?: {
+        offsetX?: number;
+        offsetY?: number;
+        switchWindowIntervalDelay?: number;
+        clickDuration?: number;
+    }): Promise<boolean>;
+    /**
+     * 对节点执行双击手势
+     * @param offsetX X轴偏移
+     * @param offsetY Y轴偏移
+     * @param switchWindowIntervalDelay 窗口切换延迟
+     * @param clickDuration 点击持续时间
+     * @param clickInterval 点击间隔
+     * @returns 是否双击成功
+     */
+    doubleClickNodeByGesture({ offsetX, offsetY, switchWindowIntervalDelay, clickDuration, clickInterval, }?: {
+        offsetX?: number;
+        offsetY?: number;
+        switchWindowIntervalDelay?: number;
+        clickDuration?: number;
+        clickInterval?: number;
+    }): Promise<boolean>;
+    longPressNodeByGestureAutoPaste(text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, }?: {
+        matchedPackageName?: string;
+        matchedText?: string;
+        timeoutMillis?: number;
+        longPressDuration?: number;
+    }): Promise<boolean>;
+    /**
+     * 在当前节点范围内通过标签查找节点
+     * @param className 类名
+     * @param filterText 文本过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
+     */
+    findByTags(className: string, { filterText, filterViewId, filterDes, }?: {
+        filterText?: string;
+        filterViewId?: string;
+        filterDes?: string;
+    }): Node[];
+    /**
+     * 在当前节点范围内通过ID查找节点
+     * @param id 节点ID
+     * @param filterClass 类名过滤
+     * @param filterText 文本过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
+     */
+    findById(id: string, { filterClass, filterText, filterDes, }?: {
+        filterClass?: string;
+        filterText?: string;
+        filterDes?: string;
+    }): Node[];
+    /**
+     * 在当前节点范围内通过文本查找节点
+     * @param text 要查找的文本
+     * @param filterClass 类名过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
+     */
+    findByText(text: string, { filterClass, filterViewId, filterDes, }?: {
+        filterClass?: string;
+        filterViewId?: string;
+        filterDes?: string;
+    }): Node[];
+    /**
+     * 向前滚动节点
+     * @returns 是否滚动成功
+     */
+    scrollForward(): boolean;
+    /**
+     * 向后滚动节点
+     * @returns 是否滚动成功
+     */
+    scrollBackward(): boolean;
+    /**
+     * 检查节点是否可见
+     * @param compareNode 比较节点
+     * @param isFullyByCompareNode 是否完全可见
+     * @returns 是否可见
+     */
+    isVisible({ compareNode, isFullyByCompareNode, }?: {
+        compareNode?: Node;
+        isFullyByCompareNode?: boolean;
+    }): boolean;
+    /**
+     * 对节点进行截图
+     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
+     * @returns 截图路径
+     */
+    takeScreenshot(overlayHiddenScreenshotDelayMillis?: number): Promise<string>;
+    /**
+     * 保存节点截图到文件
+     * @param options 截图保存选项
+     * @param options.filePath 文件路径（可选，不提供则自动生成）
+     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认为 "PNG"
+     * @param options.overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)，默认为 250
+     * @returns 保存的文件路径
+     */
+    takeScreenshotToFile(options?: {
+        filePath?: string;
+        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
+        overlayHiddenScreenshotDelayMillis?: number;
+    }): Promise<string>;
+    /**
+     * 设置节点文本
+     * @param text 要设置的文本
+     * @returns 是否设置成功
+     */
+    setNodeText(text: string): boolean;
+    paste(text: string): boolean;
+    focus(): boolean;
+    /**
+     * 点击节点
+     * @returns 是否点击成功
+     */
+    click(): boolean;
+    /**
+     * 长按节点
+     * @returns 是否长按成功
+     */
+    longClick(): boolean;
+    /**
+     * 查找第一个可点击的父节点
+     * @returns 可点击的父节点
+     */
+    findFirstParentClickable(): Node;
+    /**
+     * 获取节点在屏幕中的边界
+     * @returns 边界对象
+     */
+    getBoundsInScreen(): Bounds;
+    /**
+     * 获取节点的所有子节点
+     * @returns 子节点数组
+     */
+    getNodes(): Node[];
+    /**
+     * 获取节点的直接子节点
+     * @returns 子节点数组
+     */
+    getChildren(): Node[];
+    /**
+     * 从JSON字符串创建节点实例
+     * @param json JSON字符串
+     * @returns 节点实例
+     */
+    static fromJSON(json: string): Node;
+    /**
+     * 从普通对象创建节点实例
+     * @param data 对象数据
+     * @returns 节点实例
+     */
+    static from(data: any): Node;
+    /**
+     * JSON.parse的reviver函数，用于将解析的JSON对象转换为Node实例
+     * @param key 属性键
+     * @param value 属性值
+     * @returns 转换后的值
+     */
+    static reviver(key: string, value: any): any;
+    /**
+     * 创建新的节点实例
+     * @param params 节点参数对象
+     * @returns 节点实例
+     */
+    static create(params: {
+        nodeId: string;
+        text: string;
+        des: string;
+        viewId: string;
+        className: string;
+        isScrollable: boolean;
+        isClickable: boolean;
+        isEnabled: boolean;
+        stepId: string | undefined;
+        hintText: string;
+        isCheckable: boolean;
+        isChecked: boolean;
+        isFocusable: boolean;
+        isFocused: boolean;
+        isLongClickable: boolean;
+        isPassword: boolean;
+        isSelected: boolean;
+        isVisibleToUser: boolean;
+        drawingOrder: number;
+        bounds?: Bounds;
+        /** @deprecated 请使用 bounds 替代 */
+        boundsInScreen?: Bounds;
+    }): Node;
+    /**
+     * 从JSON数组创建节点数组
+     * @param array JSON数组
+     * @returns 节点数组
+     */
+    static fromJSONArray(array: Array<any>): Node[];
+}
+
+/**
+ * 步骤执行错误类
+ * 用于携带步骤执行过程中的错误信息和当前步骤对象
+ * 支持传入可选数据：message，data任何类型的数据
+ */
+declare class StepError extends Error {
+    /**
+     * 步骤实现函数名
+     */
+    readonly impl?: string;
+    /**
+     * 步骤标签
+     */
+    readonly tag?: string | undefined;
+    /**
+     * 步骤数据，可以是任何类型
+     */
+    readonly data?: any;
+    /**
+     * 原始错误
+     */
+    readonly originalError?: any;
+    /**
+     * 当前步骤对象
+     */
+    readonly currentStep?: any;
+    constructor(message?: string, data?: any, impl?: string, tag?: string | undefined, originalError?: any, currentStep?: any | undefined);
+}
+/**
+ * 主动停止异常类
+ * 用于表示步骤被主动停止执行
+ */
+declare class StepStopError extends StepError {
+    constructor(message?: string, data?: any);
+}
+
+declare class StepAsync {
+    private step;
+    /**
+     * 构造函数
+     * @param step Step实例
+     */
+    constructor(step: Step);
+    /**
+     * 对单个节点进行截图
+     * @param node 目标节点
+     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
+     * @returns 截图路径
+     */
+    takeScreenshotByNode(node: Node, overlayHiddenScreenshotDelayMillis?: number): Promise<string>;
+    /**
+     * 对多个节点进行截图
+     * @param nodes 目标节点数组
+     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
+     * @returns 截图路径数组
+     */
+    takeScreenshotNodes(nodes: Node[], overlayHiddenScreenshotDelayMillis?: number): Promise<string[]>;
+    /**
+     * 获取所有符合条件的节点
+     * @param filterClass 类名过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @param filterText 文本过滤
+     * @returns 节点数组
+     */
+    getAllNodes({ filterClass, filterViewId, filterDes, filterText, scope, }?: {
+        filterClass?: string;
+        filterViewId?: string;
+        filterDes?: string;
+        filterText?: string;
+        scope?: NodeLookupScope;
+    }): Promise<Node[]>;
+    /**
+     * 启动应用
+     * @param packageName 应用包名
+     * @returns 是否启动成功
+     */
+    launchApp(packageName: string): Promise<boolean>;
+    /**
+     * 获取当前应用包名
+     * @param timeout 超时时间(秒)，默认30秒
+     */
+    getPackageName(timeout?: number): Promise<string>;
+    /**
+     * 获取当前应用包名
+     * @param options.timeout 超时时间(秒)，默认30秒
+     * @param options.scope 节点查找范围（可选）
+     */
+    getPackageName(options: {
+        timeout?: number;
+        scope?: NodeLookupScope;
+    }): Promise<string>;
+    /**
+     * 通过ID查找节点
+     * @param id 节点ID
+     * @param filterClass 类名过滤
+     * @param filterText 文本过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
+     */
+    findById(id: string, { filterClass, filterText, filterDes, scope, }?: {
+        filterClass?: string;
+        filterText?: string;
+        filterDes?: string;
+        scope?: NodeLookupScope;
+    }): Promise<Node[]>;
+    /**
+     * 通过文本查找节点
+     * @param text 要查找的文本
+     * @param filterClass 类名过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
+     */
+    findByText(text: string, { filterClass, filterViewId, filterDes, scope, }?: {
+        filterClass?: string;
+        filterViewId?: string;
+        filterDes?: string;
+        scope?: NodeLookupScope;
+    }): Promise<Node[]>;
+    /**
+     * 通过标签查找节点
+     * @param className 类名
+     * @param filterText 文本过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
+     */
+    findByTags(className: string, { filterText, filterViewId, filterDes, scope, }?: {
+        filterText?: string;
+        filterViewId?: string;
+        filterDes?: string;
+        scope?: NodeLookupScope;
+    }): Promise<Node[]>;
+    /**
+     * 查找所有匹配文本的节点
+     * @param text 要查找的文本
+     * @param timeout 超时时间(秒)，默认30秒
+     */
+    findByTextAllMatch(text: string, timeout?: number): Promise<Node[]>;
+    /**
+     * 查找所有匹配文本的节点
+     * @param text 要查找的文本
+     * @param options.timeout 超时时间(秒)，默认30秒
+     * @param options.scope 节点查找范围（可选）
+     */
+    findByTextAllMatch(text: string, options: {
+        timeout?: number;
+        scope?: NodeLookupScope;
+    }): Promise<Node[]>;
+    /**
+     * 检查是否包含指定文本
+     * @param text 要检查的文本
+     * @returns 是否包含
+     */
+    containsText(text: string): Promise<boolean>;
+    /**
+     * 获取所有文本
+     * @returns 文本数组
+     */
+    getAllText(): Promise<string[]>;
+    /**
+     * 执行点击手势
+     * @param x 横坐标
+     * @param y 纵坐标
+     * @param duration 持续时间(毫秒)
+     * @returns 是否成功
+     */
+    clickByGesture(x: number, y: number, duration: number): Promise<boolean>;
+    longPressGestureAutoPaste(point: {
+        x: number;
+        y: number;
+    }, text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, }?: {
+        matchedPackageName?: string;
+        matchedText?: string;
+        timeoutMillis?: number;
+        longPressDuration?: number;
+    }): Promise<boolean>;
+    getAppInfo(packageName: string): Promise<any>;
+    performLinearGesture(startPoint: {
+        x: number;
+        y: number;
+    }, endPoint: {
+        x: number;
+        y: number;
+    }, { duration }?: {
+        duration?: number;
+    }): Promise<boolean>;
+    /**
+     * 返回操作
+     * @returns 是否成功
+     */
+    back(): Promise<boolean>;
+    /**
+     * 回到主页
+     * @returns 是否成功
+     */
+    home(): Promise<boolean>;
+    /**
+     * 打开通知栏
+     * @returns 是否成功
+     */
+    notifications(): Promise<boolean>;
+    /**
+     * 显示最近应用
+     * @returns 是否成功
+     */
+    recentApps(): Promise<boolean>;
+    /**
+     * 获取屏幕尺寸
+     * @returns 屏幕尺寸对象
+     */
+    getScreenSize(): Promise<any>;
+    /**
+     * 获取应用窗口尺寸
+     * @returns 应用窗口尺寸对象
+     */
+    getAppScreenSize(): Promise<any>;
+}
+
+type StepData = Record<string, any>;
+type StepResult = Step | undefined;
+type StepImpl = (step: Step) => Promise<StepResult>;
+type StepInterceptor = (step: Step) => StepResult | Promise<StepResult>;
+declare class Step {
+    static delayMsDefault: number;
+    static readonly repeatCountInfinite: number;
+    static repeatCountMaxDefault: number;
+    static showLog: boolean;
+    static exceptionRetryCountMaxDefault: number;
+    /**
+     * 判断步骤数据是否有效（非空且为普通对象）
+     */
+    private static isValidStepData;
+    /**
+     * 解析步骤数据：优先使用传入值，否则使用当前值，均无效时返回空对象
+     */
+    private static resolveStepData;
+    /**
+     * 当前执行步骤的ID
+     */
+    private static _stepId;
+    /**
+     * 步骤拦截器列表
+     */
+    private static _interceptors;
+    /**
+     * 步骤异常变量，默认为空
+     */
+    static exception: StepError | undefined;
+    /**
+     * 运行步骤实现
+     * @param impl 步骤实现函数
+     * @param tag 步骤标签
+     * @param data 步骤数据
+     * @param delayMs 步骤延迟时间(毫秒)
+     */
+    static run(impl: StepImpl, { stepId, tag, data, delayMs, exceptionRetryCountMax, }?: {
+        stepId?: string | undefined;
+        tag?: string | undefined;
+        data?: StepData;
+        delayMs?: number;
+        exceptionRetryCountMax?: number;
+    }): Promise<Step | undefined>;
+    /**
+     * 获取当前步骤ID
+     */
+    static get stepId(): string | undefined;
+    /**
+     * 验证步骤ID是否匹配，如果不匹配则表示停止
+     * @param stepId 要验证的步骤ID
+     */
+    static assert(stepId: string | undefined): void;
+    /**
+     * 为节点数组分配步骤ID
+     * @param nodes 节点数组
+     * @param stepId 步骤ID
+     */
+    static assignIdsToNodes(nodes: Node[], stepId: string | undefined): void;
+    /**
+     * 停止当前步骤执行
+     * @param exception 可选的异常对象，如果传入则使用该异常，否则使用默认的StepStopError
+     */
+    static stop(exception?: StepError): void;
+    /**
+     * 添加步骤拦截器
+     * @param interceptor 拦截器函数
+     */
+    static addInterceptor(interceptor: StepInterceptor): void;
+    /**
+     * 移除步骤拦截器
+     * @param interceptor 要移除的拦截器函数
+     * @returns 是否成功删除
+     */
+    static removeInterceptor(interceptor: StepInterceptor): boolean;
+    /**
+     * 按索引移除步骤拦截器
+     * @param index 要移除的拦截器索引
+     * @returns 是否成功删除
+     */
+    static removeInterceptorByIndex(index: number): boolean;
+    /**
+     * 移除所有匹配的步骤拦截器
+     * @param interceptor 要移除的拦截器函数
+     * @returns 删除的拦截器数量
+     */
+    static removeAllInterceptors(interceptor: StepInterceptor): number;
+    /**
+     * 按条件移除步骤拦截器
+     * @param predicate 判断是否删除的条件函数
+     * @returns 删除的拦截器数量
+     */
+    static removeInterceptorByPredicate(predicate: (interceptor: StepInterceptor, index: number) => boolean): number;
+    /**
+     * 清空所有拦截器
+     */
+    static clearInterceptors(): void;
+    /**
+     * 获取所有拦截器
+     * @returns 拦截器数组
+     */
+    static getInterceptors(): StepInterceptor[];
+    /**
+     * 步骤ID
+     */
+    stepId: string;
+    /**
+     * 步骤重复执行次数
+     */
+    repeatCount: number;
+    /**
+     * 步骤重复执行最大次数,默认15次
+     */
+    repeatCountMax: number;
+    /**
+     * 异常重试次数
+     */
+    exceptionRetryCount: number;
+    /**
+     * 异常重试最大次数,默认3次
+     */
+    exceptionRetryCountMax: number;
+    /**
+     * 步骤标签
+     */
+    tag: string | undefined;
+    isEnd: boolean;
+    /**
+     * 步骤数据
+     */
+    data: StepData;
+    /**
+     * 步骤延迟时间(毫秒)
+     */
+    delayMs: number;
+    /**
+     * 步骤实现函数
+     */
+    impl: StepImpl | undefined;
+    /**
+     * 构造函数
+     * @param stepId 步骤ID
+     * @param impl 步骤实现函数
+     * @param tag 步骤标签
+     * @param data 步骤数据
+     * @param delayMs 步骤延迟时间(毫秒)
+     */
+    constructor({ stepId, impl, tag, data, delayMs, repeatCountMax, exceptionRetryCountMax, isEnd, }: {
+        stepId: string;
+        impl: StepImpl | undefined;
+        tag?: string | undefined;
+        data?: StepData;
+        delayMs?: number;
+        repeatCountMax?: number;
+        exceptionRetryCountMax?: number;
+        isEnd?: boolean;
+    });
+    get async(): StepAsync;
+    /**
+     * 创建下一个步骤
+     * @param impl 下一步骤实现函数
+     * @param tag 步骤标签
+     * @param data 步骤数据
+     * @param delayMs 步骤延迟时间(毫秒)
+     * @returns 新的步骤实例
+     */
+    next(impl: StepImpl, { tag, data, delayMs, repeatCountMax, exceptionRetryCountMax, }?: {
+        tag?: string | undefined;
+        data?: StepData;
+        delayMs?: number;
+        repeatCountMax?: number;
+        exceptionRetryCountMax?: number;
+    }): Step;
+    end({ tag, data, delayMs, repeatCountMax, exceptionRetryCountMax, }?: {
+        tag?: string | undefined;
+        data?: StepData;
+        delayMs?: number;
+        repeatCountMax?: number;
+        exceptionRetryCountMax?: number;
+    }): Step;
+    /**
+     * 重复当前步骤
+     * @param stepId 步骤ID
+     * @param tag 步骤标签
+     * @param data 步骤数据
+     * @param delayMs 步骤延迟时间(毫秒)
+     * @returns 当前步骤实例
+     */
+    repeat({ stepId, tag, data, delayMs, repeatCountMax, exceptionRetryCountMax, }?: {
+        stepId?: string;
+        tag?: string | undefined;
+        data?: StepData;
+        delayMs?: number;
+        repeatCountMax?: number;
+        exceptionRetryCountMax?: number;
+    }): Step;
+    /**
+     * 延迟执行
+     * @param ms 延迟时间(毫秒)
+     * @returns Promise
+     */
+    delay(ms: number): Promise<void>;
+    /**
+     * 等待异步方法执行完成
+     * @param method 异步方法
+     * @returns Promise<T>
+     */
+    await<T>(method: () => Promise<T>): Promise<T>;
+    /**
+     * 对单个节点进行截图
+     * @param node 目标节点
+     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
+     * @returns 截图路径
+     */
+    takeScreenshotByNode(node: Node, overlayHiddenScreenshotDelayMillis?: number): Promise<string>;
+    /**
+     * 对多个节点进行截图
+     * @param nodes 目标节点数组
+     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
+     * @returns 截图路径数组
+     */
+    takeScreenshotNodes(nodes: Node[], overlayHiddenScreenshotDelayMillis?: number): Promise<string[]>;
+    /**
+     * 获取所有符合条件的节点
+     * @param filterClass 类名过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @param filterText 文本过滤
+     * @returns 节点数组
+     */
+    getAllNodes({ filterClass, filterViewId, filterDes, filterText, scope, }?: {
+        filterClass?: string;
+        filterViewId?: string;
+        filterDes?: string;
+        filterText?: string;
+        scope?: NodeLookupScope;
+    }): Node[];
+    /**
+     * 启动应用
+     * @param packageName 应用包名
+     * @returns 是否启动成功
+     */
+    launchApp(packageName: string): boolean;
+    /**
+     * 获取当前应用包名
+     * @param options.scope 节点查找范围（可选）
+     */
+    getPackageName(options?: {
+        scope?: NodeLookupScope;
+    }): string;
+    /**
+     * 通过ID查找节点
+     * @param id 节点ID
+     * @param filterClass 类名过滤
+     * @param filterText 文本过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
+     */
+    findById(id: string, { filterClass, filterText, filterDes, scope, }?: {
+        filterClass?: string;
+        filterText?: string;
+        filterDes?: string;
+        scope?: NodeLookupScope;
+    }): Node[];
+    /**
+     * 通过文本查找节点
+     * @param text 要查找的文本
+     * @param filterClass 类名过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
+     */
+    findByText(text: string, { filterClass, filterViewId, filterDes, scope, }?: {
+        filterClass?: string;
+        filterViewId?: string;
+        filterDes?: string;
+        scope?: NodeLookupScope;
+    }): Node[];
+    /**
+     * 通过标签查找节点
+     * @param className 类名
+     * @param filterText 文本过滤
+     * @param filterViewId 视图ID过滤
+     * @param filterDes 描述过滤
+     * @returns 节点数组
+     */
+    findByTags(className: string, { filterText, filterViewId, filterDes, scope, }?: {
+        filterText?: string;
+        filterViewId?: string;
+        filterDes?: string;
+        scope?: NodeLookupScope;
+    }): Node[];
+    /**
+     * 查找所有匹配文本的节点
+     * @param text 要查找的文本
+     * @param options.scope 节点查找范围（可选）
+     */
+    findByTextAllMatch(text: string, { scope }?: {
+        scope?: NodeLookupScope;
+    }): Node[];
+    /**
+     * 检查是否包含指定文本
+     * @param text 要检查的文本
+     * @returns 是否包含
+     */
+    containsText(text: string): boolean;
+    /**
+     * 获取所有文本
+     * @returns 文本数组
+     */
+    getAllText(): string[];
+    /**
+     * 执行点击手势
+     * @param x 横坐标
+     * @param y 纵坐标
+     * @param duration 持续时间(毫秒)
+     * @returns 是否成功
+     */
+    clickByGesture(x: number, y: number, duration: number): Promise<boolean>;
+    longPressGestureAutoPaste(point: {
+        x: number;
+        y: number;
+    }, text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, }?: {
+        matchedPackageName?: string;
+        matchedText?: string;
+        timeoutMillis?: number;
+        longPressDuration?: number;
+    }): Promise<boolean>;
+    getAppInfo(packageName: string): Promise<any>;
+    performLinearGesture(startPoint: {
+        x: number;
+        y: number;
+    }, endPoint: {
+        x: number;
+        y: number;
+    }, { duration }?: {
+        duration?: number;
+    }): Promise<boolean>;
+    /**
+     * 返回操作
+     * @returns 是否成功
+     */
+    back(): boolean;
+    /**
+     * 回到主页
+     * @returns 是否成功
+     */
+    home(): boolean;
+    /**
+     * 打开通知栏
+     * @returns 是否成功
+     */
+    notifications(): boolean;
+    /**
+     * 显示最近应用
+     * @returns 是否成功
+     */
+    recentApps(): boolean;
+    /**
+     * 获取屏幕尺寸
+     * @returns 屏幕尺寸对象
+     */
+    getScreenSize(): any;
+    /**
+     * 获取应用窗口尺寸
+     * @returns 应用窗口尺寸对象
+     */
+    getAppScreenSize(): any;
+}
+
+export { Bounds as B, Node as N, Step as S, type NodeLookupScope as a, NODE_LOOKUP_SCOPE_ACTIVE_WINDOW as b, NODE_LOOKUP_SCOPE_ALL_WINDOWS as c, NodeAsync as d, StepAsync as e, type StepData as f, StepError as g, type StepImpl as h, type StepInterceptor as i, type StepResult as j, StepStopError as k };