assistsx-js 0.1.41 → 0.2.0

package/dist/Node.d.ts

@@ -1,334 +0,0 @@
-/**
- * 节点类
- * 表示界面上的一个可交互元素，包含元素的属性和可执行的操作
- */
-import { Bounds } from "./Bounds";
-import { NodeAsync } from "./NodeAsync";
-export 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[];
-}

package/dist/Node.js

@@ -1,369 +0,0 @@
-/**
- * 节点类
- * 表示界面上的一个可交互元素，包含元素的属性和可执行的操作
- */
-import { Bounds } from "./Bounds";
-import { AssistsX } from "./AssistsX";
-import { AssistsXAsync } from "./AssistsXAsync";
-import { Step } from "./Step";
-import { NodeAsync } from "./NodeAsync";
-// 将接口改造为类
-export class Node {
-    /**
-     * 节点在屏幕中的边界
-     * @deprecated 请使用 bounds 字段替代
-     */
-    get boundsInScreen() {
-        return this.bounds;
-    }
-    /**
-     * 构造函数
-     * @param params 节点参数对象
-     */
-    constructor(params) {
-        var _a;
-        this.nodeId = params.nodeId;
-        this.text = params.text;
-        this.des = params.des;
-        this.viewId = params.viewId;
-        this.className = params.className;
-        this.isScrollable = params.isScrollable;
-        this.isClickable = params.isClickable;
-        this.isEnabled = params.isEnabled;
-        this.stepId = params.stepId;
-        this.hintText = params.hintText;
-        this.isCheckable = params.isCheckable;
-        this.isChecked = params.isChecked;
-        this.isFocusable = params.isFocusable;
-        this.isFocused = params.isFocused;
-        this.isLongClickable = params.isLongClickable;
-        this.isPassword = params.isPassword;
-        this.isSelected = params.isSelected;
-        this.isVisibleToUser = params.isVisibleToUser;
-        this.drawingOrder = params.drawingOrder;
-        // 优先使用 bounds，兼容旧的 boundsInScreen；确保为 Bounds 实例
-        const rawBounds = (_a = params.bounds) !== null && _a !== void 0 ? _a : params.boundsInScreen;
-        this.bounds = rawBounds instanceof Bounds ? rawBounds : Bounds.fromData(rawBounds);
-    }
-    get async() {
-        return new NodeAsync(this);
-    }
-    /**
-     * 查找第一个匹配标签的父节点
-     * @param className 类名
-     * @returns 父节点
-     */
-    findFirstParentByTags(className) {
-        Step.assert(this.stepId);
-        const node = AssistsX.findFirstParentByTags(this, className);
-        Step.assert(this.stepId);
-        return node;
-    }
-    /**
-     * 对节点执行点击手势
-     * @param offsetX X轴偏移
-     * @param offsetY Y轴偏移
-     * @param switchWindowIntervalDelay 窗口切换延迟
-     * @param clickDuration 点击持续时间
-     * @returns 是否点击成功
-     */
-    async clickNodeByGesture({ offsetX, offsetY, switchWindowIntervalDelay, clickDuration, } = {}) {
-        Step.assert(this.stepId);
-        const result = await AssistsX.clickNodeByGesture(this, {
-            offsetX,
-            offsetY,
-            switchWindowIntervalDelay,
-            clickDuration,
-        });
-        Step.assert(this.stepId);
-        return result;
-    }
-    /**
-     * 对节点执行双击手势
-     * @param offsetX X轴偏移
-     * @param offsetY Y轴偏移
-     * @param switchWindowIntervalDelay 窗口切换延迟
-     * @param clickDuration 点击持续时间
-     * @param clickInterval 点击间隔
-     * @returns 是否双击成功
-     */
-    async doubleClickNodeByGesture({ offsetX, offsetY, switchWindowIntervalDelay, clickDuration, clickInterval, } = {}) {
-        Step.assert(this.stepId);
-        const result = await AssistsX.doubleClickNodeByGesture(this, {
-            offsetX,
-            offsetY,
-            switchWindowIntervalDelay,
-            clickDuration,
-            clickInterval,
-        });
-        Step.assert(this.stepId);
-        return result;
-    }
-    async longPressNodeByGestureAutoPaste(text, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, } = { matchedText: "粘贴", timeoutMillis: 1500, longPressDuration: 600 }) {
-        Step.assert(this.stepId);
-        const result = await AssistsX.longPressNodeByGestureAutoPaste(this, text, {
-            matchedPackageName,
-            matchedText,
-            timeoutMillis,
-            longPressDuration,
-        });
-        Step.assert(this.stepId);
-        return result;
-    }
-    /**
-     * 在当前节点范围内通过标签查找节点
-     * @param className 类名
-     * @param filterText 文本过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @returns 节点数组
-     */
-    findByTags(className, { filterText, filterViewId, filterDes, } = {}) {
-        Step.assert(this.stepId);
-        const result = AssistsX.findByTags(className, {
-            filterText,
-            filterViewId,
-            filterDes,
-            node: this,
-        });
-        Step.assignIdsToNodes(result, this.stepId);
-        Step.assert(this.stepId);
-        return result;
-    }
-    /**
-     * 在当前节点范围内通过ID查找节点
-     * @param id 节点ID
-     * @param filterClass 类名过滤
-     * @param filterText 文本过滤
-     * @param filterDes 描述过滤
-     * @returns 节点数组
-     */
-    findById(id, { filterClass, filterText, filterDes, } = {}) {
-        Step.assert(this.stepId);
-        const result = AssistsX.findById(id, {
-            filterClass,
-            filterText,
-            filterDes,
-            node: this,
-        });
-        Step.assignIdsToNodes(result, this.stepId);
-        Step.assert(this.stepId);
-        return result;
-    }
-    /**
-     * 在当前节点范围内通过文本查找节点
-     * @param text 要查找的文本
-     * @param filterClass 类名过滤
-     * @param filterViewId 视图ID过滤
-     * @param filterDes 描述过滤
-     * @returns 节点数组
-     */
-    findByText(text, { filterClass, filterViewId, filterDes, } = {}) {
-        Step.assert(this.stepId);
-        const result = AssistsX.findByText(text, {
-            filterClass,
-            filterViewId,
-            filterDes,
-            node: this,
-        });
-        Step.assignIdsToNodes(result, this.stepId);
-        Step.assert(this.stepId);
-        return result;
-    }
-    /**
-     * 向前滚动节点
-     * @returns 是否滚动成功
-     */
-    scrollForward() {
-        Step.assert(this.stepId);
-        const response = AssistsX.scrollForward(this);
-        Step.assert(this.stepId);
-        return response;
-    }
-    /**
-     * 向后滚动节点
-     * @returns 是否滚动成功
-     */
-    scrollBackward() {
-        Step.assert(this.stepId);
-        const response = AssistsX.scrollBackward(this);
-        Step.assert(this.stepId);
-        return response;
-    }
-    /**
-     * 检查节点是否可见
-     * @param compareNode 比较节点
-     * @param isFullyByCompareNode 是否完全可见
-     * @returns 是否可见
-     */
-    isVisible({ compareNode, isFullyByCompareNode, } = {}) {
-        Step.assert(this.stepId);
-        const response = AssistsX.isVisible(this, {
-            compareNode,
-            isFullyByCompareNode,
-        });
-        Step.assert(this.stepId);
-        return response;
-    }
-    /**
-     * 对节点进行截图
-     * @param overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)
-     * @returns 截图路径
-     */
-    async takeScreenshot(overlayHiddenScreenshotDelayMillis = 250) {
-        Step.assert(this.stepId);
-        const result = await AssistsX.takeScreenshotNodes([this], overlayHiddenScreenshotDelayMillis);
-        Step.assert(this.stepId);
-        return result[0];
-    }
-    /**
-     * 保存节点截图到文件
-     * @param options 截图保存选项
-     * @param options.filePath 文件路径（可选，不提供则自动生成）
-     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认为 "PNG"
-     * @param options.overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)，默认为 250
-     * @returns 保存的文件路径
-     */
-    async takeScreenshotToFile(options = {}) {
-        Step.assert(this.stepId);
-        const result = await AssistsXAsync.takeScreenshotToFile({
-            nodes: [this],
-            ...options,
-        });
-        Step.assert(this.stepId);
-        return result[0];
-    }
-    /**
-     * 设置节点文本
-     * @param text 要设置的文本
-     * @returns 是否设置成功
-     */
-    setNodeText(text) {
-        Step.assert(this.stepId);
-        const result = AssistsX.setNodeText(this, text);
-        Step.assert(this.stepId);
-        return result;
-    }
-    paste(text) {
-        Step.assert(this.stepId);
-        const result = AssistsX.paste(this, text);
-        Step.assert(this.stepId);
-        return result;
-    }
-    focus() {
-        Step.assert(this.stepId);
-        const result = AssistsX.focus(this);
-        Step.assert(this.stepId);
-        return result;
-    }
-    /**
-     * 点击节点
-     * @returns 是否点击成功
-     */
-    click() {
-        Step.assert(this.stepId);
-        const result = AssistsX.click(this);
-        Step.assert(this.stepId);
-        return result;
-    }
-    /**
-     * 长按节点
-     * @returns 是否长按成功
-     */
-    longClick() {
-        Step.assert(this.stepId);
-        const result = AssistsX.longClick(this);
-        Step.assert(this.stepId);
-        return result;
-    }
-    /**
-     * 查找第一个可点击的父节点
-     * @returns 可点击的父节点
-     */
-    findFirstParentClickable() {
-        Step.assert(this.stepId);
-        const result = AssistsX.findFirstParentClickable(this);
-        Step.assert(this.stepId);
-        Step.assignIdsToNodes([result], this.stepId);
-        return result;
-    }
-    /**
-     * 获取节点在屏幕中的边界
-     * @returns 边界对象
-     */
-    getBoundsInScreen() {
-        Step.assert(this.stepId);
-        const result = AssistsX.getBoundsInScreen(this);
-        Step.assert(this.stepId);
-        return result;
-    }
-    /**
-     * 获取节点的所有子节点
-     * @returns 子节点数组
-     */
-    getNodes() {
-        Step.assert(this.stepId);
-        const result = AssistsX.getNodes(this);
-        Step.assert(this.stepId);
-        Step.assignIdsToNodes(result, this.stepId);
-        return result;
-    }
-    /**
-     * 获取节点的直接子节点
-     * @returns 子节点数组
-     */
-    getChildren() {
-        Step.assert(this.stepId);
-        const result = AssistsX.getChildren(this);
-        Step.assert(this.stepId);
-        Step.assignIdsToNodes(result, this.stepId);
-        return result;
-    }
-    /**
-     * 从JSON字符串创建节点实例
-     * @param json JSON字符串
-     * @returns 节点实例
-     */
-    static fromJSON(json) {
-        const data = JSON.parse(json);
-        return new Node(data);
-    }
-    /**
-     * 从普通对象创建节点实例
-     * @param data 对象数据
-     * @returns 节点实例
-     */
-    static from(data) {
-        return new Node(data);
-    }
-    /**
-     * JSON.parse的reviver函数，用于将解析的JSON对象转换为Node实例
-     * @param key 属性键
-     * @param value 属性值
-     * @returns 转换后的值
-     */
-    static reviver(key, value) {
-        return key === "" ? new Node(value) : value;
-    }
-    /**
-     * 创建新的节点实例
-     * @param params 节点参数对象
-     * @returns 节点实例
-     */
-    static create(params) {
-        return new Node(params);
-    }
-    /**
-     * 从JSON数组创建节点数组
-     * @param array JSON数组
-     * @returns 节点数组
-     */
-    static fromJSONArray(array) {
-        // 如果 array 不是数组，抛出详细异常
-        if (!Array.isArray(array)) {
-            throw new Error(`Node.fromJSONArray: Expected array, but got ${typeof array}. ` +
-                `Value: ${JSON.stringify(array)}`);
-        }
-        return array.map((data) => new Node(data));
-    }
-}