@midscene/shared 0.17.4-beta-20250528162713.0 → 0.17.4

package/dist/script/htmlElement.js

@@ -587,6 +587,8 @@ var midscene_element_inspector = (() => {
     setNodeHashCacheListOnWindow: () => setNodeHashCacheListOnWindow,
     traverseTree: () => traverseTree,
     treeToList: () => treeToList,
+    trimAttributes: () => trimAttributes,
+    truncateText: () => truncateText,
     webExtractNodeTree: () => extractTreeNode,
     webExtractNodeTreeAsString: () => extractTreeNodeAsString,
     webExtractTextWithPosition: () => extractTextWithPosition
@@ -615,7 +617,7 @@ var midscene_element_inspector = (() => {
     const tailorAttributes = Object.keys(attributes).reduce(
       (res, currentKey) => {
         const attributeVal = attributes[currentKey];
-        if (currentKey === "style" || currentKey === "src" || currentKey === "htmlTagName" || currentKey === "nodeType") {
+        if (currentKey === "style" || currentKey === "htmlTagName" || currentKey === "nodeType") {
           return res;
         }
         res[currentKey] = truncateText(attributeVal, truncateTextLength);
@@ -626,13 +628,13 @@ var midscene_element_inspector = (() => {
     return tailorAttributes;
   }
   var nodeSizeThreshold = 4;
-  function descriptionOfTree(tree, truncateTextLength, filterNonTextContent = false) {
+  function descriptionOfTree(tree, truncateTextLength, filterNonTextContent = false, visibleOnly = true) {
     const attributesString = (kv) => {
       return Object.entries(kv).map(
         ([key, value]) => `${key}="${truncateText(value, truncateTextLength)}"`
       ).join(" ");
     };
-    function buildContentTree(node, indent = 0) {
+    function buildContentTree(node, indent = 0, visibleOnly2 = true) {
       var _a;
       let before = "";
       let contentWithIndent = "";
@@ -641,13 +643,17 @@ var midscene_element_inspector = (() => {
       const indentStr = "  ".repeat(indent);
       let children = "";
       for (let i = 0; i < (node.children || []).length; i++) {
-        const childContent = buildContentTree(node.children[i], indent + 1);
+        const childContent = buildContentTree(
+          node.children[i],
+          indent + 1,
+          visibleOnly2
+        );
         if (childContent) {
           children += `
 ${childContent}`;
         }
       }
-      if (node.node && node.node.rect.width > nodeSizeThreshold && node.node.rect.height > nodeSizeThreshold && (!filterNonTextContent || filterNonTextContent && node.node.content)) {
+      if (node.node && node.node.rect.width > nodeSizeThreshold && node.node.rect.height > nodeSizeThreshold && (!filterNonTextContent || filterNonTextContent && node.node.content) && (!visibleOnly2 || visibleOnly2 && node.node.isVisible)) {
         emptyNode = false;
         let nodeTypeString;
         if ((_a = node.node.attributes) == null ? void 0 : _a.htmlTagName) {
@@ -685,7 +691,7 @@ ${indentStr}${after}`;
       }
       return "";
     }
-    const result = buildContentTree(tree);
+    const result = buildContentTree(tree, 0, visibleOnly);
     return result.replace(/^\s*\n/gm, "");
   }
   function treeToList(tree) {
@@ -986,7 +992,7 @@ ${indentStr}${after}`;
     });
     return true;
   };
-  function elementRect(el, currentWindow, currentDocument, baseZoom = 1, visibleOnly = true) {
+  function elementRect(el, currentWindow, currentDocument, baseZoom = 1) {
     if (!el) {
       logger(el, "Element is not in the DOM hierarchy");
       return false;
@@ -1010,21 +1016,11 @@ ${indentStr}${after}`;
     if (baseZoom === 1 && isElementCovered(el, rect, currentWindow)) {
       return false;
     }
-    const scrollLeft = currentWindow.pageXOffset || currentDocument.documentElement.scrollLeft;
-    const scrollTop = currentWindow.pageYOffset || currentDocument.documentElement.scrollTop;
-    const viewportWidth = currentWindow.innerWidth || currentDocument.documentElement.clientWidth;
-    const viewportHeight = currentWindow.innerHeight || currentDocument.documentElement.clientHeight;
-    const isPartiallyInViewport = visibleOnly ? isElementPartiallyInViewport(rect, currentWindow, currentDocument) : true;
-    if (!isPartiallyInViewport) {
-      logger(el, "Element is completely outside the viewport", {
-        rect,
-        viewportHeight,
-        viewportWidth,
-        scrollTop,
-        scrollLeft
-      });
-      return false;
-    }
+    const isVisible = isElementPartiallyInViewport(
+      rect,
+      currentWindow,
+      currentDocument
+    );
     let parent = el;
     const parentUntilNonStatic = (currentNode) => {
       let parent2 = currentNode == null ? void 0 : currentNode.parentElement;
@@ -1068,7 +1064,8 @@ ${indentStr}${after}`;
       top: Math.round(rect.top),
       width: Math.round(rect.width),
       height: Math.round(rect.height),
-      zoom: rect.zoom
+      zoom: rect.zoom,
+      isVisible
     };
   }
   function getNodeAttributes(node, currentWindow) {
@@ -1137,26 +1134,21 @@ ${indentStr}${after}`;
     let tagName = "";
     if (node instanceof HTMLElement) {
       tagName = node.tagName.toLowerCase();
-    }
-    const parentElement = node.parentElement;
-    if (parentElement && parentElement instanceof HTMLElement) {
-      tagName = parentElement.tagName.toLowerCase();
+    } else {
+      const parentElement = node.parentElement;
+      if (parentElement && parentElement instanceof HTMLElement) {
+        tagName = parentElement.tagName.toLowerCase();
+      }
     }
     return tagName ? `<${tagName}>` : "";
   }
-  function collectElementInfo(node, currentWindow, currentDocument, baseZoom = 1, basePoint = { left: 0, top: 0 }, visibleOnly = true) {
+  function collectElementInfo(node, currentWindow, currentDocument, baseZoom = 1, basePoint = { left: 0, top: 0 }) {
     var _a;
-    const rect = elementRect(
-      node,
-      currentWindow,
-      currentDocument,
-      baseZoom,
-      visibleOnly
-    );
+    const rect = elementRect(node, currentWindow, currentDocument, baseZoom);
     if (!rect) {
       return null;
     }
-    if (visibleOnly && (rect.width < CONTAINER_MINI_WIDTH || rect.height < CONTAINER_MINI_HEIGHT)) {
+    if (rect.width < CONTAINER_MINI_WIDTH || rect.height < CONTAINER_MINI_HEIGHT) {
       return null;
     }
     if (basePoint.left !== 0 || basePoint.top !== 0) {
@@ -1195,7 +1187,8 @@ ${indentStr}${after}`;
           Math.round(rect.left + rect.width / 2),
           Math.round(rect.top + rect.height / 2)
         ],
-        zoom: rect.zoom
+        zoom: rect.zoom,
+        isVisible: rect.isVisible
       };
       return elementInfo;
     }
@@ -1204,8 +1197,7 @@ ${indentStr}${after}`;
         node,
         currentWindow,
         currentDocument,
-        baseZoom,
-        visibleOnly
+        baseZoom
       );
       if (!rect2) {
         return null;
@@ -1231,7 +1223,8 @@ ${indentStr}${after}`;
           Math.round(rect2.left + rect2.width / 2),
           Math.round(rect2.top + rect2.height / 2)
         ],
-        zoom: rect2.zoom
+        zoom: rect2.zoom,
+        isVisible: rect2.isVisible
       };
       return elementInfo;
     }
@@ -1257,7 +1250,8 @@ ${indentStr}${after}`;
           Math.round(rect.left + rect.width / 2),
           Math.round(rect.top + rect.height / 2)
         ],
-        zoom: rect.zoom
+        zoom: rect.zoom,
+        isVisible: rect.isVisible
       };
       return elementInfo;
     }
@@ -1289,7 +1283,8 @@ ${indentStr}${after}`;
         ],
         content: text,
         rect,
-        zoom: rect.zoom
+        zoom: rect.zoom,
+        isVisible: rect.isVisible
       };
       return elementInfo;
     }
@@ -1315,7 +1310,8 @@ ${indentStr}${after}`;
           Math.round(rect.left + rect.width / 2),
           Math.round(rect.top + rect.height / 2)
         ],
-        zoom: rect.zoom
+        zoom: rect.zoom,
+        isVisible: rect.isVisible
       };
       return elementInfo;
     }
@@ -1339,7 +1335,8 @@ ${indentStr}${after}`;
           Math.round(rect.left + rect.width / 2),
           Math.round(rect.top + rect.height / 2)
         ],
-        zoom: rect.zoom
+        zoom: rect.zoom,
+        isVisible: rect.isVisible
       };
       return elementInfo;
     }
@@ -1359,9 +1356,9 @@ ${indentStr}${after}`;
     dfsTopChildren({ children: elementNode.children, node: elementNode.node });
     return elementInfoArray;
   }
-  function extractTreeNodeAsString(initNode, debugMode2 = false) {
+  function extractTreeNodeAsString(initNode, visibleOnly = false, debugMode2 = false) {
     const elementNode = extractTreeNode(initNode, debugMode2);
-    return descriptionOfTree(elementNode);
+    return descriptionOfTree(elementNode, void 0, false, visibleOnly);
   }
   function extractTreeNode(initNode, debugMode2 = false) {
     setDebugMode(debugMode2);
@@ -1392,7 +1389,7 @@ ${indentStr}${after}`;
         node: elementInfo,
         children: []
       };
-      if ((elementInfo == null ? void 0 : elementInfo.nodeType) === "BUTTON Node" /* BUTTON */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "IMG Node" /* IMG */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "TEXT Node" /* TEXT */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "Anchor Node" /* A */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "FORM_ITEM Node" /* FORM_ITEM */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "CONTAINER Node" /* CONTAINER */) {
+      if ((elementInfo == null ? void 0 : elementInfo.nodeType) === "BUTTON Node" /* BUTTON */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "IMG Node" /* IMG */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "TEXT Node" /* TEXT */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "FORM_ITEM Node" /* FORM_ITEM */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "CONTAINER Node" /* CONTAINER */) {
         return nodeInfo;
       }
       const rect = getRect(node, baseZoom, currentWindow);
@@ -1447,14 +1444,8 @@ ${indentStr}${after}`;
       children: topChildren
     };
   }
-  function mergeElementAndChildrenRects(node, currentWindow, currentDocument, baseZoom = 1, visibleOnly = true) {
-    const selfRect = elementRect(
-      node,
-      currentWindow,
-      currentDocument,
-      baseZoom,
-      visibleOnly
-    );
+  function mergeElementAndChildrenRects(node, currentWindow, currentDocument, baseZoom = 1) {
+    const selfRect = elementRect(node, currentWindow, currentDocument, baseZoom);
     if (!selfRect)
       return null;
     let minLeft = selfRect.left;
@@ -1465,13 +1456,7 @@ ${indentStr}${after}`;
       for (let i = 0; i < child.childNodes.length; i++) {
         const sub = child.childNodes[i];
         if (sub.nodeType === 1) {
-          const rect = elementRect(
-            sub,
-            currentWindow,
-            currentDocument,
-            baseZoom,
-            visibleOnly
-          );
+          const rect = elementRect(sub, currentWindow, currentDocument, baseZoom);
           if (rect) {
             minLeft = Math.min(minLeft, rect.left);
             minTop = Math.min(minTop, rect.top);
@@ -1588,17 +1573,10 @@ ${indentStr}${after}`;
         node.scrollIntoView({ behavior: "instant", block: "center" });
       }
     }
-    return collectElementInfo(
-      node,
-      window,
-      document,
-      1,
-      {
-        left: 0,
-        top: 0
-      },
-      false
-    );
+    return collectElementInfo(node, window, document, 1, {
+      left: 0,
+      top: 0
+    });
   }
   return __toCommonJS(extractor_exports);
 })();

package/dist/script/htmlElementDebug.js

@@ -825,7 +825,7 @@ var midscene_element_inspector = (() => {
     });
     return true;
   };
-  function elementRect(el, currentWindow, currentDocument, baseZoom = 1, visibleOnly = true) {
+  function elementRect(el, currentWindow, currentDocument, baseZoom = 1) {
     if (!el) {
       logger(el, "Element is not in the DOM hierarchy");
       return false;
@@ -849,21 +849,11 @@ var midscene_element_inspector = (() => {
     if (baseZoom === 1 && isElementCovered(el, rect, currentWindow)) {
       return false;
     }
-    const scrollLeft = currentWindow.pageXOffset || currentDocument.documentElement.scrollLeft;
-    const scrollTop = currentWindow.pageYOffset || currentDocument.documentElement.scrollTop;
-    const viewportWidth = currentWindow.innerWidth || currentDocument.documentElement.clientWidth;
-    const viewportHeight = currentWindow.innerHeight || currentDocument.documentElement.clientHeight;
-    const isPartiallyInViewport = visibleOnly ? isElementPartiallyInViewport(rect, currentWindow, currentDocument) : true;
-    if (!isPartiallyInViewport) {
-      logger(el, "Element is completely outside the viewport", {
-        rect,
-        viewportHeight,
-        viewportWidth,
-        scrollTop,
-        scrollLeft
-      });
-      return false;
-    }
+    const isVisible = isElementPartiallyInViewport(
+      rect,
+      currentWindow,
+      currentDocument
+    );
     let parent = el;
     const parentUntilNonStatic = (currentNode) => {
       let parent2 = currentNode == null ? void 0 : currentNode.parentElement;
@@ -907,7 +897,8 @@ var midscene_element_inspector = (() => {
       top: Math.round(rect.top),
       width: Math.round(rect.width),
       height: Math.round(rect.height),
-      zoom: rect.zoom
+      zoom: rect.zoom,
+      isVisible
     };
   }
   function getNodeAttributes(node, currentWindow) {
@@ -986,26 +977,21 @@ var midscene_element_inspector = (() => {
     let tagName = "";
     if (node instanceof HTMLElement) {
       tagName = node.tagName.toLowerCase();
-    }
-    const parentElement = node.parentElement;
-    if (parentElement && parentElement instanceof HTMLElement) {
-      tagName = parentElement.tagName.toLowerCase();
+    } else {
+      const parentElement = node.parentElement;
+      if (parentElement && parentElement instanceof HTMLElement) {
+        tagName = parentElement.tagName.toLowerCase();
+      }
     }
     return tagName ? `<${tagName}>` : "";
   }
-  function collectElementInfo(node, currentWindow, currentDocument, baseZoom = 1, basePoint = { left: 0, top: 0 }, visibleOnly = true) {
+  function collectElementInfo(node, currentWindow, currentDocument, baseZoom = 1, basePoint = { left: 0, top: 0 }) {
     var _a;
-    const rect = elementRect(
-      node,
-      currentWindow,
-      currentDocument,
-      baseZoom,
-      visibleOnly
-    );
+    const rect = elementRect(node, currentWindow, currentDocument, baseZoom);
     if (!rect) {
       return null;
     }
-    if (visibleOnly && (rect.width < CONTAINER_MINI_WIDTH || rect.height < CONTAINER_MINI_HEIGHT)) {
+    if (rect.width < CONTAINER_MINI_WIDTH || rect.height < CONTAINER_MINI_HEIGHT) {
       return null;
     }
     if (basePoint.left !== 0 || basePoint.top !== 0) {
@@ -1044,7 +1030,8 @@ var midscene_element_inspector = (() => {
           Math.round(rect.left + rect.width / 2),
           Math.round(rect.top + rect.height / 2)
         ],
-        zoom: rect.zoom
+        zoom: rect.zoom,
+        isVisible: rect.isVisible
       };
       return elementInfo;
     }
@@ -1053,8 +1040,7 @@ var midscene_element_inspector = (() => {
         node,
         currentWindow,
         currentDocument,
-        baseZoom,
-        visibleOnly
+        baseZoom
       );
       if (!rect2) {
         return null;
@@ -1080,7 +1066,8 @@ var midscene_element_inspector = (() => {
           Math.round(rect2.left + rect2.width / 2),
           Math.round(rect2.top + rect2.height / 2)
         ],
-        zoom: rect2.zoom
+        zoom: rect2.zoom,
+        isVisible: rect2.isVisible
       };
       return elementInfo;
     }
@@ -1106,7 +1093,8 @@ var midscene_element_inspector = (() => {
           Math.round(rect.left + rect.width / 2),
           Math.round(rect.top + rect.height / 2)
         ],
-        zoom: rect.zoom
+        zoom: rect.zoom,
+        isVisible: rect.isVisible
       };
       return elementInfo;
     }
@@ -1138,7 +1126,8 @@ var midscene_element_inspector = (() => {
         ],
         content: text,
         rect,
-        zoom: rect.zoom
+        zoom: rect.zoom,
+        isVisible: rect.isVisible
       };
       return elementInfo;
     }
@@ -1164,7 +1153,8 @@ var midscene_element_inspector = (() => {
           Math.round(rect.left + rect.width / 2),
           Math.round(rect.top + rect.height / 2)
         ],
-        zoom: rect.zoom
+        zoom: rect.zoom,
+        isVisible: rect.isVisible
       };
       return elementInfo;
     }
@@ -1188,7 +1178,8 @@ var midscene_element_inspector = (() => {
           Math.round(rect.left + rect.width / 2),
           Math.round(rect.top + rect.height / 2)
         ],
-        zoom: rect.zoom
+        zoom: rect.zoom,
+        isVisible: rect.isVisible
       };
       return elementInfo;
     }
@@ -1237,7 +1228,7 @@ var midscene_element_inspector = (() => {
         node: elementInfo,
         children: []
       };
-      if ((elementInfo == null ? void 0 : elementInfo.nodeType) === "BUTTON Node" /* BUTTON */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "IMG Node" /* IMG */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "TEXT Node" /* TEXT */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "Anchor Node" /* A */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "FORM_ITEM Node" /* FORM_ITEM */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "CONTAINER Node" /* CONTAINER */) {
+      if ((elementInfo == null ? void 0 : elementInfo.nodeType) === "BUTTON Node" /* BUTTON */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "IMG Node" /* IMG */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "TEXT Node" /* TEXT */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "FORM_ITEM Node" /* FORM_ITEM */ || (elementInfo == null ? void 0 : elementInfo.nodeType) === "CONTAINER Node" /* CONTAINER */) {
         return nodeInfo;
       }
       const rect = getRect(node, baseZoom, currentWindow);
@@ -1292,14 +1283,8 @@ var midscene_element_inspector = (() => {
       children: topChildren
     };
   }
-  function mergeElementAndChildrenRects(node, currentWindow, currentDocument, baseZoom = 1, visibleOnly = true) {
-    const selfRect = elementRect(
-      node,
-      currentWindow,
-      currentDocument,
-      baseZoom,
-      visibleOnly
-    );
+  function mergeElementAndChildrenRects(node, currentWindow, currentDocument, baseZoom = 1) {
+    const selfRect = elementRect(node, currentWindow, currentDocument, baseZoom);
     if (!selfRect)
       return null;
     let minLeft = selfRect.left;
@@ -1310,13 +1295,7 @@ var midscene_element_inspector = (() => {
       for (let i = 0; i < child.childNodes.length; i++) {
         const sub = child.childNodes[i];
         if (sub.nodeType === 1) {
-          const rect = elementRect(
-            sub,
-            currentWindow,
-            currentDocument,
-            baseZoom,
-            visibleOnly
-          );
+          const rect = elementRect(sub, currentWindow, currentDocument, baseZoom);
           if (rect) {
             minLeft = Math.min(minLeft, rect.left);
             minTop = Math.min(minTop, rect.top);

package/dist/types/extractor.d.ts

@@ -1,2 +1,2 @@
 import './constants.js';
-export { E as ElementInfo, a as ElementNode, d as descriptionOfTree, k as generateElementByPosition, j as getElementInfoByXpath, g as getNodeFromCacheList, i as getNodeInfoByXpath, h as getXpathsById, s as setNodeHashCacheListOnWindow, t as traverseTree, b as treeToList, c as webExtractNodeTree, f as webExtractNodeTreeAsString, e as webExtractTextWithPosition } from './index-113807ee.js';
+export { E as ElementInfo, a as ElementNode, d as descriptionOfTree, m as generateElementByPosition, l as getElementInfoByXpath, i as getNodeFromCacheList, k as getNodeInfoByXpath, j as getXpathsById, s as setNodeHashCacheListOnWindow, t as traverseTree, b as treeToList, e as trimAttributes, c as truncateText, g as webExtractNodeTree, h as webExtractNodeTreeAsString, f as webExtractTextWithPosition } from './index-a171e36c.js';

package/dist/types/img.d.ts

@@ -1,6 +1,6 @@
 import { Buffer } from 'node:buffer';
 import Jimp from 'jimp';
-import { R as Rect, B as BaseElement } from './index-113807ee.js';
+import { R as Rect, B as BaseElement } from './index-a171e36c.js';
 import './constants.js';
 
 interface Size {

package/dist/types/{index-113807ee.d.ts → index-a171e36c.d.ts}

@@ -1,6 +1,11 @@
 import { NodeType } from './constants.js';
 
-declare function descriptionOfTree<ElementType extends BaseElement = BaseElement>(tree: ElementTreeNode<ElementType>, truncateTextLength?: number, filterNonTextContent?: boolean): string;
+declare function truncateText(text: string | number | object | undefined, maxLength?: number): string;
+declare function trimAttributes(attributes: Record<string, any>, truncateTextLength?: number): {
+    [key: string]: string;
+    nodeType: NodeType;
+};
+declare function descriptionOfTree<ElementType extends BaseElement = BaseElement>(tree: ElementTreeNode<ElementType>, truncateTextLength?: number, filterNonTextContent?: boolean, visibleOnly?: boolean): string;
 declare function treeToList<T extends BaseElement>(tree: ElementTreeNode<T>): T[];
 declare function traverseTree<T extends BaseElement, ReturnNodeType extends BaseElement>(tree: ElementTreeNode<T>, onNode: (node: T) => ReturnNodeType): ElementTreeNode<ReturnNodeType>;
 
@@ -9,7 +14,7 @@ interface WebElementNode {
     children: WebElementNode[];
 }
 declare function extractTextWithPosition(initNode: globalThis.Node, debugMode?: boolean): WebElementInfo[];
-declare function extractTreeNodeAsString(initNode: globalThis.Node, debugMode?: boolean): string;
+declare function extractTreeNodeAsString(initNode: globalThis.Node, visibleOnly?: boolean, debugMode?: boolean): string;
 declare function extractTreeNode(initNode: globalThis.Node, debugMode?: boolean): WebElementNode;
 
 declare function setNodeHashCacheListOnWindow(): void;
@@ -56,6 +61,7 @@ interface ElementInfo {
         height: number;
     };
     center: [number, number];
+    isVisible: boolean;
 }
 interface ElementNode {
     node: ElementInfo | null;
@@ -85,6 +91,8 @@ declare abstract class BaseElement {
     abstract rect: Rect;
     abstract center: [number, number];
     abstract locator?: string;
+    abstract xpaths?: string[];
+    abstract isVisible: boolean;
 }
 interface ElementTreeNode<ElementType extends BaseElement = BaseElement> {
     node: ElementType | null;
@@ -94,4 +102,4 @@ interface WebElementInfo extends ElementInfo {
     zoom: number;
 }
 
-export { BaseElement as B, type ElementInfo as E, type Point as P, type Rect as R, type Size as S, type WebElementInfo as W, type ElementNode as a, treeToList as b, extractTreeNode as c, descriptionOfTree as d, extractTextWithPosition as e, extractTreeNodeAsString as f, getNodeFromCacheList as g, getXpathsById as h, getNodeInfoByXpath as i, getElementInfoByXpath as j, generateElementByPosition as k, type ElementTreeNode as l, setNodeHashCacheListOnWindow as s, traverseTree as t };
+export { BaseElement as B, type ElementInfo as E, type Point as P, type Rect as R, type Size as S, type WebElementInfo as W, type ElementNode as a, treeToList as b, truncateText as c, descriptionOfTree as d, trimAttributes as e, extractTextWithPosition as f, extractTreeNode as g, extractTreeNodeAsString as h, getNodeFromCacheList as i, getXpathsById as j, getNodeInfoByXpath as k, getElementInfoByXpath as l, generateElementByPosition as m, type ElementTreeNode as n, setNodeHashCacheListOnWindow as s, traverseTree as t };

package/dist/types/types.d.ts

@@ -1,2 +1,2 @@
 import './constants.js';
-export { B as BaseElement, l as ElementTreeNode, P as Point, R as Rect, S as Size, W as WebElementInfo } from './index-113807ee.js';
+export { B as BaseElement, n as ElementTreeNode, P as Point, R as Rect, S as Size, W as WebElementInfo } from './index-a171e36c.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/shared",
-  "version": "0.17.4-beta-20250528162713.0",
+  "version": "0.17.4",
   "repository": "https://github.com/web-infra-dev/midscene",
   "homepage": "https://midscenejs.com/",
   "types": "./dist/types/index.d.ts",
@@ -101,7 +101,6 @@
     "new": "modern new",
     "upgrade": "modern upgrade",
     "test": "vitest --run",
-    "test:u": "vitest --run -u",
-    "test:ai": "AITEST=true npm run test"
+    "test:u": "vitest --run -u"
   }
 }

package/src/extractor/index.ts

@@ -14,6 +14,7 @@ export interface ElementInfo {
   content: string;
   rect: { left: number; top: number; width: number; height: number };
   center: [number, number];
+  isVisible: boolean;
 }
 
 export interface ElementNode {
@@ -21,7 +22,13 @@ export interface ElementNode {
   children: ElementNode[];
 }
 
-export { descriptionOfTree, traverseTree, treeToList } from './tree';
+export {
+  descriptionOfTree,
+  traverseTree,
+  treeToList,
+  truncateText,
+  trimAttributes,
+} from './tree';
 
 export { extractTextWithPosition as webExtractTextWithPosition } from './web-extractor';
 

package/src/extractor/locator.ts

@@ -133,15 +133,8 @@ export function getElementInfoByXpath(xpath: string): ElementInfo | null {
     }
   }
 
-  return collectElementInfo(
-    node,
-    window,
-    document,
-    1,
-    {
-      left: 0,
-      top: 0,
-    },
-    false,
-  );
+  return collectElementInfo(node, window, document, 1, {
+    left: 0,
+    top: 0,
+  });
 }

package/src/extractor/tree.ts

@@ -36,7 +36,6 @@ export function trimAttributes(
       const attributeVal = (attributes as any)[currentKey];
       if (
         currentKey === 'style' ||
-        currentKey === 'src' ||
         currentKey === 'htmlTagName' ||
         currentKey === 'nodeType'
       ) {
@@ -58,6 +57,7 @@ export function descriptionOfTree<
   tree: ElementTreeNode<ElementType>,
   truncateTextLength?: number,
   filterNonTextContent = false,
+  visibleOnly = true,
 ) {
   const attributesString = (kv: Record<string, any>) => {
     return Object.entries(kv)
@@ -70,6 +70,7 @@ export function descriptionOfTree<
   function buildContentTree(
     node: ElementTreeNode<ElementType>,
     indent = 0,
+    visibleOnly = true,
   ): string {
     let before = '';
     let contentWithIndent = '';
@@ -79,7 +80,11 @@ export function descriptionOfTree<
 
     let children = '';
     for (let i = 0; i < (node.children || []).length; i++) {
-      const childContent = buildContentTree(node.children[i], indent + 1);
+      const childContent = buildContentTree(
+        node.children[i],
+        indent + 1,
+        visibleOnly,
+      );
       if (childContent) {
         children += `\n${childContent}`;
       }
@@ -89,7 +94,8 @@ export function descriptionOfTree<
       node.node &&
       node.node.rect.width > nodeSizeThreshold &&
       node.node.rect.height > nodeSizeThreshold &&
-      (!filterNonTextContent || (filterNonTextContent && node.node.content))
+      (!filterNonTextContent || (filterNonTextContent && node.node.content)) &&
+      (!visibleOnly || (visibleOnly && node.node.isVisible))
     ) {
       emptyNode = false;
       let nodeTypeString: string;
@@ -133,7 +139,7 @@ export function descriptionOfTree<
     return '';
   }
 
-  const result = buildContentTree(tree);
+  const result = buildContentTree(tree, 0, visibleOnly);
   return result.replace(/^\s*\n/gm, '');
 }