From 333b6de0b52c55145d57f3d36fa08d410107b87b Mon Sep 17 00:00:00 2001
From: Karim shoair <D4Vinci@users.noreply.github.com>
Date: Sat, 2 May 2026 19:58:53 +0300
Subject: [PATCH] fix(parser): change the default threshold and add warning

---
 scrapling/parser.py | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/scrapling/parser.py b/scrapling/parser.py
index eced0a9..2b88af3 100644
--- a/scrapling/parser.py
+++ b/scrapling/parser.py
@@ -519,7 +519,7 @@ class Selector(SelectorsGeneration):
     def relocate(
         self,
         element: Union[Dict, HtmlElement, "Selector"],
-        percentage: int = 0,
+        percentage: int = 40,
         selector_type: bool = False,
     ) -> Union[List[HtmlElement], "Selectors"]:
         """This function will search again for the element in the page tree, used automatically on page structure change
@@ -559,6 +559,10 @@ class Selector(SelectorsGeneration):
                 if not selector_type:
                     return score_table[highest_probability]
                 return self.__elements_convertor(score_table[highest_probability])
+            log.warning(
+                f"Adaptive relocation found no element above the {percentage}% threshold "
+                f"(top score: {highest_probability}%). Lower `percentage` if this is the right element."
+            )
         return []
 
     def css(
@@ -567,7 +571,7 @@ class Selector(SelectorsGeneration):
         identifier: str = "",
         adaptive: bool = False,
         auto_save: bool = False,
-        percentage: int = 0,
+        percentage: int = 40,
     ) -> "Selectors":
         """Search the current tree with CSS3 selectors
 
@@ -627,7 +631,7 @@ class Selector(SelectorsGeneration):
         identifier: str = "",
         adaptive: bool = False,
         auto_save: bool = False,
-        percentage: int = 0,
+        percentage: int = 40,
         **kwargs: Any,
     ) -> "Selectors":
         """Search the current tree with XPath selectors
@@ -1220,7 +1224,7 @@ class Selectors(List[Selector]):
         selector: str,
         identifier: str = "",
         auto_save: bool = False,
-        percentage: int = 0,
+        percentage: int = 40,
         **kwargs: Any,
     ) -> "Selectors":
         """
@@ -1251,7 +1255,7 @@ class Selectors(List[Selector]):
         selector: str,
         identifier: str = "",
         auto_save: bool = False,
-        percentage: int = 0,
+        percentage: int = 40,
     ) -> "Selectors":
         """
         Call the ``.css()`` method for each element in this list and return