@muuktest/amikoo-playwright 2.0.0

package/dist/helpers/dom-service.cjs

@@ -0,0 +1,365 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var dom_service_exports = {};
+__export(dom_service_exports, {
+  DOMBaseNode: () => DOMBaseNode,
+  DOMElementNode: () => DOMElementNode,
+  DOMTextNode: () => DOMTextNode,
+  DomService: () => DomService
+});
+module.exports = __toCommonJS(dom_service_exports);
+class DOMBaseNode {
+  is_visible;
+  parent;
+  constructor(isVisible, parent = null) {
+    this.is_visible = isVisible;
+    this.parent = parent;
+  }
+}
+class DOMTextNode extends DOMBaseNode {
+  text;
+  type;
+  constructor(text, isVisible, parent = null) {
+    super(isVisible, parent);
+    this.text = text;
+    this.type = "TEXT_NODE";
+  }
+  has_parent_with_highlight_index() {
+    let current = this.parent;
+    while (current !== null) {
+      if (current.highlight_index !== null && current.highlight_index !== void 0) {
+        return true;
+      }
+      current = current.parent;
+    }
+    return false;
+  }
+}
+function convertSimpleXpathToCssSelector(xpath) {
+  if (!xpath) return "";
+  xpath = xpath.replace(/^\/+/, "");
+  const parts = xpath.split("/");
+  const cssParts = [];
+  for (let part of parts) {
+    if (!part) continue;
+    if (part.includes(":") && !part.includes("[")) {
+      const basePart = part.replace(/:/g, "\\:");
+      cssParts.push(basePart);
+      continue;
+    }
+    if (part.includes("[")) {
+      let basePart = part.substring(0, part.indexOf("["));
+      if (basePart.includes(":")) {
+        basePart = basePart.replace(/:/g, "\\:");
+      }
+      const indexPart = part.substring(part.indexOf("["));
+      const indices = indexPart.split("]").filter((i) => i).map((i) => i.replace("[", ""));
+      for (const idx of indices) {
+        try {
+          if (/^\d+$/.test(idx)) {
+            const index = parseInt(idx) - 1;
+            basePart += `:nth-of-type(${index + 1})`;
+          } else if (idx === "last()") {
+            basePart += ":last-of-type";
+          } else if (idx.includes("position()") && idx.includes(">1")) {
+            basePart += ":nth-of-type(n+2)";
+          }
+        } catch (e) {
+          continue;
+        }
+      }
+      cssParts.push(basePart);
+    } else {
+      cssParts.push(part);
+    }
+  }
+  return cssParts.join(" > ");
+}
+function enhancedCssSelectorForElement(element, includeDynamicAttributes = true) {
+  try {
+    let cssSelector = convertSimpleXpathToCssSelector(element.xpath);
+    if (element.attributes.class && includeDynamicAttributes) {
+      const validClassNamePattern = /^[a-zA-Z_][a-zA-Z0-9_-]*$/;
+      const classes = element.attributes.class.split(/\s+/);
+      for (const className of classes) {
+        if (!className.trim()) continue;
+        if (validClassNamePattern.test(className)) {
+          cssSelector += `.${className}`;
+        }
+      }
+    }
+    const SAFE_ATTRIBUTES = /* @__PURE__ */ new Set([
+      "id",
+      "name",
+      "type",
+      "placeholder",
+      "aria-label",
+      "aria-labelledby",
+      "aria-describedby",
+      "role",
+      "for",
+      "autocomplete",
+      "required",
+      "readonly",
+      "alt",
+      "title",
+      "src",
+      "href",
+      "target"
+    ]);
+    if (includeDynamicAttributes) {
+      SAFE_ATTRIBUTES.add("data-id");
+      SAFE_ATTRIBUTES.add("data-qa");
+      SAFE_ATTRIBUTES.add("data-cy");
+      SAFE_ATTRIBUTES.add("data-testid");
+    }
+    for (const [attribute, value] of Object.entries(element.attributes)) {
+      if (attribute === "class") continue;
+      if (!attribute.trim()) continue;
+      if (!SAFE_ATTRIBUTES.has(attribute)) continue;
+      const safeAttribute = attribute.replace(/:/g, "\\:");
+      if (value === "") {
+        cssSelector += `[${safeAttribute}]`;
+      } else if (/["'<>`\n\r\t]/.test(value)) {
+        let processedValue = value;
+        if (processedValue.includes("\n")) {
+          processedValue = processedValue.split("\n")[0];
+        }
+        const collapsedValue = processedValue.replace(/\s+/g, " ").trim();
+        const safeValue = collapsedValue.replace(/"/g, '\\"');
+        cssSelector += `[${safeAttribute}*="${safeValue}"]`;
+      } else {
+        cssSelector += `[${safeAttribute}="${value}"]`;
+      }
+    }
+    return cssSelector;
+  } catch (error) {
+    const tagName = element.tag_name || "*";
+    return `${tagName}[highlight_index='${element.highlight_index}']`;
+  }
+}
+class DOMElementNode extends DOMBaseNode {
+  tag_name;
+  xpath;
+  attributes;
+  children;
+  childrenTags;
+  is_interactive;
+  is_reference;
+  is_top_element;
+  is_in_viewport;
+  shadow_root;
+  highlight_index;
+  page_coordinates;
+  viewport_coordinates;
+  _css_selector;
+  constructor(data) {
+    super(data.isVisible || false, null);
+    this.tag_name = data.tagName || "";
+    this.xpath = data.xpath || "";
+    this.attributes = data.attributes || {};
+    this.children = [];
+    this.childrenTags = data.childrenTags || [];
+    this.is_interactive = data.isInteractive || false;
+    this.is_reference = data.isReference || false;
+    this.is_top_element = data.isTopElement || false;
+    this.is_in_viewport = data.isInViewport || false;
+    this.shadow_root = data.shadowRoot || false;
+    this.highlight_index = data.highlightIndex;
+    this.page_coordinates = data.pageCoordinates || null;
+    this.viewport_coordinates = data.viewportCoordinates || null;
+    this._css_selector = null;
+  }
+  get css_selector() {
+    if (this._css_selector === null) {
+      this._css_selector = enhancedCssSelectorForElement(this, true);
+    }
+    return this._css_selector;
+  }
+  get_meaningful_text() {
+    const semanticAttrs = ["value", "aria-label", "title", "placeholder", "alt", "name"];
+    for (const attr of semanticAttrs) {
+      if (this.attributes[attr]) {
+        return this.clean_text(this.attributes[attr]);
+      }
+    }
+    const tag = this.tag_name.toLowerCase();
+    if (tag === "a") {
+      for (const child of this.children) {
+        if (!(child instanceof DOMElementNode)) continue;
+        const ctag = child.tag_name.toLowerCase();
+        if (ctag === "img") {
+          const alt = child.attributes.alt || "";
+          const title = child.attributes.title || "";
+          if (alt) return this.clean_text(alt);
+          if (title) return this.clean_text(title);
+        } else if (ctag === "svg") {
+          const ariaLabel = child.attributes["aria-label"] || "";
+          const title = child.attributes.title || "";
+          if (ariaLabel) return this.clean_text(ariaLabel);
+          if (title) return this.clean_text(title);
+          for (const g of child.children) {
+            if (g instanceof DOMElementNode && g.tag_name.toLowerCase() === "title") {
+              const titleText = this.get_all_text_from_node(g);
+              if (titleText) return this.clean_text(titleText);
+            }
+          }
+        }
+      }
+    }
+    if (tag === "img") {
+      const alt = this.attributes.alt || "";
+      const title = this.attributes.title || "";
+      if (alt) return this.clean_text(alt);
+      if (title) return this.clean_text(title);
+    }
+    if (tag === "svg") {
+      const ariaLabel = this.attributes["aria-label"] || "";
+      const title = this.attributes.title || "";
+      if (ariaLabel) return this.clean_text(ariaLabel);
+      if (title) return this.clean_text(title);
+      for (const child of this.children) {
+        if (child instanceof DOMElementNode && child.tag_name.toLowerCase() === "title") {
+          const titleText = this.get_all_text_from_node(child);
+          if (titleText) return this.clean_text(titleText);
+        }
+      }
+    }
+    const textVal = this.get_all_children_text(-1).trim();
+    return textVal ? this.clean_text(textVal) : "";
+  }
+  get_all_children_text(maxDepth = 1) {
+    const textParts = [];
+    const collectText = (node, currentDepth) => {
+      if (maxDepth !== -1 && currentDepth > maxDepth) return;
+      if (node instanceof DOMTextNode) {
+        if (node.text && node.is_visible) {
+          textParts.push(node.text.trim());
+        }
+      } else if (node instanceof DOMElementNode) {
+        for (const child of node.children) {
+          collectText(child, currentDepth + 1);
+        }
+      }
+    };
+    const children = this.children || [];
+    if (children.length === 1 && children[0] instanceof DOMElementNode) {
+      const child = children[0];
+      const tag = child.tag_name.toLowerCase();
+      if (tag === "div" || tag === "span") {
+        for (const gc of child.children) {
+          collectText(gc, 1);
+        }
+        return textParts.filter((t) => t).join(" ");
+      }
+    }
+    for (const child of children) {
+      collectText(child, 1);
+    }
+    return textParts.filter((t) => t).join(" ");
+  }
+  get_all_text_from_node(node) {
+    if (node instanceof DOMTextNode) {
+      return node.text;
+    } else if (node instanceof DOMElementNode) {
+      return node.get_all_children_text(-1);
+    }
+    return "";
+  }
+  clean_text(text) {
+    if (!text) return "";
+    const parts = text.split(/\s+/);
+    const mid = Math.floor(parts.length / 2);
+    if (parts.length > 1) {
+      const firstHalf = parts.slice(0, mid).join(" ");
+      const secondHalf = parts.slice(mid).join(" ");
+      if (firstHalf === secondHalf) {
+        return firstHalf;
+      }
+    }
+    return parts.join(" ");
+  }
+}
+class DomService {
+  async buildDomTree(page, jsCode, options = {}) {
+    const args = {
+      doHighlightElements: options.highlightElements ?? true,
+      focusHighlightIndex: options.focusElement ?? -1,
+      viewportExpansion: options.viewportExpansion ?? -1,
+      debugMode: options.debugMode ?? false
+    };
+    const evalPage = await page.evaluate(({ code, params }) => {
+      eval(code);
+      return window.buildDomTreeMain(params);
+    }, { code: jsCode, params: args });
+    return this.constructDomTree(evalPage);
+  }
+  constructDomTree(evalPage2) {
+    const jsNodeMap = evalPage2.map;
+    const jsRootId = evalPage2.rootId;
+    const selectorMap = {};
+    const nodeMap = /* @__PURE__ */ new Map();
+    const childrenMap = /* @__PURE__ */ new Map();
+    for (const [id, nodeData] of Object.entries(jsNodeMap)) {
+      const { node, childrenIds } = this.parseNode(nodeData);
+      if (!node) continue;
+      nodeMap.set(id, node);
+      childrenMap.set(id, childrenIds);
+      if (node instanceof DOMElementNode && node.highlight_index !== null && node.highlight_index !== void 0) {
+        selectorMap[node.highlight_index] = node;
+      }
+    }
+    for (const [idStr, node] of nodeMap.entries()) {
+      if (node instanceof DOMElementNode) {
+        const childIds = childrenMap.get(idStr) || [];
+        for (const childId of childIds) {
+          const childNode = nodeMap.get(String(childId));
+          if (childNode) {
+            childNode.parent = node;
+            node.children.push(childNode);
+          }
+        }
+      }
+    }
+    const rootNode = nodeMap.get(String(jsRootId));
+    return { elementTree: rootNode, selectorMap };
+  }
+  parseNode(nodeData) {
+    if (!nodeData) return { node: null, childrenIds: [] };
+    if (nodeData.type === "TEXT_NODE") {
+      const textNode = new DOMTextNode(
+        nodeData.text || "",
+        nodeData.isVisible || false,
+        null
+      );
+      return { node: textNode, childrenIds: [] };
+    }
+    const elementNode = new DOMElementNode(nodeData);
+    const childrenIds = nodeData.children || [];
+    return { node: elementNode, childrenIds };
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DOMBaseNode,
+  DOMElementNode,
+  DOMTextNode,
+  DomService
+});
+//# sourceMappingURL=dom-service.cjs.map

package/dist/helpers/dom-service.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/helpers/dom-service.ts"],"sourcesContent":["/**\n * DOM Node Classes - Port from Python views.py\n */\nimport type { Page } from '@playwright/test';\n\nexport interface Coordinates {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\nexport interface DOMElementData {\n  tagName?: string;\n  xpath?: string;\n  attributes?: Record<string, string>;\n  childrenTags?: string[];\n  isInteractive?: boolean;\n  isReference?: boolean;\n  isTopElement?: boolean;\n  isInViewport?: boolean;\n  isVisible?: boolean;\n  shadowRoot?: boolean;\n  highlightIndex?: number | null;\n  pageCoordinates?: Coordinates | null;\n  viewportCoordinates?: Coordinates | null;\n  children?: number[];\n  type?: string;\n  text?: string;\n}\n\ninterface BuildDomTreeEvalResult {\n  rootId: number;\n  map: Record<string, DOMElementData>;\n}\n\nexport interface DomTreeResult {\n  elementTree: DOMElementNode | undefined;\n  selectorMap: Record<number, DOMElementNode>;\n}\n\nexport class DOMBaseNode {\n  is_visible: boolean;\n  parent: DOMElementNode | null;\n\n  constructor(isVisible: boolean, parent: DOMElementNode | null = null) {\n    this.is_visible = isVisible;\n    this.parent = parent;\n  }\n}\n\nexport class DOMTextNode extends DOMBaseNode {\n  text: string;\n  type: string;\n\n  constructor(text: string, isVisible: boolean, parent: DOMElementNode | null = null) {\n    super(isVisible, parent);\n    this.text = text;\n    this.type = 'TEXT_NODE';\n  }\n\n  has_parent_with_highlight_index(): boolean {\n    let current: DOMElementNode | null = this.parent;\n    while (current !== null) {\n      if (current.highlight_index !== null && current.highlight_index !== undefined) {\n        return true;\n      }\n      current = current.parent;\n    }\n    return false;\n  }\n}\n\n/**\n * Port of enhanced_css_selector_for_element from Python\n */\nfunction convertSimpleXpathToCssSelector(xpath: string): string {\n  if (!xpath) return '';\n\n  xpath = xpath.replace(/^\\/+/, '');\n  const parts = xpath.split('/');\n  const cssParts: string[] = [];\n\n  for (let part of parts) {\n    if (!part) continue;\n\n    if (part.includes(':') && !part.includes('[')) {\n      const basePart = part.replace(/:/g, '\\\\:');\n      cssParts.push(basePart);\n      continue;\n    }\n\n    if (part.includes('[')) {\n      let basePart = part.substring(0, part.indexOf('['));\n\n      if (basePart.includes(':')) {\n        basePart = basePart.replace(/:/g, '\\\\:');\n      }\n\n      const indexPart = part.substring(part.indexOf('['));\n      const indices = indexPart.split(']').filter(i => i).map(i => i.replace('[', ''));\n\n      for (const idx of indices) {\n        try {\n          if (/^\\d+$/.test(idx)) {\n            const index = parseInt(idx) - 1;\n            basePart += `:nth-of-type(${index + 1})`;\n          } else if (idx === 'last()') {\n            basePart += ':last-of-type';\n          } else if (idx.includes('position()') && idx.includes('>1')) {\n            basePart += ':nth-of-type(n+2)';\n          }\n        } catch (e) {\n          continue;\n        }\n      }\n\n      cssParts.push(basePart);\n    } else {\n      cssParts.push(part);\n    }\n  }\n\n  return cssParts.join(' > ');\n}\n\nfunction enhancedCssSelectorForElement(element: DOMElementNode, includeDynamicAttributes = true): string {\n  try {\n    let cssSelector = convertSimpleXpathToCssSelector(element.xpath);\n\n    if (element.attributes.class && includeDynamicAttributes) {\n      const validClassNamePattern = /^[a-zA-Z_][a-zA-Z0-9_-]*$/;\n      const classes = element.attributes.class.split(/\\s+/);\n\n      for (const className of classes) {\n        if (!className.trim()) continue;\n        if (validClassNamePattern.test(className)) {\n          cssSelector += `.${className}`;\n        }\n      }\n    }\n\n    const SAFE_ATTRIBUTES = new Set([\n      'id', 'name', 'type', 'placeholder',\n      'aria-label', 'aria-labelledby', 'aria-describedby', 'role',\n      'for', 'autocomplete', 'required', 'readonly',\n      'alt', 'title', 'src', 'href', 'target'\n    ]);\n\n    if (includeDynamicAttributes) {\n      SAFE_ATTRIBUTES.add('data-id');\n      SAFE_ATTRIBUTES.add('data-qa');\n      SAFE_ATTRIBUTES.add('data-cy');\n      SAFE_ATTRIBUTES.add('data-testid');\n    }\n\n    for (const [attribute, value] of Object.entries(element.attributes)) {\n      if (attribute === 'class') continue;\n      if (!attribute.trim()) continue;\n      if (!SAFE_ATTRIBUTES.has(attribute)) continue;\n\n      const safeAttribute = attribute.replace(/:/g, '\\\\:');\n\n      if (value === '') {\n        cssSelector += `[${safeAttribute}]`;\n      } else if (/[\"'<>`\\n\\r\\t]/.test(value)) {\n        let processedValue = value;\n        if (processedValue.includes('\\n')) {\n          processedValue = processedValue.split('\\n')[0];\n        }\n        const collapsedValue = processedValue.replace(/\\s+/g, ' ').trim();\n        const safeValue = collapsedValue.replace(/\"/g, '\\\\\"');\n        cssSelector += `[${safeAttribute}*=\"${safeValue}\"]`;\n      } else {\n        cssSelector += `[${safeAttribute}=\"${value}\"]`;\n      }\n    }\n\n    return cssSelector;\n\n  } catch (error) {\n    const tagName = element.tag_name || '*';\n    return `${tagName}[highlight_index='${element.highlight_index}']`;\n  }\n}\n\nexport class DOMElementNode extends DOMBaseNode {\n  tag_name: string;\n  xpath: string;\n  attributes: Record<string, string>;\n  children: (DOMElementNode | DOMTextNode)[];\n  childrenTags: string[];\n  is_interactive: boolean;\n  is_reference: boolean;\n  is_top_element: boolean;\n  is_in_viewport: boolean;\n  shadow_root: boolean;\n  highlight_index: number | null | undefined;\n  page_coordinates: Coordinates | null;\n  viewport_coordinates: Coordinates | null;\n  private _css_selector: string | null;\n\n  constructor(data: DOMElementData) {\n    super(data.isVisible || false, null);\n\n    this.tag_name = data.tagName || '';\n    this.xpath = data.xpath || '';\n    this.attributes = data.attributes || {};\n    this.children = [];\n    this.childrenTags = data.childrenTags || [];\n    this.is_interactive = data.isInteractive || false;\n    this.is_reference = data.isReference || false;\n    this.is_top_element = data.isTopElement || false;\n    this.is_in_viewport = data.isInViewport || false;\n    this.shadow_root = data.shadowRoot || false;\n    this.highlight_index = data.highlightIndex;\n    this.page_coordinates = data.pageCoordinates || null;\n    this.viewport_coordinates = data.viewportCoordinates || null;\n    this._css_selector = null;\n  }\n\n  get css_selector(): string {\n    if (this._css_selector === null) {\n      this._css_selector = enhancedCssSelectorForElement(this, true);\n    }\n    return this._css_selector;\n  }\n\n  get_meaningful_text(): string {\n    const semanticAttrs = ['value', 'aria-label', 'title', 'placeholder', 'alt', 'name'];\n    for (const attr of semanticAttrs) {\n      if (this.attributes[attr]) {\n        return this.clean_text(this.attributes[attr]);\n      }\n    }\n\n    const tag = this.tag_name.toLowerCase();\n\n    if (tag === 'a') {\n      for (const child of this.children) {\n        if (!(child instanceof DOMElementNode)) continue;\n        const ctag = child.tag_name.toLowerCase();\n\n        if (ctag === 'img') {\n          const alt = child.attributes.alt || '';\n          const title = child.attributes.title || '';\n          if (alt) return this.clean_text(alt);\n          if (title) return this.clean_text(title);\n        } else if (ctag === 'svg') {\n          const ariaLabel = child.attributes['aria-label'] || '';\n          const title = child.attributes.title || '';\n          if (ariaLabel) return this.clean_text(ariaLabel);\n          if (title) return this.clean_text(title);\n\n          for (const g of child.children) {\n            if (g instanceof DOMElementNode && g.tag_name.toLowerCase() === 'title') {\n              const titleText = this.get_all_text_from_node(g);\n              if (titleText) return this.clean_text(titleText);\n            }\n          }\n        }\n      }\n    }\n\n    if (tag === 'img') {\n      const alt = this.attributes.alt || '';\n      const title = this.attributes.title || '';\n      if (alt) return this.clean_text(alt);\n      if (title) return this.clean_text(title);\n    }\n\n    if (tag === 'svg') {\n      const ariaLabel = this.attributes['aria-label'] || '';\n      const title = this.attributes.title || '';\n      if (ariaLabel) return this.clean_text(ariaLabel);\n      if (title) return this.clean_text(title);\n\n      for (const child of this.children) {\n        if (child instanceof DOMElementNode && child.tag_name.toLowerCase() === 'title') {\n          const titleText = this.get_all_text_from_node(child);\n          if (titleText) return this.clean_text(titleText);\n        }\n      }\n    }\n\n    const textVal = this.get_all_children_text(-1).trim();\n    return textVal ? this.clean_text(textVal) : '';\n  }\n\n  get_all_children_text(maxDepth = 1): string {\n    const textParts: string[] = [];\n\n    const collectText = (node: DOMElementNode | DOMTextNode, currentDepth: number): void => {\n      if (maxDepth !== -1 && currentDepth > maxDepth) return;\n\n      if (node instanceof DOMTextNode) {\n        if (node.text && node.is_visible) {\n          textParts.push(node.text.trim());\n        }\n      } else if (node instanceof DOMElementNode) {\n        for (const child of node.children) {\n          collectText(child, currentDepth + 1);\n        }\n      }\n    };\n\n    const children = this.children || [];\n\n    if (children.length === 1 && children[0] instanceof DOMElementNode) {\n      const child = children[0];\n      const tag = child.tag_name.toLowerCase();\n      if (tag === 'div' || tag === 'span') {\n        for (const gc of child.children) {\n          collectText(gc, 1);\n        }\n        return textParts.filter(t => t).join(' ');\n      }\n    }\n\n    for (const child of children) {\n      collectText(child, 1);\n    }\n\n    return textParts.filter(t => t).join(' ');\n  }\n\n  get_all_text_from_node(node: DOMElementNode | DOMTextNode): string {\n    if (node instanceof DOMTextNode) {\n      return node.text;\n    } else if (node instanceof DOMElementNode) {\n      return node.get_all_children_text(-1);\n    }\n    return '';\n  }\n\n  clean_text(text: string): string {\n    if (!text) return '';\n\n    const parts = text.split(/\\s+/);\n    const mid = Math.floor(parts.length / 2);\n\n    if (parts.length > 1) {\n      const firstHalf = parts.slice(0, mid).join(' ');\n      const secondHalf = parts.slice(mid).join(' ');\n      if (firstHalf === secondHalf) {\n        return firstHalf;\n      }\n    }\n\n    return parts.join(' ');\n  }\n}\n\n/**\n * Port of DomService from Python service.py\n */\nexport class DomService {\n  async buildDomTree(\n    page: Page,\n    jsCode: string,\n    options: {\n      highlightElements?: boolean;\n      focusElement?: number;\n      viewportExpansion?: number;\n      debugMode?: boolean;\n    } = {}\n  ): Promise<DomTreeResult> {\n    const args = {\n      doHighlightElements: options.highlightElements ?? true,\n      focusHighlightIndex: options.focusElement ?? -1,\n      viewportExpansion: options.viewportExpansion ?? -1,\n      debugMode: options.debugMode ?? false\n    };\n\n    // Execute JS in browser\n    const evalPage = await page.evaluate(({ code, params }: { code: string; params: typeof args }) => {\n      eval(code);\n      return (window as any).buildDomTreeMain(params);\n    }, { code: jsCode, params: args }) as BuildDomTreeEvalResult;\n\n    return this.constructDomTree(evalPage);\n  }\n\n  private constructDomTree(evalPage: BuildDomTreeEvalResult): DomTreeResult {\n    const jsNodeMap = evalPage.map;\n    const jsRootId = evalPage.rootId;\n\n    const selectorMap: Record<number, DOMElementNode> = {};\n    const nodeMap = new Map<string, DOMElementNode | DOMTextNode>();\n    const childrenMap = new Map<string, number[]>();\n\n    for (const [id, nodeData] of Object.entries(jsNodeMap)) {\n      const { node, childrenIds } = this.parseNode(nodeData);\n      if (!node) continue;\n\n      nodeMap.set(id, node);\n      childrenMap.set(id, childrenIds);\n\n      if (node instanceof DOMElementNode && node.highlight_index !== null && node.highlight_index !== undefined) {\n        selectorMap[node.highlight_index] = node;\n      }\n    }\n\n    for (const [idStr, node] of nodeMap.entries()) {\n      if (node instanceof DOMElementNode) {\n        const childIds = childrenMap.get(idStr) || [];\n        for (const childId of childIds) {\n          const childNode = nodeMap.get(String(childId));\n          if (childNode) {\n            childNode.parent = node;\n            node.children.push(childNode);\n          }\n        }\n      }\n    }\n\n    const rootNode = nodeMap.get(String(jsRootId)) as DOMElementNode | undefined;\n\n    return { elementTree: rootNode, selectorMap };\n  }\n\n  private parseNode(nodeData: DOMElementData): { node: DOMElementNode | DOMTextNode | null; childrenIds: number[] } {\n    if (!nodeData) return { node: null, childrenIds: [] };\n\n    if (nodeData.type === 'TEXT_NODE') {\n      const textNode = new DOMTextNode(\n        nodeData.text || '',\n        nodeData.isVisible || false,\n        null\n      );\n      return { node: textNode, childrenIds: [] };\n    }\n\n    const elementNode = new DOMElementNode(nodeData);\n    const childrenIds = nodeData.children || [];\n\n    return { node: elementNode, childrenIds };\n  }\n}\n"],"mappings":"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","names":["evalPage"]}

package/dist/helpers/dom-service.d.cts

@@ -0,0 +1,82 @@
+import { Page } from '@playwright/test';
+
+/**
+ * DOM Node Classes - Port from Python views.py
+ */
+
+interface Coordinates {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface DOMElementData {
+    tagName?: string;
+    xpath?: string;
+    attributes?: Record<string, string>;
+    childrenTags?: string[];
+    isInteractive?: boolean;
+    isReference?: boolean;
+    isTopElement?: boolean;
+    isInViewport?: boolean;
+    isVisible?: boolean;
+    shadowRoot?: boolean;
+    highlightIndex?: number | null;
+    pageCoordinates?: Coordinates | null;
+    viewportCoordinates?: Coordinates | null;
+    children?: number[];
+    type?: string;
+    text?: string;
+}
+interface DomTreeResult {
+    elementTree: DOMElementNode | undefined;
+    selectorMap: Record<number, DOMElementNode>;
+}
+declare class DOMBaseNode {
+    is_visible: boolean;
+    parent: DOMElementNode | null;
+    constructor(isVisible: boolean, parent?: DOMElementNode | null);
+}
+declare class DOMTextNode extends DOMBaseNode {
+    text: string;
+    type: string;
+    constructor(text: string, isVisible: boolean, parent?: DOMElementNode | null);
+    has_parent_with_highlight_index(): boolean;
+}
+declare class DOMElementNode extends DOMBaseNode {
+    tag_name: string;
+    xpath: string;
+    attributes: Record<string, string>;
+    children: (DOMElementNode | DOMTextNode)[];
+    childrenTags: string[];
+    is_interactive: boolean;
+    is_reference: boolean;
+    is_top_element: boolean;
+    is_in_viewport: boolean;
+    shadow_root: boolean;
+    highlight_index: number | null | undefined;
+    page_coordinates: Coordinates | null;
+    viewport_coordinates: Coordinates | null;
+    private _css_selector;
+    constructor(data: DOMElementData);
+    get css_selector(): string;
+    get_meaningful_text(): string;
+    get_all_children_text(maxDepth?: number): string;
+    get_all_text_from_node(node: DOMElementNode | DOMTextNode): string;
+    clean_text(text: string): string;
+}
+/**
+ * Port of DomService from Python service.py
+ */
+declare class DomService {
+    buildDomTree(page: Page, jsCode: string, options?: {
+        highlightElements?: boolean;
+        focusElement?: number;
+        viewportExpansion?: number;
+        debugMode?: boolean;
+    }): Promise<DomTreeResult>;
+    private constructDomTree;
+    private parseNode;
+}
+
+export { type Coordinates, DOMBaseNode, type DOMElementData, DOMElementNode, DOMTextNode, DomService, type DomTreeResult };

package/dist/helpers/dom-service.d.ts

@@ -0,0 +1,82 @@
+import { Page } from '@playwright/test';
+
+/**
+ * DOM Node Classes - Port from Python views.py
+ */
+
+interface Coordinates {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface DOMElementData {
+    tagName?: string;
+    xpath?: string;
+    attributes?: Record<string, string>;
+    childrenTags?: string[];
+    isInteractive?: boolean;
+    isReference?: boolean;
+    isTopElement?: boolean;
+    isInViewport?: boolean;
+    isVisible?: boolean;
+    shadowRoot?: boolean;
+    highlightIndex?: number | null;
+    pageCoordinates?: Coordinates | null;
+    viewportCoordinates?: Coordinates | null;
+    children?: number[];
+    type?: string;
+    text?: string;
+}
+interface DomTreeResult {
+    elementTree: DOMElementNode | undefined;
+    selectorMap: Record<number, DOMElementNode>;
+}
+declare class DOMBaseNode {
+    is_visible: boolean;
+    parent: DOMElementNode | null;
+    constructor(isVisible: boolean, parent?: DOMElementNode | null);
+}
+declare class DOMTextNode extends DOMBaseNode {
+    text: string;
+    type: string;
+    constructor(text: string, isVisible: boolean, parent?: DOMElementNode | null);
+    has_parent_with_highlight_index(): boolean;
+}
+declare class DOMElementNode extends DOMBaseNode {
+    tag_name: string;
+    xpath: string;
+    attributes: Record<string, string>;
+    children: (DOMElementNode | DOMTextNode)[];
+    childrenTags: string[];
+    is_interactive: boolean;
+    is_reference: boolean;
+    is_top_element: boolean;
+    is_in_viewport: boolean;
+    shadow_root: boolean;
+    highlight_index: number | null | undefined;
+    page_coordinates: Coordinates | null;
+    viewport_coordinates: Coordinates | null;
+    private _css_selector;
+    constructor(data: DOMElementData);
+    get css_selector(): string;
+    get_meaningful_text(): string;
+    get_all_children_text(maxDepth?: number): string;
+    get_all_text_from_node(node: DOMElementNode | DOMTextNode): string;
+    clean_text(text: string): string;
+}
+/**
+ * Port of DomService from Python service.py
+ */
+declare class DomService {
+    buildDomTree(page: Page, jsCode: string, options?: {
+        highlightElements?: boolean;
+        focusElement?: number;
+        viewportExpansion?: number;
+        debugMode?: boolean;
+    }): Promise<DomTreeResult>;
+    private constructDomTree;
+    private parseNode;
+}
+
+export { type Coordinates, DOMBaseNode, type DOMElementData, DOMElementNode, DOMTextNode, DomService, type DomTreeResult };