servo: Prepare for usage docs (#10121)

* refactor: Consolidate Servo initialization and event handling into a new `webview` module.

* [autofix.ci] apply automated fixes

* refactor: Move webview-related modules into the `webview` directory and update all internal import paths.

* refactor: move servo field to inner struct and add direct accessor

* docs: Add docs for webview module

* docs: Change webview module to public and improve example in docs

* [autofix.ci] apply automated fixes

* docs: Improve example in docs

---------

Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

Author: burhankhanzada

examples/servo/src/delegate.rs

@@ -1,12 +1,7 @@
 // Copyright © SixtyFPS GmbH <[email protected]>
 // SPDX-License-Identifier: MIT
 
-mod adapter;
-mod delegate;
-mod on_events;
-mod rendering_context;
-mod servo_util;
-mod waker;
+pub mod webview;
 
 #[cfg(target_os = "linux")]
 mod gl_bindings {
@@ -17,54 +12,21 @@ mod gl_bindings {
 
 use slint::ComponentHandle;
 
-use crate::servo_util::init_servo;
+#[cfg(not(target_os = "android"))]
+use crate::webview::WebView;
 
 slint::include_modules!();
 
 pub fn main() {
     #[cfg(not(target_os = "android"))]
-    let (device, queue) = {
-        let backends = wgpu::Backends::from_env().unwrap_or_default();
-
-        let instance = wgpu::Instance::new(&wgpu::InstanceDescriptor {
-            backends,
-            flags: Default::default(),
-            backend_options: Default::default(),
-            memory_budget_thresholds: Default::default(),
-        });
-
-        let adapter = spin_on::spin_on(async {
-            instance
-                .request_adapter(&Default::default())
-                .await
-                .expect("Failed to find an appropriate WGPU adapter")
-        });
-
-        let (device, queue) = spin_on::spin_on(async {
-            adapter.request_device(&Default::default()).await.expect("Failed to create WGPU device")
-        });
-
-        slint::BackendSelector::new()
-        .require_wgpu_27(slint::wgpu_27::WGPUConfiguration::Manual {
-            instance,
-            adapter,
-            device: device.clone(),
-            queue: queue.clone()
-        })
-        .select()
-        .expect("Failed to create Slint backend with WGPU based renderer - ensure your system supports WGPU");
-
-        (device, queue)
-    };
+    let (device, queue) = setup_wgpu();
 
     let app = MyApp::new().expect("Failed to create Slint application - check UI resources");
 
-    let url = "https://slint.dev";
-
     #[cfg(not(target_os = "android"))]
-    let _adapter = init_servo(
+    WebView::new(
         app.clone_strong(),
-        url.into(),
+        "https://slint.dev".into(),
         #[cfg(not(target_os = "android"))]
         device,
         #[cfg(not(target_os = "android"))]
@@ -80,3 +42,38 @@ pub fn android_main(android_app: slint::android::AndroidApp) {
     slint::android::init(android_app).unwrap();
     main();
 }
+
+#[cfg(not(target_os = "android"))]
+fn setup_wgpu() -> (wgpu::Device, wgpu::Queue) {
+    let backends = wgpu::Backends::from_env().unwrap_or_default();
+
+    let instance = wgpu::Instance::new(&wgpu::InstanceDescriptor {
+        backends,
+        flags: Default::default(),
+        backend_options: Default::default(),
+        memory_budget_thresholds: Default::default(),
+    });
+
+    let adapter = spin_on::spin_on(async {
+        instance
+            .request_adapter(&Default::default())
+            .await
+            .expect("Failed to find an appropriate WGPU adapter")
+    });
+
+    let (device, queue) = spin_on::spin_on(async {
+        adapter.request_device(&Default::default()).await.expect("Failed to create WGPU device")
+    });
+
+    slint::BackendSelector::new()
+        .require_wgpu_27(slint::wgpu_27::WGPUConfiguration::Manual {
+            instance,
+            adapter,
+            device: device.clone(),
+            queue: queue.clone()
+        })
+        .select()
+        .expect("Failed to create Slint backend with WGPU based renderer - ensure your system supports WGPU");
+
+    (device, queue)
+}