@xiuchang-midscene/shared 2.0.2

package/dist/es/extractor/locator.mjs.bak

@@ -0,0 +1,250 @@
+import { isSvgElement } from "./dom-util.mjs";
+import { getNodeFromCacheList, getRect, isElementPartiallyInViewport, logger } from "./util.mjs";
+import { collectElementInfo } from "./web-extractor.mjs";
+const SUB_XPATH_SEPARATOR = '|>>|';
+function parseCSSZoom(style) {
+    return Number.parseFloat(style.zoom ?? '1') || 1;
+}
+function calculateIframeOffset(nodeOwnerDoc, rootDoc) {
+    let leftOffset = 0;
+    let topOffset = 0;
+    let iterDoc = nodeOwnerDoc;
+    while(iterDoc && iterDoc !== rootDoc)try {
+        const frameElement = iterDoc.defaultView?.frameElement;
+        if (!frameElement) break;
+        const rect = frameElement.getBoundingClientRect();
+        const parentWin = iterDoc.defaultView?.parent;
+        let borderLeft = 0;
+        let borderTop = 0;
+        let zoom = 1;
+        try {
+            if (parentWin) {
+                const style = parentWin.getComputedStyle(frameElement);
+                borderLeft = Number.parseFloat(style.borderLeftWidth) || 0;
+                borderTop = Number.parseFloat(style.borderTopWidth) || 0;
+                zoom = parseCSSZoom(style);
+            }
+        } catch  {}
+        leftOffset = leftOffset / zoom + rect.left + borderLeft;
+        topOffset = topOffset / zoom + rect.top + borderTop;
+        iterDoc = frameElement.ownerDocument;
+    } catch  {
+        break;
+    }
+    return {
+        left: leftOffset,
+        top: topOffset
+    };
+}
+function translatePointToIframeCoordinates(point, iframeElement, parentWindow) {
+    const rect = iframeElement.getBoundingClientRect();
+    const style = parentWindow.getComputedStyle(iframeElement);
+    const clientLeft = iframeElement.clientLeft;
+    const clientTop = iframeElement.clientTop;
+    const paddingLeft = Number.parseFloat(style.paddingLeft) || 0;
+    const paddingTop = Number.parseFloat(style.paddingTop) || 0;
+    const zoom = parseCSSZoom(style);
+    return {
+        left: (point.left - rect.left - clientLeft - paddingLeft) / zoom,
+        top: (point.top - rect.top - clientTop - paddingTop) / zoom
+    };
+}
+const getElementXpathIndex = (element)=>{
+    let index = 1;
+    let prev = element.previousElementSibling;
+    while(prev){
+        if (prev.nodeName.toLowerCase() === element.nodeName.toLowerCase()) index++;
+        prev = prev.previousElementSibling;
+    }
+    return index;
+};
+const normalizeXpathText = (text)=>{
+    if ('string' != typeof text) return '';
+    return text.replace(/\s+/g, ' ').trim();
+};
+const buildCurrentElementXpath = (element, isOrderSensitive, isLeafElement, limitToCurrentDocument = false)=>{
+    const parentPath = element.parentNode ? getElementXpath(element.parentNode, isOrderSensitive, false, limitToCurrentDocument) : '';
+    const prefix = parentPath ? `${parentPath}/` : '/';
+    const tagName = element.nodeName.toLowerCase();
+    const textContent = element.textContent?.trim();
+    const isSVGNamespace = 'http://www.w3.org/2000/svg' === element.namespaceURI;
+    const tagSelector = isSVGNamespace ? `*[name()="${tagName}"]` : tagName;
+    if (isOrderSensitive) {
+        const index = getElementXpathIndex(element);
+        return `${prefix}${tagSelector}[${index}]`;
+    }
+    if (isLeafElement && textContent) return `${prefix}${tagSelector}[normalize-space()="${normalizeXpathText(textContent)}"]`;
+    const index = getElementXpathIndex(element);
+    return `${prefix}${tagSelector}[${index}]`;
+};
+const getElementXpath = (element, isOrderSensitive = false, isLeafElement = false, limitToCurrentDocument = false)=>{
+    if (element.nodeType === Node.TEXT_NODE) {
+        const parentNode = element.parentNode;
+        if (parentNode && parentNode.nodeType === Node.ELEMENT_NODE) {
+            const parentXPath = getElementXpath(parentNode, isOrderSensitive, true, limitToCurrentDocument);
+            const textContent = element.textContent?.trim();
+            if (textContent) return `${parentXPath}/text()[normalize-space()="${normalizeXpathText(textContent)}"]`;
+            return `${parentXPath}/text()`;
+        }
+        return '';
+    }
+    if (element.nodeType !== Node.ELEMENT_NODE) return '';
+    const el = element;
+    try {
+        const nodeName = el.nodeName.toLowerCase();
+        if (el === el.ownerDocument?.documentElement || 'html' === nodeName) {
+            if (!limitToCurrentDocument) {
+                const frameElement = el.ownerDocument?.defaultView?.frameElement;
+                if (frameElement) {
+                    const framePath = getElementXpath(frameElement, isOrderSensitive, false, limitToCurrentDocument);
+                    return `${framePath}${SUB_XPATH_SEPARATOR}/html`;
+                }
+            }
+            return '/html';
+        }
+        if (el === el.ownerDocument?.body || 'body' === nodeName) {
+            if (!limitToCurrentDocument) {
+                const frameElement = el.ownerDocument?.defaultView?.frameElement;
+                if (frameElement) {
+                    const framePath = getElementXpath(frameElement, isOrderSensitive, false, limitToCurrentDocument);
+                    return `${framePath}${SUB_XPATH_SEPARATOR}/html/body`;
+                }
+            }
+            return '/html/body';
+        }
+    } catch (error) {
+        logger('[midscene:locator] ownerDocument access failed:', error);
+        if ('html' === el.nodeName.toLowerCase()) return '/html';
+        if ('body' === el.nodeName.toLowerCase()) return '/html/body';
+    }
+    if (isSvgElement(el)) {
+        const tagName = el.nodeName.toLowerCase();
+        if ('svg' === tagName) return buildCurrentElementXpath(el, isOrderSensitive, isLeafElement, limitToCurrentDocument);
+        let parent = el.parentNode;
+        while(parent && parent.nodeType === Node.ELEMENT_NODE){
+            const parentEl = parent;
+            if (!isSvgElement(parentEl)) return getElementXpath(parentEl, isOrderSensitive, isLeafElement, limitToCurrentDocument);
+            const parentTag = parentEl.nodeName.toLowerCase();
+            if ('svg' === parentTag) return getElementXpath(parentEl, isOrderSensitive, isLeafElement, limitToCurrentDocument);
+            parent = parent.parentNode;
+        }
+        const fallbackParent = el.parentNode;
+        if (fallbackParent && fallbackParent.nodeType === Node.ELEMENT_NODE) return getElementXpath(fallbackParent, isOrderSensitive, isLeafElement, limitToCurrentDocument);
+        return '';
+    }
+    return buildCurrentElementXpath(el, isOrderSensitive, isLeafElement, limitToCurrentDocument);
+};
+function getXpathsById(id) {
+    const node = getNodeFromCacheList(id);
+    if (!node) return null;
+    const fullXPath = getElementXpath(node, false, true, true);
+    return [
+        fullXPath
+    ];
+}
+function getXpathsByPoint(point, isOrderSensitive) {
+    let currentWindow = 'undefined' != typeof window ? window : void 0;
+    let currentDocument = 'undefined' != typeof document ? document : void 0;
+    let { left, top } = point;
+    let depth = 0;
+    const MAX_DEPTH = 10;
+    let xpathPrefix = '';
+    let lastFoundElement = null;
+    while(depth < MAX_DEPTH){
+        depth++;
+        const element = currentDocument.elementFromPoint(left, top);
+        if (!element) {
+            if (lastFoundElement) {
+                const fullXPath = getElementXpath(lastFoundElement, isOrderSensitive, true, true);
+                return [
+                    xpathPrefix + fullXPath
+                ];
+            }
+            return null;
+        }
+        lastFoundElement = element;
+        const tag = element.tagName.toLowerCase();
+        if ('iframe' === tag || 'frame' === tag) try {
+            const contentWindow = element.contentWindow;
+            const contentDocument = element.contentDocument;
+            if (contentWindow && contentDocument) {
+                const localPoint = translatePointToIframeCoordinates({
+                    left,
+                    top
+                }, element, currentWindow);
+                const currentIframeXpath = getElementXpath(element, isOrderSensitive, false, true);
+                xpathPrefix += currentIframeXpath + SUB_XPATH_SEPARATOR;
+                currentWindow = contentWindow;
+                currentDocument = contentDocument;
+                left = localPoint.left;
+                top = localPoint.top;
+                continue;
+            }
+        } catch (error) {
+            logger('[midscene:locator] iframe penetration failed (cross-origin?):', error);
+        }
+        const fullXPath = getElementXpath(element, isOrderSensitive, true, true);
+        return [
+            xpathPrefix + fullXPath
+        ];
+    }
+    if (lastFoundElement) {
+        const fullXPath = getElementXpath(lastFoundElement, isOrderSensitive, true, true);
+        return [
+            xpathPrefix + fullXPath
+        ];
+    }
+    return null;
+}
+function getNodeInfoByXpath(xpath) {
+    const parts = xpath.split(SUB_XPATH_SEPARATOR).map((p)=>p.trim()).filter(Boolean);
+    if (0 === parts.length) return null;
+    let currentDocument = 'undefined' != typeof document ? document : void 0;
+    let node = null;
+    for(let i = 0; i < parts.length; i++){
+        const currentXpath = parts[i];
+        const xpathResult = currentDocument.evaluate(currentXpath, currentDocument, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null);
+        if (1 !== xpathResult.snapshotLength) {
+            logger(`[midscene:locator] XPath "${currentXpath}" matched ${xpathResult.snapshotLength} elements (expected 1), discarding.`);
+            return null;
+        }
+        node = xpathResult.snapshotItem(0);
+        if (i < parts.length - 1) if (!node || node.nodeType !== Node.ELEMENT_NODE || 'iframe' !== node.tagName.toLowerCase()) return null;
+        else try {
+            const contentDocument = node.contentDocument;
+            if (contentDocument) currentDocument = contentDocument;
+            else {
+                logger('[midscene:locator] iframe contentDocument is null (cross-origin?)');
+                return null;
+            }
+        } catch (error) {
+            logger('[midscene:locator] iframe contentDocument access failed:', error);
+            return null;
+        }
+    }
+    return node;
+}
+function getElementInfoByXpath(xpath) {
+    const node = getNodeInfoByXpath(xpath);
+    if (!node) return null;
+    let targetWindow = 'undefined' != typeof window ? window : void 0;
+    let targetDocument = 'undefined' != typeof document ? document : void 0;
+    if (node.ownerDocument?.defaultView) {
+        targetWindow = node.ownerDocument.defaultView;
+        targetDocument = node.ownerDocument;
+    }
+    const rootDoc = 'undefined' != typeof document ? document : null;
+    const iframeOffset = calculateIframeOffset(node.ownerDocument ?? null, rootDoc);
+    const targetWin = targetWindow;
+    const targetDoc = targetDocument;
+    if (node instanceof targetWin.HTMLElement) {
+        const rect = getRect(node, 1, targetWin);
+        const isVisible = isElementPartiallyInViewport(rect, targetWin, targetDoc, 1);
+        if (!isVisible) node.scrollIntoView({
+            behavior: 'instant',
+            block: 'center'
+        });
+    }
+    return collectElementInfo(node, targetWin, targetDoc, 1, iframeOffset, true);
+}
+export { getElementInfoByXpath, getElementXpath, getNodeInfoByXpath, getXpathsById, getXpathsByPoint };

package/dist/es/extractor/tree.mjs

@@ -0,0 +1,78 @@
+function truncateText(text, maxLength = 150) {
+    if (void 0 === text) return '';
+    if ('object' == typeof text) text = JSON.stringify(text);
+    if ('number' == typeof text) return text.toString();
+    if ('string' == typeof text && text.length > maxLength) return `${text.slice(0, maxLength)}...`;
+    if ('string' == typeof text) return text.trim();
+    return '';
+}
+function trimAttributes(attributes, truncateTextLength) {
+    const tailorAttributes = Object.keys(attributes).reduce((res, currentKey)=>{
+        const attributeVal = attributes[currentKey];
+        if ('style' === currentKey || 'htmlTagName' === currentKey || 'nodeType' === currentKey) return res;
+        res[currentKey] = truncateText(attributeVal, truncateTextLength);
+        return res;
+    }, {});
+    return tailorAttributes;
+}
+const nodeSizeThreshold = 4;
+function descriptionOfTree(tree, truncateTextLength, filterNonTextContent = false, visibleOnly = true) {
+    const attributesString = (kv)=>Object.entries(kv).map(([key, value])=>`${key}="${truncateText(value, truncateTextLength)}"`).join(' ');
+    function buildContentTree(node, indent = 0, visibleOnly = true) {
+        let before = '';
+        let contentWithIndent = '';
+        let after = '';
+        let emptyNode = true;
+        const indentStr = '  '.repeat(indent);
+        let children = '';
+        for(let i = 0; i < (node.children || []).length; i++){
+            const childContent = buildContentTree(node.children[i], indent + 1, visibleOnly);
+            if (childContent) children += `\n${childContent}`;
+        }
+        if (node.node && node.node.rect.width > nodeSizeThreshold && node.node.rect.height > nodeSizeThreshold && (!filterNonTextContent || filterNonTextContent && node.node.content) && (!visibleOnly || visibleOnly && node.node.isVisible)) {
+            emptyNode = false;
+            let nodeTypeString;
+            nodeTypeString = node.node.attributes?.htmlTagName ? node.node.attributes.htmlTagName.replace(/[<>]/g, '') : node.node.attributes.nodeType.replace(/\sNode$/, '').toLowerCase();
+            const rectAttribute = node.node.rect ? {
+                left: node.node.rect.left,
+                top: node.node.rect.top,
+                width: node.node.rect.width,
+                height: node.node.rect.height
+            } : {};
+            before = `<${nodeTypeString} id="${node.node.id}" ${attributesString(trimAttributes(node.node.attributes || {}, truncateTextLength))} ${attributesString(rectAttribute)}>`;
+            const content = truncateText(node.node.content, truncateTextLength);
+            contentWithIndent = content ? `\n${indentStr}  ${content}` : '';
+            after = `</${nodeTypeString}>`;
+        } else if (!filterNonTextContent) {
+            if (!children.trim().startsWith('<>')) {
+                before = '<>';
+                contentWithIndent = '';
+                after = '</>';
+            }
+        }
+        if (emptyNode && !children.trim()) return '';
+        const result = `${indentStr}${before}${contentWithIndent}${children}\n${indentStr}${after}`;
+        if (result.trim()) return result;
+        return '';
+    }
+    const result = buildContentTree(tree, 0, visibleOnly);
+    return result.replace(/^\s*\n/gm, '');
+}
+function treeToList(tree) {
+    const result = [];
+    function dfs(node) {
+        if (node.node) result.push(node.node);
+        for (const child of node.children)dfs(child);
+    }
+    dfs(tree);
+    return result;
+}
+function traverseTree(tree, onNode) {
+    function dfs(node) {
+        if (node.node) node.node = onNode(node.node);
+        for (const child of node.children)dfs(child);
+    }
+    dfs(tree);
+    return tree;
+}
+export { descriptionOfTree, traverseTree, treeToList, trimAttributes, truncateText };

package/dist/es/extractor/tree.mjs.bak

@@ -0,0 +1,78 @@
+function truncateText(text, maxLength = 150) {
+    if (void 0 === text) return '';
+    if ('object' == typeof text) text = JSON.stringify(text);
+    if ('number' == typeof text) return text.toString();
+    if ('string' == typeof text && text.length > maxLength) return `${text.slice(0, maxLength)}...`;
+    if ('string' == typeof text) return text.trim();
+    return '';
+}
+function trimAttributes(attributes, truncateTextLength) {
+    const tailorAttributes = Object.keys(attributes).reduce((res, currentKey)=>{
+        const attributeVal = attributes[currentKey];
+        if ('style' === currentKey || 'htmlTagName' === currentKey || 'nodeType' === currentKey) return res;
+        res[currentKey] = truncateText(attributeVal, truncateTextLength);
+        return res;
+    }, {});
+    return tailorAttributes;
+}
+const nodeSizeThreshold = 4;
+function descriptionOfTree(tree, truncateTextLength, filterNonTextContent = false, visibleOnly = true) {
+    const attributesString = (kv)=>Object.entries(kv).map(([key, value])=>`${key}="${truncateText(value, truncateTextLength)}"`).join(' ');
+    function buildContentTree(node, indent = 0, visibleOnly = true) {
+        let before = '';
+        let contentWithIndent = '';
+        let after = '';
+        let emptyNode = true;
+        const indentStr = '  '.repeat(indent);
+        let children = '';
+        for(let i = 0; i < (node.children || []).length; i++){
+            const childContent = buildContentTree(node.children[i], indent + 1, visibleOnly);
+            if (childContent) children += `\n${childContent}`;
+        }
+        if (node.node && node.node.rect.width > nodeSizeThreshold && node.node.rect.height > nodeSizeThreshold && (!filterNonTextContent || filterNonTextContent && node.node.content) && (!visibleOnly || visibleOnly && node.node.isVisible)) {
+            emptyNode = false;
+            let nodeTypeString;
+            nodeTypeString = node.node.attributes?.htmlTagName ? node.node.attributes.htmlTagName.replace(/[<>]/g, '') : node.node.attributes.nodeType.replace(/\sNode$/, '').toLowerCase();
+            const rectAttribute = node.node.rect ? {
+                left: node.node.rect.left,
+                top: node.node.rect.top,
+                width: node.node.rect.width,
+                height: node.node.rect.height
+            } : {};
+            before = `<${nodeTypeString} id="${node.node.id}" ${attributesString(trimAttributes(node.node.attributes || {}, truncateTextLength))} ${attributesString(rectAttribute)}>`;
+            const content = truncateText(node.node.content, truncateTextLength);
+            contentWithIndent = content ? `\n${indentStr}  ${content}` : '';
+            after = `</${nodeTypeString}>`;
+        } else if (!filterNonTextContent) {
+            if (!children.trim().startsWith('<>')) {
+                before = '<>';
+                contentWithIndent = '';
+                after = '</>';
+            }
+        }
+        if (emptyNode && !children.trim()) return '';
+        const result = `${indentStr}${before}${contentWithIndent}${children}\n${indentStr}${after}`;
+        if (result.trim()) return result;
+        return '';
+    }
+    const result = buildContentTree(tree, 0, visibleOnly);
+    return result.replace(/^\s*\n/gm, '');
+}
+function treeToList(tree) {
+    const result = [];
+    function dfs(node) {
+        if (node.node) result.push(node.node);
+        for (const child of node.children)dfs(child);
+    }
+    dfs(tree);
+    return result;
+}
+function traverseTree(tree, onNode) {
+    function dfs(node) {
+        if (node.node) node.node = onNode(node.node);
+        for (const child of node.children)dfs(child);
+    }
+    dfs(tree);
+    return tree;
+}
+export { descriptionOfTree, traverseTree, treeToList, trimAttributes, truncateText };

package/dist/es/extractor/util.mjs

@@ -0,0 +1,245 @@
+import { generateHashId } from "../utils.mjs";
+import { extractTextWithPosition } from "./web-extractor.mjs";
+const MAX_VALUE_LENGTH = 300;
+let debugMode = false;
+function setDebugMode(mode) {
+    debugMode = mode;
+}
+function getDebugMode() {
+    return debugMode;
+}
+function logger(..._msg) {
+    if (!debugMode) return;
+    console.log(..._msg);
+}
+function isElementPartiallyInViewport(rect, currentWindow, currentDocument, visibleAreaRatio = 2 / 3) {
+    const elementHeight = rect.height;
+    const elementWidth = rect.width;
+    const viewportRect = {
+        left: 0,
+        top: 0,
+        width: currentWindow.innerWidth || currentDocument.documentElement.clientWidth,
+        height: currentWindow.innerHeight || currentDocument.documentElement.clientHeight,
+        right: currentWindow.innerWidth || currentDocument.documentElement.clientWidth,
+        bottom: currentWindow.innerHeight || currentDocument.documentElement.clientHeight,
+        x: 0,
+        y: 0,
+        zoom: 1
+    };
+    const overlapRect = overlappedRect(rect, viewportRect);
+    if (!overlapRect) return false;
+    const visibleArea = overlapRect.width * overlapRect.height;
+    const totalArea = elementHeight * elementWidth;
+    return visibleArea / totalArea >= visibleAreaRatio;
+}
+function getPseudoElementContent(element, currentWindow) {
+    if (!(element instanceof currentWindow.HTMLElement)) return {
+        before: '',
+        after: ''
+    };
+    const beforeContent = currentWindow.getComputedStyle(element, '::before').getPropertyValue('content');
+    const afterContent = currentWindow.getComputedStyle(element, '::after').getPropertyValue('content');
+    return {
+        before: 'none' === beforeContent ? '' : beforeContent.replace(/"/g, ''),
+        after: 'none' === afterContent ? '' : afterContent.replace(/"/g, '')
+    };
+}
+function hasOverflowY(element, currentWindow) {
+    const style = currentWindow.getComputedStyle(element);
+    return 'scroll' === style.overflowY || 'auto' === style.overflowY || 'hidden' === style.overflowY;
+}
+function overlappedRect(rect1, rect2) {
+    const left = Math.max(rect1.left, rect2.left);
+    const top = Math.max(rect1.top, rect2.top);
+    const right = Math.min(rect1.right, rect2.right);
+    const bottom = Math.min(rect1.bottom, rect2.bottom);
+    if (left < right && top < bottom) return {
+        left,
+        top,
+        right,
+        bottom,
+        width: right - left,
+        height: bottom - top,
+        x: left,
+        y: top,
+        zoom: 1
+    };
+    return null;
+}
+function getRect(el, baseZoom, currentWindow) {
+    let originalRect;
+    let newZoom = 1;
+    const hasGetBoundingClientRect = el instanceof Element;
+    if (hasGetBoundingClientRect) {
+        originalRect = el.getBoundingClientRect();
+        if (el instanceof currentWindow.HTMLElement && !('currentCSSZoom' in el)) newZoom = Number.parseFloat(currentWindow.getComputedStyle(el).zoom) || 1;
+    } else {
+        const range = currentWindow.document.createRange();
+        range.selectNodeContents(el);
+        originalRect = range.getBoundingClientRect();
+    }
+    const zoom = newZoom * baseZoom;
+    return {
+        width: originalRect.width * zoom,
+        height: originalRect.height * zoom,
+        left: originalRect.left * zoom,
+        top: originalRect.top * zoom,
+        right: originalRect.right * zoom,
+        bottom: originalRect.bottom * zoom,
+        x: originalRect.x * zoom,
+        y: originalRect.y * zoom,
+        zoom
+    };
+}
+const isElementCovered = (el, rect, currentWindow)=>{
+    const x = rect.left + rect.width / 2;
+    const y = rect.top + rect.height / 2;
+    const topElement = currentWindow.document.elementFromPoint(x, y);
+    if (!topElement) return false;
+    if (topElement === el) return false;
+    if (el?.contains(topElement)) return false;
+    if (topElement?.contains(el)) return false;
+    const rectOfTopElement = getRect(topElement, 1, currentWindow);
+    const overlapRect = overlappedRect(rect, rectOfTopElement);
+    if (!overlapRect) return false;
+    logger(el, 'Element is covered by another element', {
+        topElement,
+        el,
+        rect,
+        x,
+        y
+    });
+    return true;
+};
+function elementRect(el, currentWindow, currentDocument, baseZoom = 1) {
+    if (!el) {
+        logger(el, 'Element is not in the DOM hierarchy');
+        return false;
+    }
+    if (!(el instanceof currentWindow.HTMLElement) && el.nodeType !== Node.TEXT_NODE && 'svg' !== el.nodeName.toLowerCase()) {
+        logger(el, 'Element is not in the DOM hierarchy');
+        return false;
+    }
+    if (el instanceof currentWindow.HTMLElement) {
+        const style = currentWindow.getComputedStyle(el);
+        if ('none' === style.display || 'hidden' === style.visibility || '0' === style.opacity && 'INPUT' !== el.tagName) {
+            logger(el, 'Element is hidden');
+            return false;
+        }
+    }
+    const rect = getRect(el, baseZoom, currentWindow);
+    if (0 === rect.width && 0 === rect.height) {
+        logger(el, 'Element has no size');
+        return false;
+    }
+    if (1 === baseZoom && isElementCovered(el, rect, currentWindow)) return false;
+    const isVisible = isElementPartiallyInViewport(rect, currentWindow, currentDocument);
+    let parent = el;
+    const parentUntilNonStatic = (currentNode)=>{
+        let parent = currentNode?.parentElement;
+        while(parent){
+            const style = currentWindow.getComputedStyle(parent);
+            if ('static' !== style.position) return parent;
+            parent = parent.parentElement;
+        }
+        return null;
+    };
+    while(parent && parent !== currentDocument.body){
+        if (!(parent instanceof currentWindow.HTMLElement)) {
+            parent = parent.parentElement;
+            continue;
+        }
+        const parentStyle = currentWindow.getComputedStyle(parent);
+        if ('hidden' === parentStyle.overflow) {
+            const parentRect = getRect(parent, 1, currentWindow);
+            const tolerance = 10;
+            if (rect.right < parentRect.left - tolerance || rect.left > parentRect.right + tolerance || rect.bottom < parentRect.top - tolerance || rect.top > parentRect.bottom + tolerance) {
+                logger(el, 'element is partially or totally hidden by an ancestor', {
+                    rect,
+                    parentRect
+                });
+                return false;
+            }
+        }
+        if ('fixed' === parentStyle.position || 'sticky' === parentStyle.position) break;
+        parent = 'absolute' === parentStyle.position ? parentUntilNonStatic(parent) : parent.parentElement;
+    }
+    return {
+        left: Math.round(rect.left),
+        top: Math.round(rect.top),
+        width: Math.round(rect.width),
+        height: Math.round(rect.height),
+        zoom: rect.zoom,
+        isVisible
+    };
+}
+function validTextNodeContent(node) {
+    if (!node) return false;
+    if (node.nodeType !== Node.ELEMENT_NODE && node.nodeType !== Node.TEXT_NODE && '#text' !== node.nodeName) return false;
+    const content = node.textContent || node.innerText;
+    if (content && !/^\s*$/.test(content)) return content.trim();
+    return false;
+}
+function getNodeAttributes(node, currentWindow) {
+    if (!node || !(node instanceof currentWindow.HTMLElement) || !node.attributes) return {};
+    const attributesList = Array.from(node.attributes).map((attr)=>{
+        if ('class' === attr.name) return [
+            attr.name,
+            `.${attr.value.split(' ').join('.')}`
+        ];
+        let value = attr.value;
+        if (value.startsWith('data:image')) value = 'image';
+        if (value.length > MAX_VALUE_LENGTH) value = `${value.slice(0, MAX_VALUE_LENGTH)}...`;
+        return [
+            attr.name,
+            value
+        ];
+    });
+    return Object.fromEntries(attributesList);
+}
+const NODE_CACHE_MAX_SIZE = 2000;
+function setNodeHashCacheListOnWindow() {
+    if ('undefined' != typeof window) window.midsceneNodeHashCache = new Map();
+}
+function getNodeCacheMap() {
+    if ('undefined' == typeof window) return;
+    return window.midsceneNodeHashCache;
+}
+function setNodeToCacheList(node, id) {
+    const cache = getNodeCacheMap();
+    if (!cache) return;
+    if (cache.has(id)) return;
+    if (cache.size >= NODE_CACHE_MAX_SIZE) {
+        const firstKey = cache.keys().next().value;
+        if (void 0 !== firstKey) cache.delete(firstKey);
+    }
+    cache.set(id, node);
+}
+function getNodeFromCacheList(id) {
+    return getNodeCacheMap()?.get(id);
+}
+function midsceneGenerateHash(node, content, rect) {
+    const slicedHash = generateHashId(rect, content);
+    if (node) {
+        if ('undefined' != typeof window && !getNodeCacheMap()) setNodeHashCacheListOnWindow();
+        setNodeToCacheList(node, slicedHash);
+    }
+    return slicedHash;
+}
+function generateId(numberId) {
+    return `${numberId}`;
+}
+function setGenerateHashOnWindow() {
+    if ('undefined' != typeof window) window.midsceneGenerateHash = midsceneGenerateHash;
+}
+function setMidsceneVisibleRectOnWindow() {
+    if ('undefined' != typeof window) window.midsceneVisibleRect = elementRect;
+}
+function setExtractTextWithPositionOnWindow() {
+    if ('undefined' != typeof window) window.extractTextWithPosition = extractTextWithPosition;
+}
+function getTopDocument() {
+    const container = document.body || document;
+    return container;
+}
+export { elementRect, generateId, getDebugMode, getNodeAttributes, getNodeFromCacheList, getPseudoElementContent, getRect, getTopDocument, hasOverflowY, isElementPartiallyInViewport, logger, midsceneGenerateHash, overlappedRect, setDebugMode, setExtractTextWithPositionOnWindow, setGenerateHashOnWindow, setMidsceneVisibleRectOnWindow, setNodeHashCacheListOnWindow, setNodeToCacheList, validTextNodeContent };