Write about embedding

Author: delan

_posts/2025-03-07-this-month-in-servo.md

@@ -76,82 +76,82 @@ categories:
       element
     - `https://github.com/servo/servo/pull/35531	(@simonwuelker, #35531)	Implement the <progress> element (#35531)
       element
-- embedding
-    - https://github.com/servo/servo/pull/35229	(@mrobinson, #35229)	Finish the integration of `webxr` into the Cargo workspace (#35229)
+- `embedding
+    - `https://github.com/servo/servo/pull/35229	(@mrobinson, #35229)	Finish the integration of `webxr` into the Cargo workspace (#35229)
       embedding; embedders no longer need to know about webxr types
-    - https://github.com/servo/servo/pull/35256	(@jdm, #35256)	libservo: Make background hang monitor integration optional. (#35256)
+    - `https://github.com/servo/servo/pull/35256	(@jdm, #35256)	libservo: Make background hang monitor integration optional. (#35256)
       embedding
-    - https://github.com/servo/servo/pull/35253	(@[email protected], #35253)	chore(servo): simplify servo example (#35253)
+    - `https://github.com/servo/servo/pull/35253	(@[email protected], #35253)	chore(servo): simplify servo example (#35253)
       embedding
-    - https://github.com/servo/servo/pull/35263	(@dklassic, #35263)	chore: Rename `CompositeTarget` enum (#35263)
+    - -https://github.com/servo/servo/pull/35263	(@dklassic, #35263)	chore: Rename `CompositeTarget` enum (#35263)
       embedding
-    - https://github.com/servo/servo/pull/35260	(@mrobinson, #35260)	libservo: Combine `LoadStart, `HeadParsed`, and `LoadComplete` messages (#35260)
+    - `https://github.com/servo/servo/pull/35260	(@mrobinson, #35260)	libservo: Combine `LoadStart, `HeadParsed`, and `LoadComplete` messages (#35260)
       embedding
-    - https://github.com/servo/servo/pull/35283	(@mrobinson, #35283)	libservo: Remove `Servo::repaint_synchronously` (#35283)
+    - `https://github.com/servo/servo/pull/35283	(@mrobinson, #35283)	libservo: Remove `Servo::repaint_synchronously` (#35283)
       embedding
-    - https://github.com/servo/servo/pull/35277	(@mrobinson, #35277)	libservo: Remove `EmbedderEvent::WindowResize` (#35277)
+    - `https://github.com/servo/servo/pull/35277	(@mrobinson, #35277)	libservo: Remove `EmbedderEvent::WindowResize` (#35277)
       embedding
-    - https://github.com/servo/servo/pull/35251	(@wusyong, #35251)	Simplify `RenderingContext` trait methods (#35251)
+    - `https://github.com/servo/servo/pull/35251	(@wusyong, #35251)	Simplify `RenderingContext` trait methods (#35251)
       embedding
-    - https://github.com/servo/servo/pull/35196	(@delan, @mrobinson, @mukilan, #35196)	libservo: Add WebViewDelegate and ServoDelegate and port `winit_minimal` (#35196)
+    - `https://github.com/servo/servo/pull/35196	(@delan, @mrobinson, @mukilan, #35196)	libservo: Add WebViewDelegate and ServoDelegate and port `winit_minimal` (#35196)
       embedding
-    - https://github.com/servo/servo/pull/35315	(@mukilan, @mrobinson, #35315)	Migrate Android and OHOS ports to the delegate API (#35315)
+    - `https://github.com/servo/servo/pull/35315	(@mukilan, @mrobinson, #35315)	Migrate Android and OHOS ports to the delegate API (#35315)
       embedding
-    - https://github.com/servo/servo/pull/35284	(@mrobinson, @delan, @mukilan, #35284)	servoshell: Port desktop servoshell to use delegate API (#35284)
+    - `https://github.com/servo/servo/pull/35284	(@mrobinson, @delan, @mukilan, #35284)	servoshell: Port desktop servoshell to use delegate API (#35284)
       embedding
-    - https://github.com/servo/servo/pull/35297	(@mrobinson, #35297)	libservo: Add a `ClipboardDelegate` and a default implementation (#35297)
+    - `https://github.com/servo/servo/pull/35297	(@mrobinson, #35297)	libservo: Add a `ClipboardDelegate` and a default implementation (#35297)
       embedding
-    - https://github.com/servo/servo/pull/35350	(@webbeef, #35350)	wini_minimal: trigger initial rendering and scroll properly (#35350)
+    - `https://github.com/servo/servo/pull/35350	(@webbeef, #35350)	wini_minimal: trigger initial rendering and scroll properly (#35350)
       embedding
-    - https://github.com/servo/servo/pull/35366	(@mrobinson, #35366)	libservo: Remove message-based API (#35366)
+    - `https://github.com/servo/servo/pull/35366	(@mrobinson, #35366)	libservo: Remove message-based API (#35366)
       embedding
-    - https://github.com/servo/servo/pull/35400	(@mrobinson, #35400)	libservo: Add a delegate method for HTTP authentication (#35400)
+    - `https://github.com/servo/servo/pull/35400	(@mrobinson, #35400)	libservo: Add a delegate method for HTTP authentication (#35400)
       embedding
-    - https://github.com/servo/servo/pull/35396	(@mrobinson, @mukilan, #35396)	libservo: Flesh out permissions API (#35396)
+    - `https://github.com/servo/servo/pull/35396	(@mrobinson, @mukilan, #35396)	libservo: Flesh out permissions API (#35396)
       embedding
-    - https://github.com/servo/servo/pull/35445	(@mukilan, #35445)	libservo: change 'request_fullscreen_state_change' API to a notification (#35445)
+    - -https://github.com/servo/servo/pull/35445	(@mukilan, #35445)	libservo: change 'request_fullscreen_state_change' API to a notification (#35445)
       embedding
-    - https://github.com/servo/servo/pull/35430	(@mrobinson, @mukilan, #35430)	libservo: Expose a single `InputEvent` type and pass it to script (#35430)
+    - `https://github.com/servo/servo/pull/35430	(@mrobinson, @mukilan, #35430)	libservo: Expose a single `InputEvent` type and pass it to script (#35430)
       embedding
-    - https://github.com/servo/servo/pull/35369	(@mrobinson, #35369)	libservo: Don't bounce ready-to-present frame notifications to the Constellation (#35369)
-      embedding
-    - https://github.com/servo/servo/pull/35479	(@jdm, #35479)	Make WebBluetooth an optional feature. (#35479)
+    - `https://github.com/servo/servo/pull/35369	(@mrobinson, #35369)	libservo: Don't bounce ready-to-present frame notifications to the Constellation (#35369)
+      perf
+    - `https://github.com/servo/servo/pull/35479	(@jdm, #35479)	Make WebBluetooth an optional feature. (#35479)
       embedding
-    - https://github.com/servo/servo/pull/35465	(@mrobinson, @mukilan, #35465)	libservo: Expose an `OffscreenRenderingContext` and use it for servoshell (#35465)
+    - `https://github.com/servo/servo/pull/35465	(@mrobinson, @mukilan, #35465)	libservo: Expose an `OffscreenRenderingContext` and use it for servoshell (#35465)
       embedding
-    - https://github.com/servo/servo/pull/35501	(@mrobinson, #35501)	libservo: Expose `SoftwareRenderingContext` and `WindowRenderingContext` (#35501)
+    - `https://github.com/servo/servo/pull/35501	(@mrobinson, #35501)	libservo: Expose `SoftwareRenderingContext` and `WindowRenderingContext` (#35501)
       embedding
-    - https://github.com/servo/servo/pull/35536	(@mrobinson, @wusyong, #35536)	compositing: Split non-WebView-specific data into `ServoRenderer` (#35536)
+    - `https://github.com/servo/servo/pull/35536	(@mrobinson, @wusyong, #35536)	compositing: Split non-WebView-specific data into `ServoRenderer` (#35536)
       embedding
-    - https://github.com/servo/servo/pull/35544	(@mrobinson, #35544)	Remove `Servo::allow_navigation_request` (#35544)
+    - `https://github.com/servo/servo/pull/35544	(@mrobinson, #35544)	Remove `Servo::allow_navigation_request` (#35544)
       embedding
-    - https://github.com/servo/servo/pull/35522	(@mrobinson, @wusyong, @mukilan, #35522)	libservo: Rework and clarify the rendering model of the `WebView` (#35522)
+    - `https://github.com/servo/servo/pull/35522	(@mrobinson, @wusyong, @mukilan, #35522)	libservo: Rework and clarify the rendering model of the `WebView` (#35522)
       embedding
-    - https://github.com/servo/servo/pull/35538	(@mrobinson, @wusyong, #35538)	compositing: Move image output and shutdown management out of the compositor (#35538)
+    - `https://github.com/servo/servo/pull/35538	(@mrobinson, @wusyong, #35538)	compositing: Move image output and shutdown management out of the compositor (#35538)
       embedding
-    - https://github.com/servo/servo/pull/35553	(@mrobinson, #35553)	libservo: Move GL acclerated media setup out of `RenderingContext` and simplify it (#35553)
+    - `https://github.com/servo/servo/pull/35553	(@mrobinson, #35553)	libservo: Move GL acclerated media setup out of `RenderingContext` and simplify it (#35553)
       embedding
     - https://github.com/servo/servo/pull/35547	(@delan, #35547)	libservo: Clean up destroyed webview handles (#35547)
       embedding
-    - https://github.com/servo/servo/pull/35590	(@webbeef, #35590)	build winit_minimal with bluetooth disabled (#35590)
+    - `https://github.com/servo/servo/pull/35590	(@webbeef, #35590)	build winit_minimal with bluetooth disabled (#35590)
       embedding
-    - https://github.com/servo/servo/pull/35564	(@mrobinson, #35564)	libservo: Convert `intercept_web_resource_load` into `load_web_resource` (#35564)
+    - `https://github.com/servo/servo/pull/35564	(@mrobinson, #35564)	libservo: Convert `intercept_web_resource_load` into `load_web_resource` (#35564)
       embedding
-    - https://github.com/servo/servo/pull/35624	(@delan, #35624)	libservo: Refactor ipc-channel default response logic (#35624)
+    - -https://github.com/servo/servo/pull/35624	(@delan, #35624)	libservo: Refactor ipc-channel default response logic (#35624)
       embedding
     - https://github.com/servo/servo/pull/35602	(@mrobinson, #35602)	libservo: Move WebDriver messages to the `embedder` crate (#35602)
+      webdriver
+    - `https://github.com/servo/servo/pull/35621	(@mrobinson, #35621)	libservo: Move size handling to `RenderContext` from `WindowMethods` (#35621)
       embedding
-    - https://github.com/servo/servo/pull/35621	(@mrobinson, #35621)	libservo: Move size handling to `RenderContext` from `WindowMethods` (#35621)
-      embedding
-    - https://github.com/servo/servo/pull/35686	(@webbeef, #35686)	winit_minimal: fix build breakage (#35686)
+    - `https://github.com/servo/servo/pull/35686	(@webbeef, #35686)	winit_minimal: fix build breakage (#35686)
       embedding
-    - https://github.com/servo/servo/pull/35579	(@delan, #35579)	libservo: Clean up interfaces for alert()/confirm()/prompt() (#35579)
+    - `https://github.com/servo/servo/pull/35579	(@delan, #35579)	libservo: Clean up interfaces for alert()/confirm()/prompt() (#35579)
       embedding
-    - https://github.com/servo/servo/pull/35662	(@mrobinson, #35662)	libservo: Add `WebView` immediately to the Compositor (#35662)
+    - `https://github.com/servo/servo/pull/35662	(@mrobinson, #35662)	libservo: Add `WebView` immediately to the Compositor (#35662)
       embedding
-    - https://github.com/servo/servo/pull/35672	(@delan, @mrobinson, #35672)	Make auxiliary webviews exist in the constellation immediately (#35672)
+    - `https://github.com/servo/servo/pull/35672	(@delan, @mrobinson, #35672)	Make auxiliary webviews exist in the constellation immediately (#35672)
       embedding
-    - https://github.com/servo/servo/pull/35691	(@webbeef, #35691)	winit_mininal: support proper window resizing (#35691)
+    - `https://github.com/servo/servo/pull/35691	(@webbeef, #35691)	winit_mininal: support proper window resizing (#35691)
       embedding
 - gc
     - https://github.com/servo/servo/pull/35541	(@augustebaum, #35541)	Propagate `CanGc` arguments through callers in constructors (#35541)
@@ -383,17 +383,39 @@ Plus several new web API features:
 
 We’ve landed layout improvements around **‘border-collapse’** (@Loirooriol, #35219), **‘align-content: normal’** (@rayguo17, #35178), **‘place-self’** with **‘position: absolute’** (@Loirooriol, #35208), the **intrinsic sizing keywords** (@Loirooriol, #35413, #35469, #35471, #35630, #35642, #35663, #35652, #35688), and **‘position: absolute’** now works correctly in a **‘position: relative’ grid item** (@stevennovaryo, #35014).
 
-## Servo-the-browser
+## Servo-the-browser (servoshell)
 
 **Directory listings** are now enabled for local files (@mrobinson, #35317).
 
-servoshell’s **dialogs now use egui** (@chickenleaf, #34823, #35399, #35464, #35507, #35577, #35657, #35671), rather than shelling out to a program like `zenity` (@chickenleaf, #35674), making them more secure and no longer falling back to terminal input.
+servoshell’s **dialogs now use egui** (@chickenleaf, #34823, #35399, #35464, #35507, #35564, #35577, #35657, #35671), rather than shelling out to a program like `zenity` (@chickenleaf, #35674), making them more secure and no longer falling back to terminal input.
 
 We’ve also fixed a bug when closing a tab other than the current one (@pewsheen, #35569).
 
-## Embedding
+## Servo-the-engine (embedding)
+
+We’ve simplified our embedding API by **merging all input event delivery** into [`WebView::notify_input_event`](https://doc.servo.org/servo/struct.WebView.html#method.notify_input_event) (@mrobinson, @mukilan, #35430), making **bluetooth optional** (@jdm, @webbeef, #35479, #35590), making the **“background hang monitor” optional** (@jdm, #35256), and **eliminating the need to depend on `webxr`** (@mrobinson, #35229).
+We’ve also moved some servoshell-only options out of [`Opts`](https://doc.servo.org/servo_config/opts/struct.Opts.html) (@mrobinson, #35377, #35407), since they have no effect on Servo’s behaviour.
+
+We’ve landed our initial **delegate-based API** (@delan, @mrobinson, @mukilan, #35196, #35260, #35297, #35396, #35400, #35544, #35579, #35662, #35672), which replaces our old message-based API for integrating Servo with your app (@mrobinson, @delan, @mukilan, #35284, #35315, #35366).
+By implementing [`WebViewDelegate`](https://doc.servo.org/servo/trait.WebViewDelegate.html) and [`ServoDelegate`](https://doc.servo.org/servo/trait.ServoDelegate.html) and [installing](https://doc.servo.org/servo/struct.WebView.html#method.set_delegate) [them](https://doc.servo.org/servo/struct.Servo.html#method.set_delegate), you can have Servo call back into your app’s logic with ease.
+
+We’ve simplified the [`RenderingContext`](https://doc.servo.org/servo/trait.RenderingContext.html) trait (@wusyong, @mrobinson, #35251, #35553) and **added three built-in `RenderingContext` impls** (@mrobinson, @mukilan, #35465, #35501), making it easier to set up a context Servo can render to:
+
+- [`WindowRenderingContext`](https://doc.servo.org/servo/struct.WindowRenderingContext.html) renders to a **whole window**
+- [`OffscreenRenderingContext`](https://doc.servo.org/servo/struct.OffscreenRenderingContext.html) renders to **part of a window**
+- [`SoftwareRenderingContext`](https://doc.servo.org/servo/struct.SoftwareRenderingContext.html) renders to an image, **without hardware acceleration**
+
+We’ve heavily reworked and documented our **webview rendering model** (@mrobinson, @wusyong, @mukilan, #35522, #35621), **moved image output** and **shutdown logic** out of the compositor (@mrobinson, @wusyong, #35538), and removed some complicated logic around synchronous repaints when a window is resized (@mrobinson, #35283, #35277).
+These changes should make it a lot clearer how to get Servo’s webviews onto your display.
+
+One part of this model that we’re starting to move away from is the support for multiple webviews in one rendering context (@mrobinson, @wusyong, #35536).
+First landed in #31417, this was an expedient way to add support for multiple webviews, but it imposed some serious limitations on how webviews could be interleaved with other app content, and the performance and security was inadequate.
+
+We’ve **updated our [winit_minimal example](https://github.com/servo/servo/blob/139774e6b55c297bc94f7fcb8c9bf5bb8c6a7474/components/servo/examples/winit_minimal.rs)** to take advantage of these changes (@webbeef, #35350, #35686), simplify it further (@robertohuertasm, #35253), and fix window resizing (@webbeef, #35691).
+
+## Perf improvements
 
-We’ve moved some servoshell-only options out of [`Opts`](https://doc.servo.org/servo_config/opts/struct.Opts.html) (@mrobinson, #35377, #35407), since they have no effect on Servo’s behaviour.
+The compositor now **notifies the embedder of new frames immediately** (@mrobinson, #35369), not via the constellation thread.
 
 ## Donations