@geometra/proxy 1.65.0 → 1.65.2

package/dist/dom-actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dom-actions.d.ts","sourceRoot":"","sources":["../src/dom-actions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dom-actions.d.ts","sourceRoot":"","sources":["../src/dom-actions.ts"],"names":[],"mappings":"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"}

package/dist/dom-actions.js

@@ -527,6 +527,65 @@ async function assertPointMutable(page, x, y, intent, action) {
         await element.dispose();
     }
 }
+async function elementOwnsPagePoint(element, x, y) {
+    try {
+        const bounds = await element.boundingBox();
+        if (!bounds || bounds.width <= 0 || bounds.height <= 0 ||
+            x < bounds.x || y < bounds.y || x >= bounds.x + bounds.width || y >= bounds.y + bounds.height) {
+            return false;
+        }
+        return await element.evaluate((target, payload) => {
+            const rect = target.getBoundingClientRect();
+            if (rect.width <= 0 || rect.height <= 0)
+                return false;
+            const clientX = rect.left + ((payload.x - payload.bounds.x) / payload.bounds.width) * rect.width;
+            const clientY = rect.top + ((payload.y - payload.bounds.y) / payload.bounds.height) * rect.height;
+            const hit = document.elementFromPoint(clientX, clientY);
+            return hit === target || (hit !== null && target.contains(hit));
+        }, { x, y, bounds });
+    }
+    catch {
+        return false;
+    }
+}
+async function frameChainOwnsPagePoint(frame, x, y) {
+    let current = frame;
+    while (true) {
+        const parent = current.parentFrame();
+        if (!parent)
+            return true;
+        let frameElement = null;
+        try {
+            frameElement = await current.frameElement();
+            if (!(await elementOwnsPagePoint(frameElement, x, y)))
+                return false;
+        }
+        catch {
+            return false;
+        }
+        finally {
+            await frameElement?.dispose();
+        }
+        current = parent;
+    }
+}
+async function nativeSelectAtPoint(page, x, y) {
+    for (const frame of page.frames()) {
+        const selects = await frame.locator('select').elementHandles();
+        let match = null;
+        for (const select of selects) {
+            if (!match && await elementOwnsPagePoint(select, x, y) && await frameChainOwnsPagePoint(frame, x, y)) {
+                match = select;
+            }
+            else {
+                await select.dispose();
+            }
+        }
+        if (match)
+            return match;
+    }
+    return null;
+}
 async function locatorAnchorY(locator) {
     const bounds = await locator.boundingBox();
     return bounds ? bounds.y + bounds.height / 2 : undefined;
@@ -3332,7 +3391,7 @@ async function clearAmbiguousRetainedFiles(handle, actualNames, initialNames) {
     }
     return 'the changed selection was cleared best-effort without trying another candidate';
 }
-async function commitFilesToExactInput(handle, paths, targetName) {
+async function commitFilesToExactInput(handle, paths, targetName, setFiles = async (selectedPaths) => handle.setInputFiles(selectedPaths)) {
     const { guard, initial } = await beginFileInputCommitGuard(handle);
     try {
         if (!initial.validFileInput) {
@@ -3352,7 +3411,7 @@ async function commitFilesToExactInput(handle, paths, targetName) {
         }
         let operationError;
         try {
-            await handle.setInputFiles(paths);
+            await setFiles(paths);
         }
         catch (error) {
             operationError = error;
@@ -3426,7 +3485,16 @@ async function attachViaChooser(page, paths, clickX, clickY) {
         page.mouse.click(clickX, clickY),
     ]);
     const input = chooser.element();
-    await commitFilesToExactInput(input, paths, 'chooser input');
+    try {
+        await commitFilesToExactInput(input, paths, 'chooser input', async (selectedPaths) => {
+            await chooser.setFiles(selectedPaths);
+        });
+    }
+    finally {
+        // Playwright transfers ownership of this ElementHandle to the file-chooser
+        // listener. Release it on success and every preflight/error path.
+        await input.dispose().catch(() => { });
+    }
 }
 /**
  * Map common file extensions to MIME types so react-dropzone's `accept` filter
@@ -4085,13 +4153,18 @@ async function locatorCurrentValue(locator) {
 function normalizedFieldValue(value) {
     return value.replace(/\s+/g, ' ').trim().toLowerCase();
 }
-function fieldValueMatches(actual, expected) {
+function fieldValueMatches(actual, expected, inputType) {
     if (!actual)
         return false;
     const normalizedActual = normalizedFieldValue(actual);
     const normalizedExpected = normalizedFieldValue(expected);
     if (!normalizedActual || !normalizedExpected)
         return false;
+    if (inputType?.toLowerCase() === 'tel') {
+        const actualDigits = normalizedActual.replace(/\D/g, '');
+        const expectedDigits = normalizedExpected.replace(/\D/g, '');
+        return actualDigits.length > 0 && actualDigits === expectedDigits;
+    }
     return normalizedActual === normalizedExpected;
 }
 async function setLocatorTextValue(locator, value, opts) {
@@ -5347,10 +5420,10 @@ export async function setFieldText(page, fieldLabel, value, opts) {
     }
     await delay(40);
     const current = await locatorCurrentValue(locator);
-    if (fieldValueMatches(current, normalized))
+    if (fieldValueMatches(current, normalized, inputType))
         return;
     const displayed = await locatorDisplayedValues(locator);
-    if (displayed.some(candidate => fieldValueMatches(candidate, normalized)))
+    if (displayed.some(candidate => fieldValueMatches(candidate, normalized, inputType)))
         return;
     throw new Error(`setFieldText: set "${fieldLabel}" but could not confirm value ${JSON.stringify(value)}`);
 }
@@ -6009,52 +6082,119 @@ export async function selectNativeOption(page, x, y, opt) {
     if (opt.index !== undefined && (!Number.isFinite(opt.index) || !Number.isInteger(opt.index) || opt.index < 0)) {
         throw new Error('selectOption: index must be a non-negative integer');
     }
-    await assertPointMutable(page, x, y, 'select', 'selectOption');
-    await page.mouse.click(x, y);
-    await delay(40);
-    for (const frame of page.frames()) {
-        const applied = await frame.evaluate(async (payload) => {
+    const select = await nativeSelectAtPoint(page, x, y);
+    if (!select) {
+        throw new Error('selectOption: supplied coordinates do not target a native <select>');
+    }
+    const payload = {
+        value: opt.value ?? null,
+        label: opt.label ?? null,
+        index: typeof opt.index === 'number' && Number.isFinite(opt.index) ? opt.index : undefined,
+    };
+    try {
+        const reason = await select.evaluate(mutationBlockReasonInPage, 'select');
+        if (reason)
+            throw new Error(`selectOption: matched control is not mutable (${reason})`);
+        const optionReady = await select.evaluate((target, requested) => {
+            if (!(target instanceof HTMLSelectElement))
+                return false;
             const normalize = (input) => input?.replace(/\s+/g, ' ').trim().toLowerCase() ?? '';
             const enabled = (o) => !o.disabled && !(o.parentElement instanceof HTMLOptGroupElement && o.parentElement.disabled);
             const optionMatchesPayload = (o) => {
                 if (o.disabled || (o.parentElement instanceof HTMLOptGroupElement && o.parentElement.disabled))
                     return false;
-                if (payload.value !== null && normalize(o.value) !== normalize(payload.value))
+                if (requested.value !== null && normalize(o.value) !== normalize(requested.value))
                     return false;
-                if (payload.label !== null && normalize(o.textContent) !== normalize(payload.label))
+                if (requested.label !== null && normalize(o.textContent) !== normalize(requested.label))
                     return false;
-                if (payload.index !== undefined && o.index !== payload.index)
+                if (requested.index !== undefined && o.index !== requested.index)
                     return false;
                 return true;
             };
-            const a = document.activeElement;
-            if (!a || a.tagName !== 'SELECT')
-                return false;
-            const sel = a;
-            if (sel.matches(':disabled') || sel.getAttribute('aria-disabled') === 'true' || sel.getAttribute('aria-readonly') === 'true')
+            const candidate = requested.index !== undefined
+                ? target.options.item(requested.index)
+                : Array.from(target.options).find(optionMatchesPayload) ?? null;
+            return !!candidate && enabled(candidate) && optionMatchesPayload(candidate);
+        }, payload);
+        if (!optionReady) {
+            throw new Error('selectOption: no enabled <option> matches the requested identity');
+        }
+        const applied = await select.evaluate(async (target, requested) => {
+            if (!(target instanceof HTMLSelectElement))
                 return false;
-            if (sel.closest('[inert], [aria-disabled="true"], [aria-readonly="true"]'))
+            function commitMutationBlockReason(control) {
+                function composedParent(node) {
+                    if (node.parentElement)
+                        return node.parentElement;
+                    const root = node.getRootNode();
+                    return root instanceof ShadowRoot ? root.host : null;
+                }
+                function composedDescendantOf(node, ancestor) {
+                    let current = node;
+                    while (current) {
+                        if (current === ancestor)
+                            return true;
+                        current = composedParent(current);
+                    }
+                    return false;
+                }
+                try {
+                    if (control.matches(':disabled'))
+                        return 'disabled';
+                }
+                catch { /* non-HTML namespaces may reject pseudo classes */ }
+                let current = control;
+                while (current) {
+                    if (current.hasAttribute('inert'))
+                        return 'inert';
+                    if (current.getAttribute('aria-disabled')?.trim().toLowerCase() === 'true')
+                        return 'aria-disabled';
+                    if (current.getAttribute('aria-readonly')?.trim().toLowerCase() === 'true')
+                        return 'aria-readonly';
+                    if (current instanceof HTMLFieldSetElement && current.disabled) {
+                        const firstLegend = Array.from(current.children).find(child => child instanceof HTMLLegendElement);
+                        if (!(firstLegend instanceof HTMLLegendElement) || !composedDescendantOf(control, firstLegend)) {
+                            return 'disabled fieldset';
+                        }
+                    }
+                    current = composedParent(current);
+                }
+                return null;
+            }
+            if (commitMutationBlockReason(target))
                 return false;
-            const candidate = payload.index !== undefined
-                ? sel.options.item(payload.index)
-                : Array.from(sel.options).find(optionMatchesPayload) ?? null;
+            const normalize = (input) => input?.replace(/\s+/g, ' ').trim().toLowerCase() ?? '';
+            const enabled = (o) => !o.disabled && !(o.parentElement instanceof HTMLOptGroupElement && o.parentElement.disabled);
+            const optionMatchesPayload = (o) => {
+                if (!enabled(o))
+                    return false;
+                if (requested.value !== null && normalize(o.value) !== normalize(requested.value))
+                    return false;
+                if (requested.label !== null && normalize(o.textContent) !== normalize(requested.label))
+                    return false;
+                if (requested.index !== undefined && o.index !== requested.index)
+                    return false;
+                return true;
+            };
+            const candidate = requested.index !== undefined
+                ? target.options.item(requested.index)
+                : Array.from(target.options).find(optionMatchesPayload) ?? null;
             if (!candidate || !enabled(candidate) || !optionMatchesPayload(candidate))
                 return false;
-            sel.selectedIndex = candidate.index;
-            sel.dispatchEvent(new Event('input', { bubbles: true }));
-            sel.dispatchEvent(new Event('change', { bubbles: true }));
+            target.selectedIndex = candidate.index;
+            target.dispatchEvent(new Event('input', { bubbles: true }));
+            target.dispatchEvent(new Event('change', { bubbles: true }));
             await new Promise(resolveTimer => setTimeout(resolveTimer, 40));
-            const selected = sel.selectedOptions[0];
-            return sel.selectedIndex === candidate.index && selected === candidate && optionMatchesPayload(selected);
-        }, {
-            value: opt.value ?? null,
-            label: opt.label ?? null,
-            index: typeof opt.index === 'number' && Number.isFinite(opt.index) ? opt.index : undefined,
-        });
+            const selected = target.selectedOptions[0];
+            return target.selectedIndex === candidate.index && selected === candidate && optionMatchesPayload(selected);
+        }, payload);
         if (applied)
             return;
     }
-    throw new Error('selectOption: no focused <select> after click — use geometra_pick_listbox_option for custom dropdowns');
+    finally {
+        await select.dispose();
+    }
+    throw new Error('selectOption: native <select> or requested option changed before commit');
 }
 /**
  * Custom listbox / combobox (ARIA): optional click to open, then `getByRole('option')`.