@browserbasehq/orca 3.0.9-alpha-4 → 3.1.0-patch.0

package/dist/esm/lib/v3/dom/locatorScripts/scripts.js

@@ -0,0 +1,458 @@
+/*
+ * DOM-side helpers used by Locator Runtime.callFunctionOn invocations.
+ *
+ * NOTE: These functions run inside the page context. Keep them dependency-free
+ * and resilient to exceptions (match the best-effort semantics of the old
+ * inline string snippets).
+ */
+export function ensureFileInputElement() {
+    try {
+        const tag = this.tagName?.toLowerCase() ?? "";
+        if (tag !== "input")
+            return false;
+        const type = String(this.type ?? "").toLowerCase();
+        return type === "file";
+    }
+    catch {
+        return false;
+    }
+}
+/** Attach File objects created from serialized payloads to an <input type="file">. */
+export function assignFilePayloadsToInputElement(payloads) {
+    try {
+        const input = this;
+        if (!input || input.tagName?.toLowerCase() !== "input")
+            return false;
+        if ((input.type ?? "").toLowerCase() !== "file")
+            return false;
+        const transfer = (() => {
+            try {
+                return new DataTransfer();
+            }
+            catch {
+                return null;
+            }
+        })();
+        if (!transfer)
+            return false;
+        const entries = Array.isArray(payloads) ? payloads : [];
+        for (const payload of entries) {
+            if (!payload)
+                continue;
+            const name = payload.name || "upload.bin";
+            const mimeType = payload.mimeType || "application/octet-stream";
+            const lastModified = typeof payload.lastModified === "number"
+                ? payload.lastModified
+                : Date.now();
+            const binary = window.atob(payload.base64 ?? "");
+            const bytes = new Uint8Array(binary.length);
+            for (let i = 0; i < binary.length; i += 1) {
+                bytes[i] = binary.charCodeAt(i);
+            }
+            const blob = new Blob([bytes], { type: mimeType });
+            const file = new File([blob], name, { type: mimeType, lastModified });
+            transfer.items.add(file);
+        }
+        input.files = transfer.files;
+        input.dispatchEvent(new Event("input", { bubbles: true }));
+        input.dispatchEvent(new Event("change", { bubbles: true }));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function dispatchDomClick(options) {
+    const opts = options ?? {};
+    try {
+        const event = new MouseEvent("click", {
+            bubbles: !!opts.bubbles,
+            cancelable: !!opts.cancelable,
+            composed: !!opts.composed,
+            detail: typeof opts.detail === "number" ? opts.detail : 1,
+            view: this?.ownerDocument?.defaultView ?? window,
+        });
+        this.dispatchEvent(event);
+    }
+    catch {
+        try {
+            // Fallback to native click if MouseEvent construction fails.
+            this.click();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+export function scrollElementToPercent(percent) {
+    const normalize = (value) => {
+        if (typeof value === "number" && Number.isFinite(value))
+            return value;
+        const str = String(value ?? "").trim();
+        if (!str)
+            return 0;
+        const numeric = parseFloat(str.replace("%", ""));
+        if (Number.isNaN(numeric) || !Number.isFinite(numeric))
+            return 0;
+        return numeric;
+    };
+    try {
+        const pct = Math.max(0, Math.min(normalize(percent), 100));
+        const element = this;
+        const tag = element.tagName?.toLowerCase() ?? "";
+        const scrollWindow = tag === "html" || tag === "body";
+        if (scrollWindow) {
+            const root = element.ownerDocument?.scrollingElement ||
+                element.ownerDocument?.documentElement ||
+                element.ownerDocument?.body ||
+                document.scrollingElement ||
+                document.documentElement ||
+                document.body;
+            const scrollHeight = root?.scrollHeight ?? document.body.scrollHeight ?? 0;
+            const viewportHeight = element.ownerDocument?.defaultView?.innerHeight ?? window.innerHeight;
+            const maxTop = Math.max(0, scrollHeight - viewportHeight);
+            const top = maxTop * (pct / 100);
+            element.ownerDocument?.defaultView?.scrollTo({
+                top,
+                left: element.ownerDocument?.defaultView?.scrollX ?? window.scrollX ?? 0,
+                behavior: "smooth",
+            });
+            return true;
+        }
+        const scrollHeight = element.scrollHeight ?? 0;
+        const clientHeight = element.clientHeight ?? 0;
+        const maxTop = Math.max(0, scrollHeight - clientHeight);
+        const top = maxTop * (pct / 100);
+        element.scrollTo({
+            top,
+            left: element.scrollLeft ?? 0,
+            behavior: "smooth",
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+const inputTypesToSetValue = new Set([
+    "color",
+    "date",
+    "datetime-local",
+    "month",
+    "range",
+    "time",
+    "week",
+]);
+const inputTypesToTypeInto = new Set([
+    "",
+    "email",
+    "number",
+    "password",
+    "search",
+    "tel",
+    "text",
+    "url",
+]);
+export function prepareElementForTyping() {
+    try {
+        const element = this;
+        if (!element.isConnected)
+            return false;
+        const doc = element.ownerDocument || document;
+        const win = doc.defaultView || window;
+        try {
+            if (typeof element.focus === "function") {
+                element.focus();
+            }
+        }
+        catch {
+            /* ignore */
+        }
+        if (element instanceof win.HTMLInputElement ||
+            element instanceof win.HTMLTextAreaElement) {
+            try {
+                if (typeof element.select === "function") {
+                    element.select();
+                    return true;
+                }
+            }
+            catch {
+                /* ignore */
+            }
+            try {
+                const length = (element.value ?? "").length;
+                if (typeof element.setSelectionRange === "function") {
+                    element.setSelectionRange(0, length);
+                    return true;
+                }
+            }
+            catch {
+                /* ignore */
+            }
+            return true;
+        }
+        if (element.isContentEditable) {
+            const selection = doc.getSelection?.();
+            const range = doc.createRange?.();
+            if (selection && range) {
+                try {
+                    range.selectNodeContents(element);
+                    selection.removeAllRanges();
+                    selection.addRange(range);
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            return true;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+export function fillElementValue(rawValue) {
+    const element = this;
+    if (!element.isConnected) {
+        return { status: "error", reason: "notconnected" };
+    }
+    const doc = element.ownerDocument || document;
+    const win = doc.defaultView || window;
+    let fallbackValue = rawValue ?? "";
+    try {
+        const dispatchInputAndChange = (eventValue) => {
+            let inputEvent;
+            if (typeof win.InputEvent === "function") {
+                try {
+                    inputEvent = new win.InputEvent("input", {
+                        bubbles: true,
+                        composed: true,
+                        data: eventValue,
+                        inputType: "insertText",
+                    });
+                }
+                catch {
+                    inputEvent = new win.Event("input", {
+                        bubbles: true,
+                        composed: true,
+                    });
+                }
+            }
+            else {
+                inputEvent = new win.Event("input", { bubbles: true, composed: true });
+            }
+            element.dispatchEvent(inputEvent);
+            const changeEvent = new win.Event("change", { bubbles: true });
+            element.dispatchEvent(changeEvent);
+        };
+        if (element instanceof win.HTMLInputElement) {
+            const type = (element.type || "").toLowerCase();
+            if (!inputTypesToTypeInto.has(type) && !inputTypesToSetValue.has(type)) {
+                return { status: "error", reason: `unsupported-input-type:${type}` };
+            }
+            let valueForTyping = rawValue;
+            if (type === "number") {
+                const trimmed = rawValue.trim();
+                if (trimmed !== "" && Number.isNaN(Number(trimmed))) {
+                    return { status: "error", reason: "invalid-number-value" };
+                }
+                valueForTyping = trimmed;
+            }
+            fallbackValue = valueForTyping;
+            if (inputTypesToSetValue.has(type)) {
+                const trimmed = rawValue.trim();
+                fallbackValue = trimmed;
+                prepareElementForTyping.call(element);
+                const prototype = win.HTMLInputElement.prototype;
+                const descriptor = Object.getOwnPropertyDescriptor(prototype, "value");
+                const nativeSetter = descriptor?.set;
+                if (typeof nativeSetter === "function") {
+                    nativeSetter.call(element, trimmed);
+                }
+                else {
+                    element.value = trimmed;
+                }
+                const tracker = element._valueTracker;
+                tracker?.setValue?.(trimmed);
+                if (element.value !== trimmed) {
+                    return { status: "error", reason: "malformed-value" };
+                }
+                dispatchInputAndChange(trimmed);
+                return { status: "done" };
+            }
+            prepareElementForTyping.call(element);
+            return { status: "needsinput", value: valueForTyping };
+        }
+        if (element instanceof win.HTMLTextAreaElement) {
+            prepareElementForTyping.call(element);
+            fallbackValue = rawValue;
+            return { status: "needsinput", value: rawValue };
+        }
+        if (element instanceof win.HTMLSelectElement) {
+            // Select elements use setInputFiles/selectOption instead.
+            return { status: "error", reason: "unsupported-element" };
+        }
+        if (element.isContentEditable) {
+            prepareElementForTyping.call(element);
+            fallbackValue = rawValue;
+            return { status: "needsinput", value: rawValue };
+        }
+        return { status: "error", reason: "unsupported-element" };
+    }
+    catch (error) {
+        let reason = "exception";
+        if (error && typeof error === "object") {
+            const message = error.message;
+            if (typeof message === "string" && message.trim().length > 0) {
+                reason = `exception:${message}`;
+            }
+        }
+        return { status: "needsinput", value: fallbackValue, reason };
+    }
+}
+export function focusElement() {
+    try {
+        if (typeof this.focus === "function") {
+            this.focus();
+        }
+    }
+    catch {
+        /* ignore */
+    }
+}
+export function selectElementOptions(rawValues) {
+    try {
+        if (!(this instanceof HTMLSelectElement))
+            return [];
+        const desired = Array.isArray(rawValues) ? rawValues : [rawValues];
+        const wanted = new Set(desired.map((v) => String(v ?? "").trim()));
+        const matches = (option) => {
+            const label = (option.label || option.textContent || "").trim();
+            const value = String(option.value ?? "").trim();
+            return wanted.has(label) || wanted.has(value);
+        };
+        if (this.multiple) {
+            for (const option of Array.from(this.options)) {
+                option.selected = matches(option);
+            }
+        }
+        else {
+            let chosen = false;
+            for (const option of Array.from(this.options)) {
+                if (!chosen && matches(option)) {
+                    option.selected = true;
+                    this.value = option.value;
+                    chosen = true;
+                }
+                else {
+                    option.selected = false;
+                }
+            }
+        }
+        const inputEvent = new Event("input", { bubbles: true });
+        const changeEvent = new Event("change", { bubbles: true });
+        this.dispatchEvent(inputEvent);
+        this.dispatchEvent(changeEvent);
+        return Array.from(this.selectedOptions).map((opt) => opt.value);
+    }
+    catch {
+        return [];
+    }
+}
+export function isElementVisible() {
+    try {
+        const element = this;
+        if (!element.isConnected)
+            return false;
+        const style = element.ownerDocument?.defaultView?.getComputedStyle(element) ??
+            window.getComputedStyle(element);
+        if (!style)
+            return false;
+        if (style.display === "none" || style.visibility === "hidden")
+            return false;
+        const opacity = parseFloat(style.opacity ?? "1");
+        if (!Number.isFinite(opacity) || opacity === 0)
+            return false;
+        const rect = element.getBoundingClientRect();
+        if (!rect)
+            return false;
+        if (Math.max(rect.width, rect.height) === 0)
+            return false;
+        if (element.getClientRects().length === 0)
+            return false;
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function isElementChecked() {
+    try {
+        const element = this;
+        const tag = (element.tagName || "").toLowerCase();
+        if (tag === "input") {
+            const type = element.type?.toLowerCase() ?? "";
+            if (type === "checkbox" || type === "radio") {
+                return !!element.checked;
+            }
+        }
+        const aria = element.getAttribute?.("aria-checked");
+        if (aria != null)
+            return aria === "true";
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+export function readElementInputValue() {
+    try {
+        const element = this;
+        const tag = (element.tagName || "").toLowerCase();
+        if (tag === "input" || tag === "textarea") {
+            return String(element.value ?? "");
+        }
+        if (tag === "select") {
+            return String(element.value ?? "");
+        }
+        if (element.isContentEditable) {
+            return String(element.textContent ?? "");
+        }
+        return "";
+    }
+    catch {
+        return "";
+    }
+}
+export function readElementTextContent() {
+    try {
+        return String(this.textContent ?? "");
+    }
+    catch {
+        return "";
+    }
+}
+export function readElementInnerHTML() {
+    try {
+        return String(this.innerHTML ?? "");
+    }
+    catch {
+        return "";
+    }
+}
+export function readElementInnerText() {
+    try {
+        const element = this;
+        const inner = element.innerText;
+        if (typeof inner === "string" && inner.length > 0) {
+            return inner;
+        }
+        const fallback = element.textContent;
+        return typeof fallback === "string" ? fallback : "";
+    }
+    catch {
+        return "";
+    }
+}
+//# sourceMappingURL=scripts.js.map

package/dist/esm/lib/v3/dom/locatorScripts/scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.js","sourceRoot":"","sources":["../../../../../../lib/v3/dom/locatorScripts/scripts.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * DOM-side helpers used by Locator Runtime.callFunctionOn invocations.\n *\n * NOTE: These functions run inside the page context. Keep them dependency-free\n * and resilient to exceptions (match the best-effort semantics of the old\n * inline string snippets).\n */\n\nexport interface ClickEventOptions {\n  bubbles?: boolean;\n  cancelable?: boolean;\n  composed?: boolean;\n  detail?: number;\n}\n\nexport function ensureFileInputElement(this: Element): boolean {\n  try {\n    const tag = (this as HTMLElement).tagName?.toLowerCase() ?? \"\";\n    if (tag !== \"input\") return false;\n    const type = String((this as HTMLInputElement).type ?? \"\").toLowerCase();\n    return type === \"file\";\n  } catch {\n    return false;\n  }\n}\n\nexport interface SerializedFilePayload {\n  name: string;\n  mimeType: string;\n  base64: string;\n  lastModified?: number;\n}\n\n/** Attach File objects created from serialized payloads to an <input type=\"file\">. */\nexport function assignFilePayloadsToInputElement(\n  this: Element,\n  payloads: SerializedFilePayload[],\n): boolean {\n  try {\n    const input = this as HTMLInputElement;\n    if (!input || input.tagName?.toLowerCase() !== \"input\") return false;\n    if ((input.type ?? \"\").toLowerCase() !== \"file\") return false;\n\n    const transfer: DataTransfer | null = (() => {\n      try {\n        return new DataTransfer();\n      } catch {\n        return null;\n      }\n    })();\n    if (!transfer) return false;\n\n    const entries = Array.isArray(payloads) ? payloads : [];\n    for (const payload of entries) {\n      if (!payload) continue;\n      const name = payload.name || \"upload.bin\";\n      const mimeType = payload.mimeType || \"application/octet-stream\";\n      const lastModified =\n        typeof payload.lastModified === \"number\"\n          ? payload.lastModified\n          : Date.now();\n\n      const binary = window.atob(payload.base64 ?? \"\");\n      const bytes = new Uint8Array(binary.length);\n      for (let i = 0; i < binary.length; i += 1) {\n        bytes[i] = binary.charCodeAt(i);\n      }\n      const blob = new Blob([bytes], { type: mimeType });\n      const file = new File([blob], name, { type: mimeType, lastModified });\n      transfer.items.add(file);\n    }\n\n    input.files = transfer.files;\n    input.dispatchEvent(new Event(\"input\", { bubbles: true }));\n    input.dispatchEvent(new Event(\"change\", { bubbles: true }));\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport function dispatchDomClick(\n  this: Element,\n  options?: ClickEventOptions,\n): void {\n  const opts = options ?? {};\n  try {\n    const event = new MouseEvent(\"click\", {\n      bubbles: !!opts.bubbles,\n      cancelable: !!opts.cancelable,\n      composed: !!opts.composed,\n      detail: typeof opts.detail === \"number\" ? opts.detail : 1,\n      view: this?.ownerDocument?.defaultView ?? window,\n    });\n    this.dispatchEvent(event);\n  } catch {\n    try {\n      // Fallback to native click if MouseEvent construction fails.\n      (this as HTMLElement).click();\n    } catch {\n      /* ignore */\n    }\n  }\n}\n\nexport function scrollElementToPercent(\n  this: Element,\n  percent: number | string,\n): boolean {\n  const normalize = (value: unknown): number => {\n    if (typeof value === \"number\" && Number.isFinite(value)) return value;\n    const str = String(value ?? \"\").trim();\n    if (!str) return 0;\n    const numeric = parseFloat(str.replace(\"%\", \"\"));\n    if (Number.isNaN(numeric) || !Number.isFinite(numeric)) return 0;\n    return numeric;\n  };\n\n  try {\n    const pct = Math.max(0, Math.min(normalize(percent), 100));\n    const element = this as HTMLElement;\n    const tag = element.tagName?.toLowerCase() ?? \"\";\n\n    const scrollWindow = tag === \"html\" || tag === \"body\";\n    if (scrollWindow) {\n      const root =\n        element.ownerDocument?.scrollingElement ||\n        element.ownerDocument?.documentElement ||\n        element.ownerDocument?.body ||\n        document.scrollingElement ||\n        document.documentElement ||\n        document.body;\n      const scrollHeight =\n        root?.scrollHeight ?? document.body.scrollHeight ?? 0;\n      const viewportHeight =\n        element.ownerDocument?.defaultView?.innerHeight ?? window.innerHeight;\n      const maxTop = Math.max(0, scrollHeight - viewportHeight);\n      const top = maxTop * (pct / 100);\n      element.ownerDocument?.defaultView?.scrollTo({\n        top,\n        left:\n          element.ownerDocument?.defaultView?.scrollX ?? window.scrollX ?? 0,\n        behavior: \"smooth\",\n      });\n      return true;\n    }\n\n    const scrollHeight = element.scrollHeight ?? 0;\n    const clientHeight = element.clientHeight ?? 0;\n    const maxTop = Math.max(0, scrollHeight - clientHeight);\n    const top = maxTop * (pct / 100);\n    element.scrollTo({\n      top,\n      left: element.scrollLeft ?? 0,\n      behavior: \"smooth\",\n    });\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nconst inputTypesToSetValue = new Set([\n  \"color\",\n  \"date\",\n  \"datetime-local\",\n  \"month\",\n  \"range\",\n  \"time\",\n  \"week\",\n]);\n\nconst inputTypesToTypeInto = new Set([\n  \"\",\n  \"email\",\n  \"number\",\n  \"password\",\n  \"search\",\n  \"tel\",\n  \"text\",\n  \"url\",\n]);\n\nexport type FillElementResult =\n  | { status: \"done\" }\n  | { status: \"needsinput\"; value: string; reason?: string }\n  | { status: \"error\"; reason: string };\n\nexport function prepareElementForTyping(this: Element): boolean {\n  try {\n    const element = this as HTMLElement;\n    if (!element.isConnected) return false;\n\n    const doc = element.ownerDocument || document;\n    const win = doc.defaultView || window;\n\n    try {\n      if (typeof element.focus === \"function\") {\n        element.focus();\n      }\n    } catch {\n      /* ignore */\n    }\n\n    if (\n      element instanceof win.HTMLInputElement ||\n      element instanceof win.HTMLTextAreaElement\n    ) {\n      try {\n        if (typeof element.select === \"function\") {\n          element.select();\n          return true;\n        }\n      } catch {\n        /* ignore */\n      }\n\n      try {\n        const length = (element.value ?? \"\").length;\n        if (typeof element.setSelectionRange === \"function\") {\n          element.setSelectionRange(0, length);\n          return true;\n        }\n      } catch {\n        /* ignore */\n      }\n\n      return true;\n    }\n\n    if (element.isContentEditable) {\n      const selection = doc.getSelection?.();\n      const range = doc.createRange?.();\n      if (selection && range) {\n        try {\n          range.selectNodeContents(element);\n          selection.removeAllRanges();\n          selection.addRange(range);\n        } catch {\n          /* ignore */\n        }\n      }\n      return true;\n    }\n\n    return false;\n  } catch {\n    return false;\n  }\n}\n\nexport function fillElementValue(\n  this: Element,\n  rawValue: string,\n): FillElementResult {\n  const element = this as HTMLElement;\n  if (!element.isConnected) {\n    return { status: \"error\", reason: \"notconnected\" };\n  }\n\n  const doc = element.ownerDocument || document;\n  const win = doc.defaultView || window;\n  let fallbackValue = rawValue ?? \"\";\n\n  try {\n    const dispatchInputAndChange = (eventValue: string): void => {\n      let inputEvent: Event;\n      if (typeof win.InputEvent === \"function\") {\n        try {\n          inputEvent = new win.InputEvent(\"input\", {\n            bubbles: true,\n            composed: true,\n            data: eventValue,\n            inputType: \"insertText\",\n          });\n        } catch {\n          inputEvent = new win.Event(\"input\", {\n            bubbles: true,\n            composed: true,\n          });\n        }\n      } else {\n        inputEvent = new win.Event(\"input\", { bubbles: true, composed: true });\n      }\n\n      element.dispatchEvent(inputEvent);\n\n      const changeEvent = new win.Event(\"change\", { bubbles: true });\n      element.dispatchEvent(changeEvent);\n    };\n\n    if (element instanceof win.HTMLInputElement) {\n      const type = (element.type || \"\").toLowerCase();\n\n      if (!inputTypesToTypeInto.has(type) && !inputTypesToSetValue.has(type)) {\n        return { status: \"error\", reason: `unsupported-input-type:${type}` };\n      }\n\n      let valueForTyping = rawValue;\n\n      if (type === \"number\") {\n        const trimmed = rawValue.trim();\n        if (trimmed !== \"\" && Number.isNaN(Number(trimmed))) {\n          return { status: \"error\", reason: \"invalid-number-value\" };\n        }\n        valueForTyping = trimmed;\n      }\n\n      fallbackValue = valueForTyping;\n\n      if (inputTypesToSetValue.has(type)) {\n        const trimmed = rawValue.trim();\n        fallbackValue = trimmed;\n        prepareElementForTyping.call(element);\n\n        const prototype = win.HTMLInputElement.prototype;\n        const descriptor = Object.getOwnPropertyDescriptor(prototype, \"value\");\n        const nativeSetter = descriptor?.set;\n\n        if (typeof nativeSetter === \"function\") {\n          nativeSetter.call(element, trimmed);\n        } else {\n          element.value = trimmed;\n        }\n\n        const tracker = (\n          element as unknown as {\n            _valueTracker?: { setValue?: (next: string) => void };\n          }\n        )._valueTracker;\n        tracker?.setValue?.(trimmed);\n\n        if (element.value !== trimmed) {\n          return { status: \"error\", reason: \"malformed-value\" };\n        }\n\n        dispatchInputAndChange(trimmed);\n        return { status: \"done\" };\n      }\n\n      prepareElementForTyping.call(element);\n      return { status: \"needsinput\", value: valueForTyping };\n    }\n\n    if (element instanceof win.HTMLTextAreaElement) {\n      prepareElementForTyping.call(element);\n      fallbackValue = rawValue;\n      return { status: \"needsinput\", value: rawValue };\n    }\n\n    if (element instanceof win.HTMLSelectElement) {\n      // Select elements use setInputFiles/selectOption instead.\n      return { status: \"error\", reason: \"unsupported-element\" };\n    }\n\n    if (element.isContentEditable) {\n      prepareElementForTyping.call(element);\n      fallbackValue = rawValue;\n      return { status: \"needsinput\", value: rawValue };\n    }\n\n    return { status: \"error\", reason: \"unsupported-element\" };\n  } catch (error) {\n    let reason = \"exception\";\n    if (error && typeof error === \"object\") {\n      const message = (error as { message?: unknown }).message;\n      if (typeof message === \"string\" && message.trim().length > 0) {\n        reason = `exception:${message}`;\n      }\n    }\n    return { status: \"needsinput\", value: fallbackValue, reason };\n  }\n}\n\nexport function focusElement(this: Element): void {\n  try {\n    if (typeof (this as HTMLElement).focus === \"function\") {\n      (this as HTMLElement).focus();\n    }\n  } catch {\n    /* ignore */\n  }\n}\n\nexport function selectElementOptions(\n  this: Element,\n  rawValues: string | string[],\n): string[] {\n  try {\n    if (!(this instanceof HTMLSelectElement)) return [];\n\n    const desired = Array.isArray(rawValues) ? rawValues : [rawValues];\n    const wanted = new Set(desired.map((v) => String(v ?? \"\").trim()));\n\n    const matches = (option: HTMLOptionElement): boolean => {\n      const label = (option.label || option.textContent || \"\").trim();\n      const value = String(option.value ?? \"\").trim();\n      return wanted.has(label) || wanted.has(value);\n    };\n\n    if (this.multiple) {\n      for (const option of Array.from(this.options)) {\n        option.selected = matches(option);\n      }\n    } else {\n      let chosen = false;\n      for (const option of Array.from(this.options)) {\n        if (!chosen && matches(option)) {\n          option.selected = true;\n          this.value = option.value;\n          chosen = true;\n        } else {\n          option.selected = false;\n        }\n      }\n    }\n\n    const inputEvent = new Event(\"input\", { bubbles: true });\n    const changeEvent = new Event(\"change\", { bubbles: true });\n    this.dispatchEvent(inputEvent);\n    this.dispatchEvent(changeEvent);\n\n    return Array.from(this.selectedOptions).map((opt) => opt.value);\n  } catch {\n    return [];\n  }\n}\n\nexport function isElementVisible(this: Element): boolean {\n  try {\n    const element = this as HTMLElement;\n    if (!element.isConnected) return false;\n\n    const style =\n      element.ownerDocument?.defaultView?.getComputedStyle(element) ??\n      window.getComputedStyle(element);\n    if (!style) return false;\n    if (style.display === \"none\" || style.visibility === \"hidden\") return false;\n    const opacity = parseFloat(style.opacity ?? \"1\");\n    if (!Number.isFinite(opacity) || opacity === 0) return false;\n\n    const rect = element.getBoundingClientRect();\n    if (!rect) return false;\n    if (Math.max(rect.width, rect.height) === 0) return false;\n\n    if (element.getClientRects().length === 0) return false;\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport function isElementChecked(this: Element): boolean {\n  try {\n    const element = this as HTMLElement;\n    const tag = (element.tagName || \"\").toLowerCase();\n    if (tag === \"input\") {\n      const type = (element as HTMLInputElement).type?.toLowerCase() ?? \"\";\n      if (type === \"checkbox\" || type === \"radio\") {\n        return !!(element as HTMLInputElement).checked;\n      }\n    }\n    const aria = element.getAttribute?.(\"aria-checked\");\n    if (aria != null) return aria === \"true\";\n    return false;\n  } catch {\n    return false;\n  }\n}\n\nexport function readElementInputValue(this: Element): string {\n  try {\n    const element = this as HTMLElement;\n    const tag = (element.tagName || \"\").toLowerCase();\n    if (tag === \"input\" || tag === \"textarea\") {\n      return String(\n        (element as HTMLInputElement | HTMLTextAreaElement).value ?? \"\",\n      );\n    }\n    if (tag === \"select\") {\n      return String((element as HTMLSelectElement).value ?? \"\");\n    }\n    if (element.isContentEditable) {\n      return String(element.textContent ?? \"\");\n    }\n    return \"\";\n  } catch {\n    return \"\";\n  }\n}\n\nexport function readElementTextContent(this: Element): string {\n  try {\n    return String(this.textContent ?? \"\");\n  } catch {\n    return \"\";\n  }\n}\n\nexport function readElementInnerHTML(this: Element): string {\n  try {\n    return String((this as HTMLElement).innerHTML ?? \"\");\n  } catch {\n    return \"\";\n  }\n}\n\nexport function readElementInnerText(this: Element): string {\n  try {\n    const element = this as HTMLElement;\n    const inner = (element as HTMLElement & { innerText?: unknown }).innerText;\n    if (typeof inner === \"string\" && inner.length > 0) {\n      return inner;\n    }\n    const fallback = element.textContent;\n    return typeof fallback === \"string\" ? fallback : \"\";\n  } catch {\n    return \"\";\n  }\n}\n"]}

package/dist/esm/lib/v3/dom/locatorScripts/selectors.d.ts

@@ -0,0 +1,4 @@
+export declare function resolveCssSelector(selectorRaw: string, targetIndexRaw?: number): Element | null;
+export declare function resolveCssSelectorPierce(selectorRaw: string, targetIndexRaw?: number): Element | null;
+export declare function resolveTextSelector(rawNeedle: string, targetIndexRaw?: number): Element | null;
+export declare function resolveXPathMainWorld(rawXp: string, targetIndexRaw?: number): Element | null;