change: add `window_event_listener_untyped` and deprecate `window_event_listener` pending 0.3.0 (#913)

leptos/src/lib.rs

@@ -160,7 +160,8 @@ pub use leptos_dom::{
         request_animation_frame, request_animation_frame_with_handle,
         request_idle_callback, request_idle_callback_with_handle, set_interval,
         set_interval_with_handle, set_timeout, set_timeout_with_handle,
-        window_event_listener,
+        window_event_listener, window_event_listener_untyped,
+        window_event_listener_with_precast,
     },
     html, log, math, mount_to, mount_to_body, svg, warn, window, Attribute,
     Class, Errors, Fragment, HtmlElement, IntoAttribute, IntoClass,

leptos_dom/src/helpers.rs

@@ -408,9 +408,27 @@ pub fn set_interval_with_handle(
   instrument(level = "trace", skip_all, fields(event_name = %event_name))
 )]
 #[inline(always)]
+#[deprecated = "In the next release, `window_event_listener` will become \
+                typed. You can switch now to `window_event_listener_untyped` \
+                for the current behavior or use \
+                `window_event_listener_with_precast`, which will become the \
+                new`window_event_listener`."]
 pub fn window_event_listener(
     event_name: &str,
     cb: impl Fn(web_sys::Event) + 'static,
+) {
+    window_event_listener_untyped(event_name, cb)
+}
+
+/// Adds an event listener to the `Window`, typed as a generic `Event`.
+#[cfg_attr(
+  debug_assertions,
+  instrument(level = "trace", skip_all, fields(event_name = %event_name))
+)]
+#[inline(always)]
+pub fn window_event_listener_untyped(
+    event_name: &str,
+    cb: impl Fn(web_sys::Event) + 'static,
 ) {
     cfg_if::cfg_if! {
       if #[cfg(debug_assertions)] {
@@ -445,7 +463,7 @@ pub fn window_event_listener_with_precast<E: ev::EventDescriptor + 'static>(
 ) where
     E::EventType: JsCast,
 {
-    window_event_listener(&event.name(), move |e| {
+    window_event_listener_untyped(&event.name(), move |e| {
         cb(e.unchecked_into::<E::EventType>())
     });
 }

router/src/components/router.rs

@@ -169,7 +169,7 @@ impl RouterContext {
 
         // handle all click events on anchor tags
         #[cfg(not(feature = "ssr"))]
-        leptos::window_event_listener("click", {
+        leptos::window_event_listener_untyped("click", {
             let inner = Rc::clone(&inner);
             move |ev| inner.clone().handle_anchor_click(ev)
         });

router/src/history/mod.rs

@@ -55,7 +55,7 @@ impl History for BrowserIntegration {
 
         let (location, set_location) = create_signal(cx, Self::current(false));
 
-        leptos::window_event_listener("popstate", move |_| {
+        leptos::window_event_listener_untyped("popstate", move |_| {
             let router = use_context::<RouterContext>(cx);
             if let Some(router) = router {
                 let is_back = router.inner.is_back;