wavexis 2.2.1__tar.gz → 2.2.2__tar.gz

{wavexis-2.2.1 → wavexis-2.2.2}/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to wavexis are documented in this file.
 
+## v2.2.2 — 2026-07-07
+
+### Added
+
+- Auto scroll-into-view before `click`, `fill`, and `hover` in both CDP and BiDi backends
+- `_scroll_into_view_if_needed` helper checks if element is in viewport and scrolls if needed
+
 ## v2.2.1 — 2026-07-07
 
 ### Added

{wavexis-2.2.1 → wavexis-2.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wavexis
-Version: 2.2.1
+Version: 2.2.2
 Summary: Browser automation CLI — wraps cdpwave and bidiwave, no Node.js, no Chromium download
 Project-URL: Homepage, https://github.com/MathiasPaulenko/wavexis
 Project-URL: Repository, https://github.com/MathiasPaulenko/wavexis

{wavexis-2.2.1 → wavexis-2.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "wavexis"
-version = "2.2.1"
+version = "2.2.2"
 description = "Browser automation CLI — wraps cdpwave and bidiwave, no Node.js, no Chromium download"
 readme = "README.md"
 license = { text = "MIT" }

{wavexis-2.2.1 → wavexis-2.2.2}/wavexis/__init__.py

@@ -1,3 +1,3 @@
 """wavexis — CLI de automatización de navegador."""
 
-__version__ = "2.2.1"
+__version__ = "2.2.2"

{wavexis-2.2.1 → wavexis-2.2.2}/wavexis/backend/bidi.py

@@ -807,19 +807,32 @@ class BiDiBackend(AbstractBackend):
 
     # ── Input ──────────────────────────────────────────────
 
+    async def _scroll_into_view_if_needed(self, selector: str) -> None:
+        """Scroll element into view if it's not visible in the viewport."""
+        client = self._require_client()
+        escaped = selector.replace("'", "\\'")
+        js = (
+            f"(function(){{var el=document.querySelector('{escaped}');"
+            f"if(!el)return;var rect=el.getBoundingClientRect();"
+            f"if(rect.top<0||rect.bottom>window.innerHeight||"
+            f"rect.left<0||rect.right>window.innerWidth)"
+            f"el.scrollIntoView({{block:'center',behavior:'instant'}});}})()"
+        )
+        await client.script.evaluate(self._context, js)
+
     async def click(
         self, selector: str, button: str = "left", click_count: int = 1
     ) -> None:
         """Click an element via BiDi script.evaluate."""
-        if self._client is None or self._context is None:
-            raise RuntimeError("BiDiBackend not launched. Call launch() first.")
+        client = self._require_client()
+        await self._scroll_into_view_if_needed(selector)
         escaped = selector.replace("'", "\\'")
         js = (
             f"document.querySelector('{escaped}')"
             f".dispatchEvent(new MouseEvent('click',{{bubbles:true}}))"
         )
         for _ in range(click_count):
-            await self._client.script.evaluate(self._context, js)
+            await client.script.evaluate(self._context, js)
 
     async def type_text(self, selector: str, text: str, delay: int = 0) -> None:
         """Type text into an element via BiDi."""
@@ -843,12 +856,12 @@ class BiDiBackend(AbstractBackend):
 
     async def fill(self, selector: str, value: str) -> None:
         """Fill an input element with a value via BiDi."""
-        if self._client is None or self._context is None:
-            raise RuntimeError("BiDiBackend not launched. Call launch() first.")
+        client = self._require_client()
+        await self._scroll_into_view_if_needed(selector)
         escaped = selector.replace("'", "\\'")
         escaped_val = value.replace("\\", "\\\\").replace("'", "\\'")
         js = f"document.querySelector('{escaped}').value = '{escaped_val}'"
-        await self._client.script.evaluate(self._context, js)
+        await client.script.evaluate(self._context, js)
 
     async def select_option(self, selector: str, value: str) -> None:
         """Select an option in a <select> element by value via BiDi."""
@@ -861,15 +874,15 @@ class BiDiBackend(AbstractBackend):
 
     async def hover(self, selector: str) -> None:
         """Hover over an element via BiDi script.evaluate."""
-        if self._client is None or self._context is None:
-            raise RuntimeError("BiDiBackend not launched. Call launch() first.")
+        client = self._require_client()
+        await self._scroll_into_view_if_needed(selector)
         escaped = selector.replace("'", "\\'")
         js = (
             f"var el=document.querySelector('{escaped}');"
             f"el.dispatchEvent(new MouseEvent('mouseover',{{bubbles:true}}));"
             f"el.dispatchEvent(new MouseEvent('mousemove',{{bubbles:true}}))"
         )
-        await self._client.script.evaluate(self._context, js)
+        await client.script.evaluate(self._context, js)
 
     async def key_press(self, key: str) -> None:
         """Press a keyboard key via BiDi script.evaluate."""

{wavexis-2.2.1 → wavexis-2.2.2}/wavexis/backend/cdp.py

@@ -1026,6 +1026,23 @@ class CDPBackend(AbstractBackend):
         cy = (min(ys) + max(ys)) / 2
         return cx, cy
 
+    async def _scroll_into_view_if_needed(self, selector: str) -> None:
+        """Scroll element into view if it's not visible in the viewport.
+
+        Args:
+            selector: CSS selector for the target element.
+        """
+        session = self._require_session()
+        escaped = selector.replace("'", "\\'")
+        js = (
+            f"(function(){{var el=document.querySelector('{escaped}');"
+            f"if(!el)return;var rect=el.getBoundingClientRect();"
+            f"if(rect.top<0||rect.bottom>window.innerHeight||"
+            f"rect.left<0||rect.right>window.innerWidth)"
+            f"el.scrollIntoView({{block:'center',behavior:'instant'}});}})()"
+        )
+        await session.runtime.evaluate(js)
+
     async def click(
         self, selector: str, button: str = "left", click_count: int = 1
     ) -> None:
@@ -1037,6 +1054,7 @@ class CDPBackend(AbstractBackend):
             click_count: Number of clicks to dispatch.
         """
         session = self._require_session()
+        await self._scroll_into_view_if_needed(selector)
         x, y = await self._get_box_center(selector)
         btn_map = {"left": "left", "right": "right", "middle": "middle"}
         btn = btn_map.get(button, "left")
@@ -1074,6 +1092,7 @@ class CDPBackend(AbstractBackend):
             value: Value to set in the input field.
         """
         session = self._require_session()
+        await self._scroll_into_view_if_needed(selector)
         escaped = selector.replace("'", "\\'")
         js = (
             f"(function(){{var el=document.querySelector('{escaped}');"
@@ -1113,6 +1132,7 @@ class CDPBackend(AbstractBackend):
             selector: CSS selector for the target element.
         """
         session = self._require_session()
+        await self._scroll_into_view_if_needed(selector)
         x, y = await self._get_box_center(selector)
         await session.input.dispatch_mouse_event(
             type_="mouseMoved", x=x, y=y