waitless 1.0.0__tar.gz → 1.0.2__tar.gz

{waitless-1.0.0/waitless.egg-info → waitless-1.0.2}/PKG-INFO

@@ -1,17 +1,16 @@
 Metadata-Version: 2.4
 Name: waitless
-Version: 1.0.0
+Version: 1.0.2
 Summary: Eliminate explicit waits in UI automation by detecting true UI stability
 Author-email: Dhiraj Das <dhirajdas.666@gmail.com>
-License: MIT
-Project-URL: Homepage, https://www.dhirajdas.dev
-Project-URL: Documentation, https://github.com/godhiraj-code/waitless#readme
-Project-URL: Repository, https://github.com/godhiraj-code/waitless.git
+License-Expression: MIT
+Project-URL: Homepage, https://www.dhirajdas.dev/project/waitless
+Project-URL: Documentation, https://www.dhirajdas.dev/project/waitless
+Project-URL: Repository, https://github.com/godhiraj-code/waitless
 Project-URL: Issues, https://github.com/godhiraj-code/waitless/issues
 Keywords: selenium,automation,testing,ui-testing,wait,stability,flaky-tests
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
@@ -23,20 +22,23 @@ Classifier: Topic :: Software Development :: Quality Assurance
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: selenium>=4.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
-Requires-Dist: selenium>=4.0; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
 Dynamic: license-file
 
 # Waitless
 
 [![CI](https://github.com/godhiraj-code/waitless/actions/workflows/ci.yml/badge.svg)](https://github.com/godhiraj-code/waitless/actions/workflows/ci.yml)
 
-**Zero-wait UI automation stabilization for Selenium**
+**Automatic UI stabilization for Selenium**
 
-Eliminate explicit waits and sleeps by automatically detecting true UI stability.
+Reduce explicit waits and sleeps by automatically evaluating multiple UI stability signals.
 
+[Watch the demo and read the architecture case study](https://www.dhirajdas.dev/project/waitless) · [Install from PyPI](https://pypi.org/project/waitless/)
 
+![Waitless stability demo](examples/waitless_demo.webp)
 
 ## Installation
 
@@ -92,7 +94,7 @@ Waitless monitors the **entire page** for stability signals:
 - ✅ Layout stability (element movement)
 - ✅ WebSocket/SSE activity (opt-in)
 - ✅ Framework hooks (React/Angular/Vue, opt-in)
-- ✅ iframe monitoring (opt-in)
+- ✅ Same-origin iframe load readiness (opt-in; not full child-frame signal injection)
 
 When you interact, waitless ensures the page is truly ready.
 
@@ -165,7 +167,7 @@ try:
     driver.find_element(By.ID, "slow-button").click()
 except StabilizationTimeout as e:
     diagnostics = get_diagnostics(driver)
-    print_report(engine)  # Print detailed report
+    print_report(diagnostics)  # Print detailed report
 ```
 
 ### CLI Doctor Command
@@ -240,20 +242,26 @@ config = StabilizationConfig(
 
 | Metric | Typical Value |
 |--------|---------------|
-| Instrumentation injection | ~5-10ms |
-| Per-poll overhead | ~1-2ms |
+| Instrumentation injection | Environment-dependent; run `python -m benchmarks.overhead_test` |
+| Per-poll overhead | Environment-dependent; run the bundled benchmark |
 | Poll interval (default) | 50ms |
 | Typical stabilization | 50-200ms after activity |
 
-### SPA Navigation Handling
+### Navigation Handling
 
-Waitless automatically re-injects instrumentation after SPA route changes:
+Wrapped `get()`, `refresh()`, `back()`, and `forward()` wait after Selenium's
+synchronous navigation call returns. For SPA route changes initiated by page
+JavaScript, Waitless validates/re-injects instrumentation on the next wait:
 
 1. Checks `__waitless__.isAlive()` before each wait
 2. Detects URL changes via `driver.current_url`
 3. Re-injects if instrumentation is missing
 
-This works transparently with React Router, Vue Router, Angular Router, etc.
+This does not observe routes continuously, and cross-origin iframe internals remain
+outside the browser same-origin boundary.
+
+`find_elements()` keeps Selenium's immediate-empty lookup semantics: after the
+page-stability wait, it performs one lookup and returns `[]` when there are no matches.
 
 ## Current Limitations
 
@@ -286,3 +294,7 @@ See [CHANGELOG.md](CHANGELOG.md) for version history.
 ## License
 
 MIT
+
+## Try It on a Real Flaky Flow
+
+Run Waitless against one Selenium flow that currently uses sleeps or retries, then compare failures and elapsed time before and after. Share a sanitized result in an issue. If it removes a sleep or retry, [star the repository](https://github.com/godhiraj-code/waitless). The [full case study](https://www.dhirajdas.dev/project/waitless) explains the architecture and trade-offs.

{waitless-1.0.0 → waitless-1.0.2}/README.md

@@ -2,11 +2,13 @@
 
 [![CI](https://github.com/godhiraj-code/waitless/actions/workflows/ci.yml/badge.svg)](https://github.com/godhiraj-code/waitless/actions/workflows/ci.yml)
 
-**Zero-wait UI automation stabilization for Selenium**
+**Automatic UI stabilization for Selenium**
 
-Eliminate explicit waits and sleeps by automatically detecting true UI stability.
+Reduce explicit waits and sleeps by automatically evaluating multiple UI stability signals.
 
+[Watch the demo and read the architecture case study](https://www.dhirajdas.dev/project/waitless) · [Install from PyPI](https://pypi.org/project/waitless/)
 
+![Waitless stability demo](examples/waitless_demo.webp)
 
 ## Installation
 
@@ -62,7 +64,7 @@ Waitless monitors the **entire page** for stability signals:
 - ✅ Layout stability (element movement)
 - ✅ WebSocket/SSE activity (opt-in)
 - ✅ Framework hooks (React/Angular/Vue, opt-in)
-- ✅ iframe monitoring (opt-in)
+- ✅ Same-origin iframe load readiness (opt-in; not full child-frame signal injection)
 
 When you interact, waitless ensures the page is truly ready.
 
@@ -135,7 +137,7 @@ try:
     driver.find_element(By.ID, "slow-button").click()
 except StabilizationTimeout as e:
     diagnostics = get_diagnostics(driver)
-    print_report(engine)  # Print detailed report
+    print_report(diagnostics)  # Print detailed report
 ```
 
 ### CLI Doctor Command
@@ -210,20 +212,26 @@ config = StabilizationConfig(
 
 | Metric | Typical Value |
 |--------|---------------|
-| Instrumentation injection | ~5-10ms |
-| Per-poll overhead | ~1-2ms |
+| Instrumentation injection | Environment-dependent; run `python -m benchmarks.overhead_test` |
+| Per-poll overhead | Environment-dependent; run the bundled benchmark |
 | Poll interval (default) | 50ms |
 | Typical stabilization | 50-200ms after activity |
 
-### SPA Navigation Handling
+### Navigation Handling
 
-Waitless automatically re-injects instrumentation after SPA route changes:
+Wrapped `get()`, `refresh()`, `back()`, and `forward()` wait after Selenium's
+synchronous navigation call returns. For SPA route changes initiated by page
+JavaScript, Waitless validates/re-injects instrumentation on the next wait:
 
 1. Checks `__waitless__.isAlive()` before each wait
 2. Detects URL changes via `driver.current_url`
 3. Re-injects if instrumentation is missing
 
-This works transparently with React Router, Vue Router, Angular Router, etc.
+This does not observe routes continuously, and cross-origin iframe internals remain
+outside the browser same-origin boundary.
+
+`find_elements()` keeps Selenium's immediate-empty lookup semantics: after the
+page-stability wait, it performs one lookup and returns `[]` when there are no matches.
 
 ## Current Limitations
 
@@ -256,3 +264,7 @@ See [CHANGELOG.md](CHANGELOG.md) for version history.
 ## License
 
 MIT
+
+## Try It on a Real Flaky Flow
+
+Run Waitless against one Selenium flow that currently uses sleeps or retries, then compare failures and elapsed time before and after. Share a sanitized result in an issue. If it removes a sleep or retry, [star the repository](https://github.com/godhiraj-code/waitless). The [full case study](https://www.dhirajdas.dev/project/waitless) explains the architecture and trade-offs.

{waitless-1.0.0 → waitless-1.0.2}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "waitless"
-version = "1.0.0"
+version = "1.0.2"
 description = "Eliminate explicit waits in UI automation by detecting true UI stability"
 readme = "README.md"
-license = {text = "MIT"}
+license = "MIT"
 requires-python = ">=3.9"
 authors = [
     {name = "Dhiraj Das", email = "dhirajdas.666@gmail.com"}
@@ -24,7 +24,6 @@ keywords = [
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.9",
@@ -34,11 +33,14 @@ classifiers = [
     "Topic :: Software Development :: Testing",
     "Topic :: Software Development :: Quality Assurance",
 ]
+dependencies = [
+    "selenium>=4.0",
+]
 
 [project.urls]
-Homepage = "https://www.dhirajdas.dev"
-Documentation = "https://github.com/godhiraj-code/waitless#readme"
-Repository = "https://github.com/godhiraj-code/waitless.git"
+Homepage = "https://www.dhirajdas.dev/project/waitless"
+Documentation = "https://www.dhirajdas.dev/project/waitless"
+Repository = "https://github.com/godhiraj-code/waitless"
 Issues = "https://github.com/godhiraj-code/waitless/issues"
 
 [project.scripts]
@@ -47,7 +49,7 @@ waitless = "waitless.__main__:main"
 [project.optional-dependencies]
 dev = [
     "pytest>=7.0",
-    "selenium>=4.0",
+    "build>=1.0",
 ]
 
 [tool.setuptools.packages.find]

{waitless-1.0.0 → waitless-1.0.2}/waitless/__init__.py

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

{waitless-1.0.0 → waitless-1.0.2}/waitless/__main__.py

@@ -95,7 +95,8 @@ def run_doctor(args):
         print("|    try:".ljust(67) + "|")
         print("|        driver.find_element(...).click()".ljust(67) + "|")
         print("|    except StabilizationTimeout as e:".ljust(67) + "|")
-        print("|        print_report(engine)  # Print diagnostic report".ljust(67) + "|")
+        print("|        diagnostics = get_diagnostics(driver)".ljust(67) + "|")
+        print("|        print_report(diagnostics)".ljust(67) + "|")
         print("|".ljust(67) + "|")
         print("| 3. Export diagnostics for CI:".ljust(67) + "|")
         print("|".ljust(67) + "|")

{waitless-1.0.0 → waitless-1.0.2}/waitless/adapters/angular.py

@@ -56,9 +56,12 @@ class AngularAdapter(FrameworkAdapter):
             if (testability && testability.length > 0) {
                 testability.forEach(function(t) {
                     t.whenStable(function() {
-                        window.__waitless__.framework.angular.isStable = true;
-                        window.__waitless__.framework.angular.lastStableTime = Date.now();
-                        window.__waitless__._log('Angular became stable');
+                        var angular = window.__waitless__ && window.__waitless__.framework && window.__waitless__.framework.angular;
+                        if (angular) {
+                            angular.isStable = true;
+                            angular.lastStableTime = Date.now();
+                            window.__waitless__._log('Angular became stable');
+                        }
                     });
                 });
             }
@@ -66,20 +69,29 @@ class AngularAdapter(FrameworkAdapter):
             // Also try to hook into Zone.js if available
             if (window.Zone && window.Zone.current) {
                 var originalRun = Zone.prototype.run;
+                window.__waitless__._angularOriginals = {
+                    zonePrototype: Zone.prototype,
+                    run: originalRun
+                };
                 Zone.prototype.run = function(callback, applyThis, applyArgs) {
-                    if (this.name === 'angular') {
-                        window.__waitless__.framework.angular.isStable = false;
-                        window.__waitless__.framework.angular.pendingTasks++;
+                    var angular = window.__waitless__ && window.__waitless__.framework && window.__waitless__.framework.angular;
+                    var tracked = this.name === 'angular' && angular;
+                    if (tracked) {
+                        angular.isStable = false;
+                        angular.pendingTasks++;
                     }
-                    var result = originalRun.apply(this, arguments);
-                    if (this.name === 'angular') {
-                        window.__waitless__.framework.angular.pendingTasks--;
-                        if (window.__waitless__.framework.angular.pendingTasks === 0) {
-                            window.__waitless__.framework.angular.isStable = true;
-                            window.__waitless__.framework.angular.lastStableTime = Date.now();
+                    try {
+                        return originalRun.apply(this, arguments);
+                    } finally {
+                        var current = window.__waitless__ && window.__waitless__.framework && window.__waitless__.framework.angular;
+                        if (tracked && current) {
+                            current.pendingTasks--;
+                            if (current.pendingTasks === 0) {
+                                current.isStable = true;
+                                current.lastStableTime = Date.now();
+                            }
                         }
                     }
-                    return result;
                 };
             }
             
@@ -89,6 +101,22 @@ class AngularAdapter(FrameworkAdapter):
         })();
         """
     
+    @property
+    def uninstall_script(self) -> str:
+        return """
+        (function() {
+            if (!window.__waitless__) return true;
+            var originals = window.__waitless__._angularOriginals || {};
+            if (originals.zonePrototype && originals.run) {
+                originals.zonePrototype.run = originals.run;
+            }
+            if (window.__waitless__.framework) delete window.__waitless__.framework.angular;
+            delete window.__waitless__._angularOriginals;
+            delete window.__waitless__._angularHooked;
+            return true;
+        })();
+        """
+
     def get_status_script(self) -> str:
         return """
         (function() {

{waitless-1.0.0 → waitless-1.0.2}/waitless/adapters/base.py

@@ -41,6 +41,12 @@ class FrameworkAdapter(ABC):
         """
         pass
     
+    @property
+    @abstractmethod
+    def uninstall_script(self) -> str:
+        """JavaScript that restores every function patched by this adapter."""
+        pass
+
     @abstractmethod
     def get_status_script(self) -> str:
         """

{waitless-1.0.0 → waitless-1.0.2}/waitless/adapters/react.py

@@ -53,19 +53,25 @@ class ReactAdapter(FrameworkAdapter):
                 isSettled: true
             };
             
+            var originals = window.__waitless__._reactOriginals = {};
             var hook = window.__REACT_DEVTOOLS_GLOBAL_HOOK__;
             if (hook && hook.onCommitFiberRoot) {
                 var originalOnCommit = hook.onCommitFiberRoot;
+                originals.hook = hook;
+                originals.onCommitFiberRoot = originalOnCommit;
                 hook.onCommitFiberRoot = function(id, root, priority) {
-                    window.__waitless__.framework.react.lastCommitTime = Date.now();
-                    window.__waitless__.framework.react.isSettled = false;
-                    window.__waitless__._log('React commit', { priority: priority });
-                    
-                    // Mark as settled after a short delay (microtask completion)
-                    setTimeout(function() {
-                        window.__waitless__.framework.react.isSettled = true;
-                    }, 50);
-                    
+                    var react = window.__waitless__ && window.__waitless__.framework && window.__waitless__.framework.react;
+                    if (react) {
+                        react.lastCommitTime = Date.now();
+                        react.isSettled = false;
+                        window.__waitless__._log('React commit', { priority: priority });
+
+                        setTimeout(function() {
+                            var current = window.__waitless__ && window.__waitless__.framework && window.__waitless__.framework.react;
+                            if (current) current.isSettled = true;
+                        }, 50);
+                    }
+
                     return originalOnCommit.apply(this, arguments);
                 };
             }
@@ -73,11 +79,15 @@ class ReactAdapter(FrameworkAdapter):
             // Also try to intercept React's scheduler if available
             if (window.scheduler && window.scheduler.unstable_scheduleCallback) {
                 var originalSchedule = window.scheduler.unstable_scheduleCallback;
+                originals.scheduler = window.scheduler;
+                originals.scheduleCallback = originalSchedule;
                 window.scheduler.unstable_scheduleCallback = function(priority, callback) {
-                    window.__waitless__.framework.react.pendingUpdates++;
+                    var react = window.__waitless__ && window.__waitless__.framework && window.__waitless__.framework.react;
+                    if (react) react.pendingUpdates++;
                     var wrappedCallback = function() {
                         var result = callback.apply(this, arguments);
-                        window.__waitless__.framework.react.pendingUpdates--;
+                        var current = window.__waitless__ && window.__waitless__.framework && window.__waitless__.framework.react;
+                        if (current) current.pendingUpdates--;
                         return result;
                     };
                     return originalSchedule.call(this, priority, wrappedCallback);
@@ -90,6 +100,25 @@ class ReactAdapter(FrameworkAdapter):
         })();
         """
     
+    @property
+    def uninstall_script(self) -> str:
+        return """
+        (function() {
+            if (!window.__waitless__) return true;
+            var originals = window.__waitless__._reactOriginals || {};
+            if (originals.hook && originals.onCommitFiberRoot) {
+                originals.hook.onCommitFiberRoot = originals.onCommitFiberRoot;
+            }
+            if (originals.scheduler && originals.scheduleCallback) {
+                originals.scheduler.unstable_scheduleCallback = originals.scheduleCallback;
+            }
+            if (window.__waitless__.framework) delete window.__waitless__.framework.react;
+            delete window.__waitless__._reactOriginals;
+            delete window.__waitless__._reactHooked;
+            return true;
+        })();
+        """
+
     def get_status_script(self) -> str:
         return """
         (function() {

{waitless-1.0.0 → waitless-1.0.2}/waitless/adapters/vue.py

@@ -57,34 +57,53 @@ class VueAdapter(FrameworkAdapter):
             };
             
             var hook = window.__VUE_DEVTOOLS_GLOBAL_HOOK__;
+            var originals = window.__waitless__._vueOriginals = {};
             if (hook) {
-                // Vue 3 DevTools hook
-                hook.on && hook.on('component:updated', function() {
-                    window.__waitless__.framework.vue.lastUpdateTime = Date.now();
-                    window.__waitless__.framework.vue.isSettled = false;
-                    window.__waitless__._log('Vue component updated');
-                    
-                    setTimeout(function() {
-                        window.__waitless__.framework.vue.isSettled = true;
-                    }, 50);
-                });
-                
+                // Vue 3 DevTools hook. Reuse a stable handler if the hook has no off().
+                if (hook.on) {
+                    var updateHandler = hook.__waitlessVueUpdateHandler;
+                    if (!updateHandler) {
+                        updateHandler = function() {
+                            var vue = window.__waitless__ && window.__waitless__.framework && window.__waitless__.framework.vue;
+                            if (!vue) return;
+                            vue.lastUpdateTime = Date.now();
+                            vue.isSettled = false;
+                            window.__waitless__._log('Vue component updated');
+
+                            setTimeout(function() {
+                                var current = window.__waitless__ && window.__waitless__.framework && window.__waitless__.framework.vue;
+                                if (current) current.isSettled = true;
+                            }, 50);
+                        };
+                        hook.__waitlessVueUpdateHandler = updateHandler;
+                        hook.on('component:updated', updateHandler);
+                    }
+                    originals.hook = hook;
+                    originals.updateHandler = updateHandler;
+                }
+
                 // Vue 2 compatibility
                 if (hook.Vue && hook.Vue.nextTick) {
                     var originalNextTick = hook.Vue.nextTick;
+                    originals.vue = hook.Vue;
+                    originals.nextTick = originalNextTick;
                     hook.Vue.nextTick = function(callback, context) {
-                        window.__waitless__.framework.vue.pendingTicks++;
-                        window.__waitless__.framework.vue.isSettled = false;
-                        
+                        var vue = window.__waitless__ && window.__waitless__.framework && window.__waitless__.framework.vue;
+                        if (vue) {
+                            vue.pendingTicks++;
+                            vue.isSettled = false;
+                        }
+
                         var wrappedCallback = function() {
-                            window.__waitless__.framework.vue.pendingTicks--;
-                            window.__waitless__.framework.vue.lastUpdateTime = Date.now();
-                            if (window.__waitless__.framework.vue.pendingTicks === 0) {
-                                window.__waitless__.framework.vue.isSettled = true;
+                            var current = window.__waitless__ && window.__waitless__.framework && window.__waitless__.framework.vue;
+                            if (current) {
+                                current.pendingTicks--;
+                                current.lastUpdateTime = Date.now();
+                                if (current.pendingTicks === 0) current.isSettled = true;
                             }
-                            if (callback) callback.apply(this, arguments);
+                            if (callback) return callback.apply(this, arguments);
                         };
-                        
+
                         return originalNextTick.call(this, wrappedCallback, context);
                     };
                 }
@@ -96,6 +115,26 @@ class VueAdapter(FrameworkAdapter):
         })();
         """
     
+    @property
+    def uninstall_script(self) -> str:
+        return """
+        (function() {
+            if (!window.__waitless__) return true;
+            var originals = window.__waitless__._vueOriginals || {};
+            if (originals.vue && originals.nextTick) {
+                originals.vue.nextTick = originals.nextTick;
+            }
+            if (originals.hook && originals.updateHandler && originals.hook.off) {
+                originals.hook.off('component:updated', originals.updateHandler);
+                delete originals.hook.__waitlessVueUpdateHandler;
+            }
+            if (window.__waitless__.framework) delete window.__waitless__.framework.vue;
+            delete window.__waitless__._vueOriginals;
+            delete window.__waitless__._vueHooked;
+            return true;
+        })();
+        """
+
     def get_status_script(self) -> str:
         return """
         (function() {

{waitless-1.0.0 → waitless-1.0.2}/waitless/config.py

@@ -107,6 +107,12 @@ class StabilizationConfig:
             raise ConfigurationError(
                 f"dom_settle_time must be non-negative, got {self.dom_settle_time}"
             )
+
+        if self.mutation_rate_threshold < 0:
+            raise ConfigurationError(
+                "mutation_rate_threshold must be non-negative, "
+                f"got {self.mutation_rate_threshold}"
+            )
         
         if self.network_idle_threshold < 0:
             raise ConfigurationError(
@@ -122,11 +128,28 @@ class StabilizationConfig:
             raise ConfigurationError(
                 f"poll_interval ({self.poll_interval}) cannot exceed timeout ({self.timeout})"
             )
+
+        if self.websocket_quiet_time < 0:
+            raise ConfigurationError(
+                "websocket_quiet_time must be non-negative, "
+                f"got {self.websocket_quiet_time}"
+            )
         
         if self.strictness not in ('strict', 'normal', 'relaxed'):
             raise ConfigurationError(
                 f"strictness must be 'strict', 'normal', or 'relaxed', got '{self.strictness}'"
             )
+
+        supported_hooks = {'react', 'angular', 'vue'}
+        normalized_hooks = []
+        for hook in self.framework_hooks:
+            if not isinstance(hook, str) or hook.lower() not in supported_hooks:
+                raise ConfigurationError(
+                    f"unsupported framework hook {hook!r}; expected one of "
+                    f"{sorted(supported_hooks)}"
+                )
+            normalized_hooks.append(hook.lower())
+        self.framework_hooks = list(dict.fromkeys(normalized_hooks))
     
     def with_overrides(self, **kwargs) -> 'StabilizationConfig':
         """

{waitless-1.0.0 → waitless-1.0.2}/waitless/diagnostics.py

@@ -166,14 +166,14 @@ class DiagnosticReport:
             )
         
         if suggestions:
-            lines.append("╠" + "═" * 66 + "╣")
-            lines.append("║ SUGGESTIONS:".ljust(67) + "║")
-            lines.append("║".ljust(67) + "║")
+            lines.append("+-" + "-" * 66 + "-+")
+            lines.append("| SUGGESTIONS:".ljust(67) + "|")
+            lines.append("|".ljust(67) + "|")
             
             for i, suggestion in enumerate(suggestions, 1):
                 for line in f"{i}. {suggestion}".split('\n'):
-                    lines.append(f"║ {line}".ljust(67) + "║")
-                lines.append("║".ljust(67) + "║")
+                    lines.append(f"| {line}".ljust(67) + "|")
+                lines.append("|".ljust(67) + "|")
         
         return lines
     
@@ -185,13 +185,19 @@ class DiagnosticReport:
         }, indent=2, default=str)
 
 
-def generate_report(engine: 'StabilizationEngine') -> DiagnosticReport:
-    """Generate a diagnostic report from an engine."""
-    diagnostics = engine.get_diagnostics()
+def generate_report(source: Any) -> DiagnosticReport:
+    """Generate a report from an engine or a diagnostics dictionary."""
+    if isinstance(source, dict):
+        diagnostics = source.get('diagnostics', source)
+    elif hasattr(source, 'get_diagnostics'):
+        diagnostics = source.get_diagnostics()
+    elif hasattr(source, '_engine'):
+        diagnostics = source._engine.get_diagnostics()
+    else:
+        raise TypeError("expected diagnostics dict, engine, or stabilized driver")
     return DiagnosticReport(diagnostics)
 
 
-def print_report(engine: 'StabilizationEngine') -> None:
-    """Print a diagnostic report to stdout."""
-    report = generate_report(engine)
-    print(report.generate_text_report())
+def print_report(source: Any) -> None:
+    """Print a report from diagnostics, an engine, or a stabilized driver."""
+    print(generate_report(source).generate_text_report())