waitless 0.3.0__tar.gz → 0.3.1__tar.gz

{waitless-0.3.0/waitless.egg-info → waitless-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: waitless
-Version: 0.3.0
+Version: 0.3.1
 Summary: Eliminate explicit waits in UI automation by detecting true UI stability
 Author-email: Dhiraj Das <dhirajdas.666@gmail.com>
 License: MIT
@@ -84,7 +84,7 @@ Automation tests fail because interactions happen while the UI is still changing
 
 Waitless monitors the **entire page** for stability signals:
 
-- ✅ DOM mutation activity (MutationObserver)
+- ✅ DOM mutation activity (MutationObserver, including **Shadow DOM**)
 - ✅ Pending network requests (XHR/fetch interception)
 - ✅ CSS animations and transitions
 - ✅ Layout stability (element movement)
@@ -219,7 +219,6 @@ original = element.unwrap()  # Gets the real WebElement
 - **Selenium only** - Playwright support planned for v1
 - **Sync only** - No async/await support yet
 - **Main frame only** - iframes not monitored
-- **No Shadow DOM** - MutationObserver doesn't see shadow roots
 - **No Service Workers** - SW network requests not intercepted
 
 See [CHANGELOG.md](CHANGELOG.md) for version history.

{waitless-0.3.0 → waitless-0.3.1}/README.md

@@ -54,7 +54,7 @@ Automation tests fail because interactions happen while the UI is still changing
 
 Waitless monitors the **entire page** for stability signals:
 
-- ✅ DOM mutation activity (MutationObserver)
+- ✅ DOM mutation activity (MutationObserver, including **Shadow DOM**)
 - ✅ Pending network requests (XHR/fetch interception)
 - ✅ CSS animations and transitions
 - ✅ Layout stability (element movement)
@@ -189,7 +189,6 @@ original = element.unwrap()  # Gets the real WebElement
 - **Selenium only** - Playwright support planned for v1
 - **Sync only** - No async/await support yet
 - **Main frame only** - iframes not monitored
-- **No Shadow DOM** - MutationObserver doesn't see shadow roots
 - **No Service Workers** - SW network requests not intercepted
 
 See [CHANGELOG.md](CHANGELOG.md) for version history.

{waitless-0.3.0 → waitless-0.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "waitless"
-version = "0.3.0"
+version = "0.3.1"
 description = "Eliminate explicit waits in UI automation by detecting true UI stability"
 readme = "README.md"
 license = {text = "MIT"}

{waitless-0.3.0 → waitless-0.3.1}/waitless/__init__.py

@@ -36,7 +36,7 @@ Disable:
     driver = unstabilize(driver)  # Back to original behavior
 """
 
-__version__ = '0.3.0'
+__version__ = '0.3.1'
 __author__ = 'Dhiraj Das'
 
 # Public API

{waitless-0.3.0 → waitless-0.3.1}/waitless/instrumentation.py

@@ -71,6 +71,7 @@ INSTRUMENTATION_SCRIPT = """
         // Rolling window for mutation rate calculation
         _mutationTimestamps: [],
         _mutationWindowMs: 1000,  // 1 second window for rate calculation
+        _observedShadowRoots: new WeakSet(),
         
         _setupMutationObserver: function() {
             var self = this;
@@ -87,17 +88,77 @@ INSTRUMENTATION_SCRIPT = """
                     self._mutationTimestamps.shift();
                 }
                 
+                // Check for new shadow roots in added nodes
+                mutations.forEach(function(mutation) {
+                    mutation.addedNodes.forEach(function(node) {
+                        if (node.nodeType === 1) { // Element node
+                            self._observeShadowRoots(node);
+                        }
+                    });
+                });
+                
                 self._log('DOM mutation', { count: mutations.length, rate: self.getMutationRate() });
             });
             
-            observer.observe(document.documentElement || document.body, {
+            var config = {
                 childList: true,
                 subtree: true,
                 attributes: true,
                 characterData: true
-            });
+            };
             
+            observer.observe(document.documentElement || document.body, config);
             this._observers.push(observer);
+            
+            // Initial scan for shadow roots
+            this._observeShadowRoots(document);
+        },
+        
+        _observeShadowRoots: function(root) {
+            var self = this;
+            
+            // Function to recursively find and observe shadow roots
+            var walk = function(node) {
+                if (node.shadowRoot && !self._observedShadowRoots.has(node.shadowRoot)) {
+                    self._observedShadowRoots.add(node.shadowRoot);
+                    
+                    var observer = new MutationObserver(function(mutations) {
+                        var now = Date.now();
+                        self.lastMutationTime = now;
+                        self._mutationTimestamps.push(now);
+                        self._log('Shadow DOM mutation', { count: mutations.length });
+                        
+                        // Scan new nodes in shadow DOM for nested shadow roots
+                        mutations.forEach(function(mutation) {
+                            mutation.addedNodes.forEach(function(newNode) {
+                                if (newNode.nodeType === 1) walk(newNode);
+                            });
+                        });
+                    });
+                    
+                    observer.observe(node.shadowRoot, {
+                        childList: true,
+                        subtree: true,
+                        attributes: true,
+                        characterData: true
+                    });
+                    
+                    self._observers.push(observer);
+                    self._log('Observing shadow root', { host: node.tagName });
+                    
+                    // Recurse into the shadow root
+                    walk(node.shadowRoot);
+                }
+                
+                // Traverse children
+                var child = node.firstElementChild;
+                while (child) {
+                    walk(child);
+                    child = child.nextElementSibling;
+                }
+            };
+            
+            walk(root);
         },
         
         // Calculate mutations per second from rolling window
@@ -239,8 +300,26 @@ INSTRUMENTATION_SCRIPT = """
         },
         
         _checkLayoutStability: function() {
-            // Track key interactive elements
-            var elements = document.querySelectorAll('button, a, input, [onclick], [role="button"]');
+            // Track key interactive elements, including those in shadow DOM
+            var elements = [];
+            
+            var collectElements = function(root) {
+                var found = root.querySelectorAll('button, a, input, [onclick], [role="button"]');
+                for (var i = 0; i < found.length; i++) {
+                    elements.push(found[i]);
+                }
+                
+                // Recursively check shadow roots
+                var all = root.querySelectorAll('*');
+                for (var j = 0; j < all.length; j++) {
+                    if (all[j].shadowRoot) {
+                        collectElements(all[j].shadowRoot);
+                    }
+                }
+            };
+            
+            collectElements(document);
+            
             var isShifting = false;
             var self = this;
             

{waitless-0.3.0 → waitless-0.3.1}/waitless/signals.py

@@ -169,14 +169,26 @@ class SignalEvaluator:
         # Primary: Use mutation rate if available
         if mutation_rate is not None:
             threshold = self.config.mutation_rate_threshold
-            is_stable = mutation_rate <= threshold
+            rate_stable = mutation_rate <= threshold
+            
+            # Also check settle time to ensure we are quiet AFTER a mutation
+            time_since_mutation = (current_time * 1000) - last_mutation
+            threshold_ms = self.config.dom_settle_time * 1000
+            settle_stable = time_since_mutation >= threshold_ms
+            
+            is_stable = rate_stable and settle_stable
+            
+            details = f"Mutation rate: {mutation_rate:.0f}/sec (threshold: {threshold:.0f}/sec)"
+            if not settle_stable:
+                details += f", but only {time_since_mutation:.0f}ms since last mutation (need {threshold_ms:.0f}ms)"
+                
             return Signal(
                 signal_type=SignalType.DOM_MUTATIONS,
                 state=SignalState.STABLE if is_stable else SignalState.UNSTABLE,
                 value=mutation_rate,
                 threshold=threshold,
                 is_mandatory=True,
-                details=f"Mutation rate: {mutation_rate:.0f}/sec (threshold: {threshold:.0f}/sec)",
+                details=details,
             )
         
         # Fallback: Use time since last mutation

{waitless-0.3.0 → waitless-0.3.1/waitless.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: waitless
-Version: 0.3.0
+Version: 0.3.1
 Summary: Eliminate explicit waits in UI automation by detecting true UI stability
 Author-email: Dhiraj Das <dhirajdas.666@gmail.com>
 License: MIT
@@ -84,7 +84,7 @@ Automation tests fail because interactions happen while the UI is still changing
 
 Waitless monitors the **entire page** for stability signals:
 
-- ✅ DOM mutation activity (MutationObserver)
+- ✅ DOM mutation activity (MutationObserver, including **Shadow DOM**)
 - ✅ Pending network requests (XHR/fetch interception)
 - ✅ CSS animations and transitions
 - ✅ Layout stability (element movement)
@@ -219,7 +219,6 @@ original = element.unwrap()  # Gets the real WebElement
 - **Selenium only** - Playwright support planned for v1
 - **Sync only** - No async/await support yet
 - **Main frame only** - iframes not monitored
-- **No Shadow DOM** - MutationObserver doesn't see shadow roots
 - **No Service Workers** - SW network requests not intercepted
 
 See [CHANGELOG.md](CHANGELOG.md) for version history.