@nexface/tools 0.1.15-alpha.1 → 0.1.15-alpha.11

package/dist/browser/actions.js

@@ -6,12 +6,22 @@ export function collectElementActions(actions, ref, element, role, label, state,
             return;
         const id = `a${actions.size + 1}`;
         actions.set(id, {
-            candidate: { id, operation, ref, role, label: (optionElement ? `${label} / ${option}` : label).slice(0, 500), state, ...(option === undefined ? {} : { option: option.slice(0, 500) }) },
+            candidate: {
+                id,
+                operation,
+                ref,
+                role,
+                label: (optionElement ? `${label} / ${option}` : label).slice(0, 500),
+                state,
+                ...(option === undefined ? {} : { option: option.slice(0, 500) }),
+            },
             command: { target, method, args },
             ...(optionElement ? { optionElement } : {}),
         });
     };
-    if (state.disabled || element.closest('[inert],[aria-disabled="true"]') || element.matches(":disabled"))
+    if (state.disabled ||
+        element.closest('[inert],[aria-disabled="true"]') ||
+        element.matches(":disabled"))
         return;
     if (scrollable) {
         if (element.scrollTop > 0)
@@ -30,18 +40,25 @@ export function collectElementActions(actions, ref, element, role, label, state,
             counts.set(option.value, (counts.get(option.value) ?? 0) + 1);
         for (const option of element.options) {
             if (element.multiple) {
-                if (counts.get(option.value) === 1 && !option.disabled && !option.closest("optgroup[disabled]")) {
+                if (counts.get(option.value) === 1 &&
+                    !option.disabled &&
+                    !option.closest("optgroup[disabled]")) {
                     add(option.selected ? "uncheck" : "check", "setOptionSelected", [option.value, !option.selected, option.label], option.label, option);
                 }
                 continue;
             }
-            if (counts.get(option.value) === 1 && !(element.required && option.value === "") && !option.disabled && !option.selected && !option.closest("optgroup[disabled]"))
+            if (counts.get(option.value) === 1 &&
+                !(element.required && option.value === "") &&
+                !option.disabled &&
+                !option.selected &&
+                !option.closest("optgroup[disabled]"))
                 add("select", "selectOption", [option.value], option.label);
         }
         return;
     }
-    if (role === "option" && element.closest('[role="listbox"]')?.getAttribute("aria-multiselectable") === "true"
-        && ["true", "false"].includes(element.getAttribute("aria-selected") ?? "")) {
+    if (role === "option" &&
+        element.closest('[role="listbox"]')?.getAttribute("aria-multiselectable") === "true" &&
+        ["true", "false"].includes(element.getAttribute("aria-selected") ?? "")) {
         const field = computeName(element.closest('[role="listbox"]'));
         label = field ? `${field} / ${label}` : label;
         add(state.selected ? "uncheck" : "check", state.selected ? "uncheck" : "check", []);
@@ -54,15 +71,23 @@ export function collectElementActions(actions, ref, element, role, label, state,
             add("uncheck", "uncheck", []);
         return;
     }
-    const editable = element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement || (element instanceof HTMLElement && element.isContentEditable);
-    if (editable && !("readOnly" in element && element.readOnly) && element.getAttribute("aria-readonly") !== "true" && ["textbox", "searchbox", "combobox", "spinbutton"].includes(role)) {
+    const editable = element instanceof HTMLInputElement ||
+        element instanceof HTMLTextAreaElement ||
+        (element instanceof HTMLElement && element.isContentEditable);
+    if (editable &&
+        !("readOnly" in element && element.readOnly) &&
+        element.getAttribute("aria-readonly") !== "true" &&
+        ["textbox", "searchbox", "combobox", "spinbutton"].includes(role)) {
         add("fill", "fill", []);
     }
     add("click", "click", []);
 }
 export function collectPageActions(actions) {
     const add = (id, operation, method, args) => {
-        actions.set(id, { candidate: { id, operation, label: operation, role: "page", state: {} }, command: { target: { type: "page" }, method, args } });
+        actions.set(id, {
+            candidate: { id, operation, label: operation, role: "page", state: {} },
+            command: { target: { type: "page" }, method, args },
+        });
     };
     if (window.scrollY > 0)
         add("pageUp", "scrollUp", "scrollBy", [{ y: -560 }]);
@@ -70,4 +95,3 @@ export function collectPageActions(actions) {
         add("pageDown", "scrollDown", "scrollBy", [{ y: 560 }]);
     add("wait", "wait", "waitForTimeout", [100]);
 }
-//# sourceMappingURL=actions.js.map

package/dist/browser/controller.js

@@ -20,11 +20,7 @@ const LOCATOR_METHODS = new Set([
     "text",
     "waitFor",
 ]);
-const PAGE_METHODS = new Set([
-    "scrollBy",
-    "waitForTimeout",
-    "waitForURL",
-]);
+const PAGE_METHODS = new Set(["scrollBy", "waitForTimeout", "waitForURL"]);
 const WAIT_FOR_URL_TIMEOUT_MS = 3_000;
 const URL_POLL_INTERVAL_MS = 50;
 const ACTION_METHODS = new Set([
@@ -65,7 +61,7 @@ function dispatchClickSequence(element) {
             message: "Click target does not have an uncovered hit point.",
         });
     }
-    const { element: hitTarget, clientX, clientY, } = hit;
+    const { element: hitTarget, clientX, clientY } = hit;
     const init = {
         bubbles: true,
         cancelable: true,
@@ -195,8 +191,7 @@ function validateArgs(command, maxChars) {
     }
     if (command.method === "selectOption") {
         if (command.args.length !== 1 ||
-            (typeof command.args[0] !== "string" &&
-                !Array.isArray(command.args[0]))) {
+            (typeof command.args[0] !== "string" && !Array.isArray(command.args[0]))) {
             throw invalidCommand("selectOption() requires a string or string array.");
         }
         if (Array.isArray(command.args[0]) &&
@@ -204,8 +199,11 @@ function validateArgs(command, maxChars) {
             throw invalidCommand("selectOption() array values must be strings.");
         }
     }
-    if (command.method === "setOptionSelected" && (command.args.length !== 3
-        || typeof command.args[0] !== "string" || typeof command.args[1] !== "boolean" || typeof command.args[2] !== "string")) {
+    if (command.method === "setOptionSelected" &&
+        (command.args.length !== 3 ||
+            typeof command.args[0] !== "string" ||
+            typeof command.args[1] !== "boolean" ||
+            typeof command.args[2] !== "string")) {
         throw invalidCommand("Invalid observed option selection.");
     }
     if (command.method === "waitFor") {
@@ -221,9 +219,7 @@ function validateArgs(command, maxChars) {
             throw invalidCommand("waitFor() state is invalid.");
         }
         if (value?.timeout !== undefined &&
-            (typeof value.timeout !== "number" ||
-                !Number.isFinite(value.timeout) ||
-                value.timeout < 0)) {
+            (typeof value.timeout !== "number" || !Number.isFinite(value.timeout) || value.timeout < 0)) {
             throw invalidCommand("waitFor() timeout is invalid.");
         }
     }
@@ -264,10 +260,8 @@ function validateArgs(command, maxChars) {
             Array.isArray(value) ||
             Object.keys(value).length === 0 ||
             Object.keys(value).some((key) => !["x", "y"].includes(key)) ||
-            (value.x !== undefined &&
-                (typeof value.x !== "number" || !Number.isFinite(value.x))) ||
-            (value.y !== undefined &&
-                (typeof value.y !== "number" || !Number.isFinite(value.y)))) {
+            (value.x !== undefined && (typeof value.x !== "number" || !Number.isFinite(value.x))) ||
+            (value.y !== undefined && (typeof value.y !== "number" || !Number.isFinite(value.y)))) {
             throw invalidCommand("scrollBy() requires finite numeric x/y values.");
         }
     }
@@ -281,8 +275,7 @@ function validateArgs(command, maxChars) {
             Object.keys(value).some((key) => !["left", "top"].includes(key)) ||
             (value.left !== undefined &&
                 (typeof value.left !== "number" || !Number.isFinite(value.left))) ||
-            (value.top !== undefined &&
-                (typeof value.top !== "number" || !Number.isFinite(value.top)))) {
+            (value.top !== undefined && (typeof value.top !== "number" || !Number.isFinite(value.top)))) {
             throw invalidCommand("scrollTo() requires finite numeric left/top values.");
         }
     }
@@ -340,9 +333,7 @@ export class PageController {
             throw invalidCommand("Command envelope is invalid.");
         }
         const record = this.executions.get(command.executionId);
-        if (!record ||
-            record.status !== "running" ||
-            record.abortController.signal.aborted) {
+        if (!record || record.status !== "running" || record.abortController.signal.aborted) {
             throw new PageCommandError({
                 code: "EXECUTION_CANCELLED",
                 message: "The execution is no longer active.",
@@ -393,15 +384,16 @@ export class PageController {
             record = this.requireActive(command);
             const value = command.target.type === "page"
                 ? await this.executePage(command, record)
-                : await this.executeTarget(command, record, beforeAction && (async () => {
-                    try {
-                        await beforeAction();
-                    }
-                    catch (error) {
-                        presentationFailed = true;
-                        throw error;
-                    }
-                }));
+                : await this.executeTarget(command, record, beforeAction &&
+                    (async () => {
+                        try {
+                            await beforeAction();
+                        }
+                        catch (error) {
+                            presentationFailed = true;
+                            throw error;
+                        }
+                    }));
             if (ACTION_METHODS.has(command.method) &&
                 !record.completedActions.some((action) => action.callIndex === command.commandSeq)) {
                 this.recordCompletedAction(record, command);
@@ -521,9 +513,7 @@ export class PageController {
         return record.registry.refs.get(command.target.ref);
     }
     locator(command) {
-        return command.target.type === "locator"
-            ? command.target.locator
-            : undefined;
+        return command.target.type === "locator" ? command.target.locator : undefined;
     }
     async executeTarget(command, record, beforeAction) {
         const signal = record.abortController.signal;
@@ -557,11 +547,7 @@ export class PageController {
             return null;
         }
         if (command.method === "text") {
-            const element = ref
-                ? requireValidRef(ref)
-                : locator
-                    ? requireUnique(locator)
-                    : undefined;
+            const element = ref ? requireValidRef(ref) : locator ? requireUnique(locator) : undefined;
             if (!element)
                 throw invalidCommand("Target is missing.");
             if (element instanceof HTMLInputElement ||
@@ -572,11 +558,7 @@ export class PageController {
             return normalizeText(element.textContent);
         }
         if (command.method === "scrollIntoView") {
-            const element = ref
-                ? requireValidRef(ref)
-                : locator
-                    ? requireUnique(locator)
-                    : undefined;
+            const element = ref ? requireValidRef(ref) : locator ? requireUnique(locator) : undefined;
             if (!element)
                 throw invalidCommand("Target is missing.");
             const beforeIdentity = createIdentity(element);
@@ -597,11 +579,7 @@ export class PageController {
             return null;
         }
         if (command.method === "scrollBy" || command.method === "scrollTo") {
-            const element = ref
-                ? ref.element
-                : locator
-                    ? requireUnique(locator)
-                    : undefined;
+            const element = ref ? ref.element : locator ? requireUnique(locator) : undefined;
             if (!(element instanceof HTMLElement)) {
                 throw new PageCommandError({
                     code: "UNSUPPORTED_OPERATION",
@@ -648,12 +626,8 @@ export class PageController {
             }
             else {
                 const value = command.args[0];
-                if ((value.left !== undefined &&
-                    value.left !== element.scrollLeft &&
-                    !scrollability.x) ||
-                    (value.top !== undefined &&
-                        value.top !== element.scrollTop &&
-                        !scrollability.y)) {
+                if ((value.left !== undefined && value.left !== element.scrollLeft && !scrollability.x) ||
+                    (value.top !== undefined && value.top !== element.scrollTop && !scrollability.y)) {
                     throw new PageCommandError({
                         code: "UNSUPPORTED_OPERATION",
                         message: "Requested axis does not have a scroll range.",
@@ -682,7 +656,9 @@ export class PageController {
         this.requireStillActive(record);
         const element = ref
             ? await prepareRefForAction(ref, signal)
-            : locator ? await prepareLocatorForAction(locator, signal) : undefined;
+            : locator
+                ? await prepareLocatorForAction(locator, signal)
+                : undefined;
         if (!element)
             throw invalidCommand("Target is missing.");
         this.requireStillActive(record);
@@ -692,9 +668,13 @@ export class PageController {
             await feedback;
         this.requireStillActive(record);
         await beforeAction?.();
-        if (!element.isConnected || createIdentity(element) !== identity
-            || (locator && requireUnique(locator) !== element)) {
-            throw new PageCommandError({ code: "REF_ACTION_FAILED", message: "Target changed before the action." });
+        if (!element.isConnected ||
+            createIdentity(element) !== identity ||
+            (locator && requireUnique(locator) !== element)) {
+            throw new PageCommandError({
+                code: "REF_ACTION_FAILED",
+                message: "Target changed before the action.",
+            });
         }
         ensureActionable(element);
         this.requireStillActive(record);
@@ -714,8 +694,7 @@ export class PageController {
         });
     }
     requireStillActive(record) {
-        if (record.status !== "running" ||
-            record.abortController.signal.aborted) {
+        if (record.status !== "running" || record.abortController.signal.aborted) {
             throw new PageCommandError({
                 code: "EXECUTION_CANCELLED",
                 message: "Execution was cancelled before the DOM action.",
@@ -729,8 +708,7 @@ export class PageController {
         }
         if (command.method === "fill") {
             const value = String(command.args[0] ?? "");
-            if ((element instanceof HTMLInputElement ||
-                element instanceof HTMLTextAreaElement) &&
+            if ((element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement) &&
                 !element.readOnly) {
                 focusForAgent(element);
                 setNativeValue(element, value);
@@ -749,21 +727,56 @@ export class PageController {
         }
         if (command.method === "press") {
             const key = String(command.args[0] ?? "");
-            element.dispatchEvent(new KeyboardEvent("keydown", { key, bubbles: true }));
-            element.dispatchEvent(new KeyboardEvent("keyup", { key, bubbles: true }));
+            const keyCodes = {
+                Backspace: 8,
+                Tab: 9,
+                Enter: 13,
+                Shift: 16,
+                Control: 17,
+                Alt: 18,
+                Escape: 27,
+                " ": 32,
+                PageUp: 33,
+                PageDown: 34,
+                End: 35,
+                Home: 36,
+                ArrowLeft: 37,
+                ArrowUp: 38,
+                ArrowRight: 39,
+                ArrowDown: 40,
+                Delete: 46,
+            };
+            const keyCode = keyCodes[key] ?? (/^[a-z0-9]$/i.test(key) ? key.toUpperCase().charCodeAt(0) : 0);
+            const code = /^[a-z]$/i.test(key)
+                ? `Key${key.toUpperCase()}`
+                : /^[0-9]$/.test(key)
+                    ? `Digit${key}`
+                    : key === " "
+                        ? "Space"
+                        : key;
+            const init = {
+                key,
+                code,
+                keyCode,
+                which: keyCode,
+                bubbles: true,
+                cancelable: true,
+                composed: true,
+            };
+            element.dispatchEvent(new KeyboardEvent("keydown", init));
+            element.dispatchEvent(new KeyboardEvent("keyup", init));
             return null;
         }
         if (command.method === "check" || command.method === "uncheck") {
             const checked = command.method === "check";
-            if (element.getAttribute("role") === "option"
-                && element.closest('[role="listbox"]')?.getAttribute("aria-multiselectable") === "true"
-                && ["true", "false"].includes(element.getAttribute("aria-selected") ?? "")) {
+            if (element.getAttribute("role") === "option" &&
+                element.closest('[role="listbox"]')?.getAttribute("aria-multiselectable") === "true" &&
+                ["true", "false"].includes(element.getAttribute("aria-selected") ?? "")) {
                 if ((element.getAttribute("aria-selected") === "true") !== checked)
                     dispatchClickSequence(element);
                 return null;
             }
-            if (element instanceof HTMLInputElement &&
-                ["checkbox", "radio"].includes(element.type)) {
+            if (element instanceof HTMLInputElement && ["checkbox", "radio"].includes(element.type)) {
                 if (element.type === "radio" && !checked) {
                     throw new PageCommandError({
                         code: "UNSUPPORTED_OPERATION",
@@ -789,9 +802,14 @@ export class PageController {
         if (command.method === "setOptionSelected") {
             const [value, selected, label] = command.args;
             const options = element instanceof HTMLSelectElement && element.multiple
-                ? [...element.options].filter((option) => option.value === value) : [];
+                ? [...element.options].filter((option) => option.value === value)
+                : [];
             const option = options[0];
-            if (options.length !== 1 || !option || option.label !== label || option.disabled || option.closest("optgroup[disabled]")) {
+            if (options.length !== 1 ||
+                !option ||
+                option.label !== label ||
+                option.disabled ||
+                option.closest("optgroup[disabled]")) {
                 throw invalidCommand("The observed multiple-select option is no longer available.");
             }
             if (option.selected !== selected) {
@@ -808,9 +826,7 @@ export class PageController {
                 });
             }
             const requested = command.args[0];
-            const values = Array.isArray(requested)
-                ? requested.map(String)
-                : [String(requested ?? "")];
+            const values = Array.isArray(requested) ? requested.map(String) : [String(requested ?? "")];
             const availableValues = new Set(Array.from(element.options, (option) => option.value));
             const missing = values.filter((value) => !availableValues.has(value));
             if (missing.length > 0) {
@@ -841,4 +857,3 @@ export class PageController {
         throw invalidCommand(`Unsupported locator method: ${command.method}`);
     }
 }
-//# sourceMappingURL=controller.js.map

package/dist/browser/diagnostics.js

@@ -11,10 +11,15 @@ export async function measurePagePhase(phase, execute) {
     }
     finally {
         try {
-            performance.measure("nexface.browser.phase", { start, end: performance.now(), detail: { phase, status } });
+            performance.measure("nexface.browser.phase", {
+                start,
+                end: performance.now(),
+                detail: { phase, status },
+            });
             performance.clearMeasures("nexface.browser.phase");
         }
-        catch { /* Diagnostics must never interrupt execution. */ }
+        catch {
+            /* Diagnostics must never interrupt execution. */
+        }
     }
 }
-//# sourceMappingURL=diagnostics.js.map

package/dist/browser/dom.js

@@ -108,9 +108,7 @@ export function* walkComposedElements(root = document) {
 function hasGenericInteractionEvidence(element) {
     if (!(element instanceof HTMLElement))
         return false;
-    return (element.tabIndex >= 0 ||
-        element.hasAttribute("onclick") ||
-        element.isContentEditable);
+    return element.tabIndex >= 0 || element.hasAttribute("onclick") || element.isContentEditable;
 }
 export function computeRole(element) {
     const explicit = normalizeText(element.getAttribute("role"))
@@ -146,9 +144,7 @@ export function computeRole(element) {
 }
 function referencedText(element, attribute) {
     const root = element.getRootNode();
-    const ids = normalizeText(element.getAttribute(attribute))
-        .split(" ")
-        .filter(Boolean);
+    const ids = normalizeText(element.getAttribute(attribute)).split(" ").filter(Boolean);
     return normalizeText(ids
         .map((id) => {
         if (root instanceof Document || root instanceof ShadowRoot) {
@@ -187,24 +183,14 @@ export function computeNameInfo(element) {
         if (caption)
             return { value: caption, source: "explicit" };
     }
-    if (element instanceof HTMLInputElement &&
-        ["button", "submit", "reset"].includes(element.type)) {
+    if (element instanceof HTMLInputElement && ["button", "submit", "reset"].includes(element.type)) {
         const value = normalizeText(element.value);
         if (value)
             return { value, source: "fallback" };
     }
     const role = computeRole(element);
     if (isActionableRole(role) ||
-        [
-            "cell",
-            "columnheader",
-            "heading",
-            "listitem",
-            "option",
-            "row",
-            "tab",
-            "treeitem",
-        ].includes(role)) {
+        ["cell", "columnheader", "heading", "listitem", "option", "row", "tab", "treeitem"].includes(role)) {
         const content = normalizeText(element.textContent);
         if (content)
             return { value: content, source: "content" };
@@ -212,8 +198,7 @@ export function computeNameInfo(element) {
     const title = normalizeText(element.getAttribute("title"));
     if (title)
         return { value: title, source: "fallback" };
-    if (element instanceof HTMLInputElement ||
-        element instanceof HTMLTextAreaElement) {
+    if (element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement) {
         return {
             value: normalizeText(element.placeholder),
             source: "fallback",
@@ -228,10 +213,8 @@ const SCROLLABLE_OVERFLOW = new Set(["auto", "scroll", "overlay", "hidden"]);
 export function getElementScrollability(element, style = getComputedStyle(element)) {
     if (!(element instanceof HTMLElement))
         return undefined;
-    const x = SCROLLABLE_OVERFLOW.has(style.overflowX) &&
-        element.scrollWidth > element.clientWidth + 2;
-    const y = SCROLLABLE_OVERFLOW.has(style.overflowY) &&
-        element.scrollHeight > element.clientHeight + 2;
+    const x = SCROLLABLE_OVERFLOW.has(style.overflowX) && element.scrollWidth > element.clientWidth + 2;
+    const y = SCROLLABLE_OVERFLOW.has(style.overflowY) && element.scrollHeight > element.clientHeight + 2;
     if (!x && !y)
         return undefined;
     return {
@@ -329,7 +312,10 @@ export function computeState(element) {
     if (element instanceof HTMLSelectElement) {
         if (element.multiple) {
             state.multiple = true;
-            state.selectedOptions = [...element.selectedOptions].map((option) => ({ value: option.value, label: normalizeText(option.label) }));
+            state.selectedOptions = [...element.selectedOptions].map((option) => ({
+                value: option.value,
+                label: normalizeText(option.label),
+            }));
         }
         if (element.value)
             state.value = element.value;
@@ -367,11 +353,20 @@ export function findSemanticContext(element) {
     }
     return {};
 }
+function composedTextContent(node) {
+    if (node instanceof Text)
+        return node.data;
+    if (!(node instanceof Element))
+        return "";
+    return composedChildren(node).map(composedTextContent).join("");
+}
 export function createIdentity(element) {
     const context = findSemanticContext(element);
+    const role = computeRole(element);
+    const name = computeName(element) || (!role ? composedTextContent(element) : "");
     return JSON.stringify([
-        computeRole(element),
-        normalizeText(computeName(element)),
+        role,
+        normalizeText(name),
         context.role ?? "",
         normalizeText(context.text),
     ]);
@@ -382,8 +377,7 @@ export function isElementRendered(element, style = getComputedStyle(element)) {
     }
     if (isAgentIgnored(element))
         return false;
-    if (element.hasAttribute("hidden") ||
-        element.getAttribute("aria-hidden") === "true") {
+    if (element.hasAttribute("hidden") || element.getAttribute("aria-hidden") === "true") {
         return false;
     }
     return style.display !== "none" && style.visibility !== "hidden";
@@ -442,4 +436,3 @@ export function matchesText(value, matcher, exact = false) {
     const expected = normalizeText(matcher);
     return exact ? normalized === expected : normalized.includes(expected);
 }
-//# sourceMappingURL=dom.js.map

package/dist/browser/feedback.js

@@ -5,10 +5,11 @@ export class ActionFeedback {
         this.assertActive?.();
         const read = ["text", "exists", "waitFor", "waitForTimeout", "waitForURL"].includes(action);
         const scroll = ["scrollBy", "scrollTo", "scrollIntoView"].includes(action);
-        return this.listener?.(scroll ? {} : {
-            effect: read ? "read" : "action",
-            ...(!read && target ? { target } : {}),
-        });
+        return this.listener?.(scroll
+            ? {}
+            : {
+                effect: read ? "read" : "action",
+                ...(!read && target ? { target } : {}),
+            });
     }
 }
-//# sourceMappingURL=feedback.js.map

package/dist/browser/focus.d.ts

@@ -1,4 +1,3 @@
 export declare function isAgentActivation(): boolean;
 export declare function withAgentActivation<T>(activate: () => T): T;
-export declare function isAgentFocus(): boolean;
 export declare function focusForAgent(element: HTMLElement): void;

package/dist/browser/focus.js

@@ -1,4 +1,3 @@
-let focusingForAgent = false;
 let activatingForAgent = false;
 export function isAgentActivation() {
     return activatingForAgent;
@@ -13,17 +12,6 @@ export function withAgentActivation(activate) {
         activatingForAgent = previous;
     }
 }
-export function isAgentFocus() {
-    return focusingForAgent;
-}
 export function focusForAgent(element) {
-    const previous = focusingForAgent;
-    focusingForAgent = true;
-    try {
-        element.focus({ preventScroll: true });
-    }
-    finally {
-        focusingForAgent = previous;
-    }
+    element.focus({ preventScroll: true });
 }
-//# sourceMappingURL=focus.js.map

package/dist/browser/locator.js

@@ -123,7 +123,7 @@ function animationFrame(signal) {
             reject(abortError());
             return;
         }
-        requestAnimationFrame(() => signal.aborted ? reject(abortError()) : resolve());
+        requestAnimationFrame(() => (signal.aborted ? reject(abortError()) : resolve()));
     });
 }
 async function waitForStable(element, signal) {
@@ -159,15 +159,10 @@ function ensureNotCovered(element) {
     });
 }
 export function findElementHitTarget(element) {
-    const candidates = [
-        element,
-        ...Array.from(walkComposedElements(element)).slice(0, 127),
-    ].filter((candidate) => !isAgentIgnored(candidate));
+    const candidates = [element, ...Array.from(walkComposedElements(element)).slice(0, 127)].filter((candidate) => !isAgentIgnored(candidate));
     for (const candidate of candidates) {
         const clientRects = Array.from(candidate.getClientRects()).filter((rect) => rect.width > 0 && rect.height > 0);
-        const rects = clientRects.length > 0
-            ? clientRects
-            : [candidate.getBoundingClientRect()];
+        const rects = clientRects.length > 0 ? clientRects : [candidate.getBoundingClientRect()];
         for (const rect of rects) {
             const left = Math.max(0, rect.left);
             const right = Math.min(window.innerWidth, rect.right);
@@ -274,4 +269,3 @@ export function requireValidRef(target) {
     validateIdentity(target);
     return target.element;
 }
-//# sourceMappingURL=locator.js.map