turbofish doc links, RTTI comment, drop dead create_map branch

Author: ciscorn

build.rs

@@ -330,6 +330,9 @@ fn build_bridge(
         .includes(&bridge_include_dirs)
         .includes(include_dirs)
         .flag_if_supported("-std=c++20")
+        // mbgl-core defaults to no RTTI (CMake `MLN_WITH_RTTI=OFF` adds `-fno-rtti` on GCC/Clang).
+        // The bridge uses no `dynamic_cast`/`typeid`, so `-fno-rtti` is safe.
+        // (MSVC keeps RTTI on both sides)
         .flag_if_supported("-fno-rtti")
         .warnings(true)
         .warnings_into_errors(true);

examples/slint/src/maplibre/headless.rs

@@ -141,7 +141,5 @@ impl MapLibre {
 }
 
 pub fn create_map(size: Size) -> Rc<RefCell<MapLibre>> {
-    let map_size =
-        if size.width > 0 && size.height > 0 { size } else { Size { width: 0, height: 0 } };
-    Rc::new(RefCell::new(MapLibre::new(map_size)))
+    Rc::new(RefCell::new(MapLibre::new(size)))
 }

src/renderer/builder.rs

@@ -101,10 +101,17 @@ impl ImageRendererBuilder {
 
     /// Builds a continuous renderer.
     ///
-    /// Frames are host-driven: use [`ImageRenderer::set_render_requested_callback`] to wake the
-    /// host UI's display loop, then call [`ImageRenderer::render_once`] for each scheduled frame.
+    /// Frames are host-driven: use [`ImageRenderer::<Continuous>::set_render_requested_callback`] to wake the
+    /// host UI's display loop, then call [`ImageRenderer::<Continuous>::render_once`] for each scheduled frame.
     ///
     /// Use the `MapObserver` to react to signals from the map.
+    ///
+    /// # Breaking change
+    ///
+    /// This renderer no longer self-invalidates (MapLibre Native used to schedule
+    /// its own renders on update). The signature is unchanged, so existing callers
+    /// keep compiling but stop producing frames until they drive
+    /// [`render_once`](ImageRenderer::<Continuous>::render_once) themselves.
     #[must_use]
     pub fn build_continuous_renderer(self) -> ImageRenderer<Continuous> {
         ImageRenderer::new(MapMode::Continuous, self)

src/renderer/image_renderer.rs

@@ -583,6 +583,12 @@ impl ImageRenderer<Continuous> {
     ///
     /// Call this once per frame requested by the host UI for a renderer created with
     /// [`build_continuous_renderer`](crate::ImageRendererBuilder::build_continuous_renderer).
+    ///
+    /// It also advances MapLibre Native's run loop once so asynchronous work (style
+    /// and tile loading) can progress — except on macOS/iOS, where the Core
+    /// Foundation run loop is assumed to be driven by the host UI's main loop. A
+    /// continuous renderer on a dedicated Apple thread with no host loop must pump
+    /// it itself (see [`RunLoopHandle`]).
     pub fn render_once(&mut self) {
         self.instance.pin_mut().render_once();
     }