feat: added support for wasm engines

BREAKING CHANGE: all target-gates should switch to `#[cfg(engine)]` and
`#[cfg(client)]`, rather than using `target_arch`
BREAKING CHANGE: removed nnow obsolete `#[perseus::engine]` and
`#[perseus::browser]` macros

examples/.base/Cargo.toml

@@ -11,14 +11,14 @@ sycamore = "^0.8.1"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dev-dependencies]
+[target.'cfg(engine)'.dev-dependencies]
 fantoccini = "0.17"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(engine)'.dependencies]
 tokio = { version = "1", features = [ "macros", "rt", "rt-multi-thread" ] }
 ## **WARNING!** Before running this example outside the Perseus repo, replace the below line with
 ## the one commented out below it (changing the path dependency to the version you want to use)
 perseus-warp = { package = "perseus-integration", path = "../../../packages/perseus-integration", default-features = false }
 # perseus-warp = { path = "../../../packages/perseus-warp", features = [ "dflt-server" ] }
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(client)'.dependencies]

examples/comprehensive/tiny/Cargo.toml

@@ -9,11 +9,11 @@ edition = "2021"
 perseus = { path = "../../../packages/perseus" }
 sycamore = "^0.8.1"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(engine)'.dependencies]
 tokio = { version = "1", features = [ "macros", "rt", "rt-multi-thread" ] }
 ## **WARNING!** Before running this example outside the Perseus repo, replace the below line with
 ## the one commented out below it (changing the path dependency to the version you want to use)
 perseus-warp = { package = "perseus-integration", path = "../../../packages/perseus-integration", default-features = false }
 # perseus-warp = { path = "../../../packages/perseus-warp", features = [ "dflt-server" ] }
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(client)'.dependencies]

examples/comprehensive/tiny/Cargo.toml.example

@@ -7,8 +7,8 @@ edition = "2021"
 perseus = { version = "=0.4.0-beta.11", features = [ "hydrate" ] }
 sycamore = "^0.8.1"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(engine)'.dependencies]
 tokio = { version = "1", features = [ "macros", "rt", "rt-multi-thread" ] }
 perseus-warp = { version = "=0.4.0-beta.11", features = [ "dflt-server" ] }
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(client)'.dependencies]

examples/core/basic/Cargo.toml

@@ -11,14 +11,14 @@ sycamore = "^0.8.1"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dev-dependencies]
+[target.'cfg(engine)'.dev-dependencies]
 fantoccini = "0.17"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(engine)'.dependencies]
 tokio = { version = "1", features = [ "macros", "rt", "rt-multi-thread" ] }
 ## **WARNING!** Before running this example outside the Perseus repo, replace the below line with
 ## the one commented out below it (changing the path dependency to the version you want to use)
 perseus-warp = { package = "perseus-integration", path = "../../../packages/perseus-integration", default-features = false }
 # perseus-warp = { path = "../../../packages/perseus-warp", features = [ "dflt-server" ] }
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(client)'.dependencies]

examples/core/basic/Cargo.toml.example

@@ -11,8 +11,8 @@ sycamore = "^0.8.1"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(engine)'.dependencies]
 tokio = { version = "1", features = [ "macros", "rt", "rt-multi-thread" ] }
 perseus-warp = { version = "=0.4.0-beta.11", features = [ "dflt-server" ] }
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(client)'.dependencies]

examples/core/capsules/Cargo.toml

@@ -12,14 +12,14 @@ serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 lazy_static = "1"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dev-dependencies]
+[target.'cfg(engine)'.dev-dependencies]
 fantoccini = "0.17"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(engine)'.dependencies]
 tokio = { version = "1", features = [ "macros", "rt", "rt-multi-thread" ] }
 ## **WARNING!** Before running this example outside the Perseus repo, replace the below line with
 ## the one commented out below it (changing the path dependency to the version you want to use)
 perseus-warp = { package = "perseus-integration", path = "../../../packages/perseus-integration", default-features = false }
 # perseus-warp = { path = "../../../packages/perseus-warp", features = [ "dflt-server" ] }
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(client)'.dependencies]

examples/core/custom_server/Cargo.toml

@@ -11,12 +11,12 @@ sycamore = "^0.8.1"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dev-dependencies]
+[target.'cfg(engine)'.dev-dependencies]
 fantoccini = "0.17"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(engine)'.dependencies]
 tokio = { version = "1", features = [ "macros", "rt", "rt-multi-thread" ] }
 perseus-warp = { path = "../../../packages/perseus-warp", features = [ "dflt-server" ] }
 warp = { package = "warp-fix-171", version = "0.3" } # Temporary until Warp #171 is resolved
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(client)'.dependencies]

examples/core/custom_server/src/main.rs

@@ -4,8 +4,8 @@ use perseus::prelude::*;
 
 // Note: we use fully-qualified paths in the types to this function so we don't
 // have to target-gate some more imports
-#[cfg(not(target_arch = "wasm32"))] // We only have access to `warp` etc. on the engine-side, so this function
-                                    // should only exist there
+#[cfg(engine)] // We only have access to `warp` etc. on the engine-side, so this function
+               // should only exist there
 pub async fn dflt_server<
     M: perseus::stores::MutableStore + 'static,
     T: perseus::i18n::TranslationsManager + 'static,

examples/core/error_views/Cargo.toml

@@ -11,14 +11,14 @@ sycamore = "^0.8.1"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dev-dependencies]
+[target.'cfg(engine)'.dev-dependencies]
 fantoccini = "0.17"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(engine)'.dependencies]
 tokio = { version = "1", features = [ "macros", "rt", "rt-multi-thread" ] }
 ## **WARNING!** Before running this example outside the Perseus repo, replace the below line with
 ## the one commented out below it (changing the path dependency to the version you want to use)
 perseus-warp = { package = "perseus-integration", path = "../../../packages/perseus-integration", default-features = false }
 # perseus-warp = { path = "../../../packages/perseus-warp", features = [ "dflt-server" ] }
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(client)'.dependencies]

examples/core/error_views/src/templates/index.rs

@@ -4,7 +4,7 @@ use sycamore::prelude::*;
 fn index_page<G: Html>(cx: Scope) -> View<G> {
     // Deliberate panic to show how panic handling works (in an `on_mount` so we
     // still reach the right checkpoints for testing)
-    #[cfg(target_arch = "wasm32")]
+    #[cfg(client)]
     on_mount(cx, || {
         panic!();
     });

examples/core/freezing_and_thawing/Cargo.toml

@@ -14,11 +14,11 @@ serde_json = "1"
 [dev-dependencies]
 fantoccini = "0.17"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(engine)'.dependencies]
 tokio = { version = "1", features = [ "macros", "rt", "rt-multi-thread" ] }
 ## **WARNING!** Before running this example outside the Perseus repo, replace the below line with
 ## the one commented out below it (changing the path dependency to the version you want to use)
 perseus-warp = { package = "perseus-integration", path = "../../../packages/perseus-integration", default-features = false }
 # perseus-warp = { path = "../../../packages/perseus-warp", features = [ "dflt-server" ] }
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(client)'.dependencies]

examples/core/freezing_and_thawing/src/templates/about.rs

@@ -20,7 +20,7 @@ fn about_page<G: Html>(cx: Scope) -> View<G> {
 
         // We'll let the user freeze from here to demonstrate that the frozen state also navigates back to the last route
         button(id = "freeze_button", on:click = |_| {
-            #[cfg(target_arch = "wasm32")]
+            #[cfg(client)]
             {
                 use perseus::state::Freeze;
                 frozen_app.set(render_ctx.freeze());

examples/core/freezing_and_thawing/src/templates/index.rs

@@ -29,7 +29,7 @@ fn index_page<'a, G: Html>(cx: BoundedScope<'_, 'a>, state: &'a IndexPageStateRx
         br()
 
         button(id = "freeze_button", on:click = |_| {
-            #[cfg(target_arch = "wasm32")]
+            #[cfg(client)]
             {
                 use perseus::state::Freeze;
                 frozen_app.set(reactor.freeze());
@@ -39,7 +39,7 @@ fn index_page<'a, G: Html>(cx: BoundedScope<'_, 'a>, state: &'a IndexPageStateRx
 
         input(id = "thaw_input", bind:value = frozen_app, placeholder = "Frozen state")
         button(id = "thaw_button", on:click = |_| {
-            #[cfg(target_arch = "wasm32")]
+            #[cfg(client)]
             reactor.thaw(&frozen_app.get(), perseus::state::ThawPrefs {
                 page: perseus::state::PageThawPrefs::IncludeAll,
                 global_prefer_frozen: true

examples/core/global_state/Cargo.toml

@@ -14,11 +14,11 @@ serde_json = "1"
 [dev-dependencies]
 fantoccini = "0.17"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(engine)'.dependencies]
 tokio = { version = "1", features = [ "macros", "rt", "rt-multi-thread" ] }
 ## **WARNING!** Before running this example outside the Perseus repo, replace the below line with
 ## the one commented out below it (changing the path dependency to the version you want to use)
 perseus-warp = { package = "perseus-integration", path = "../../../packages/perseus-integration", default-features = false }
 # perseus-warp = { path = "../../../packages/perseus-warp", features = [ "dflt-server" ] }
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(client)'.dependencies]

examples/core/helper_build_state/Cargo.toml

@@ -11,14 +11,14 @@ sycamore = "^0.8.1"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dev-dependencies]
+[target.'cfg(engine)'.dev-dependencies]
 fantoccini = "0.17"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(engine)'.dependencies]
 tokio = { version = "1", features = [ "macros", "rt", "rt-multi-thread" ] }
 ## **WARNING!** Before running this example outside the Perseus repo, replace the below line with
 ## the one commented out below it (changing the path dependency to the version you want to use)
 perseus-warp = { package = "perseus-integration", path = "../../../packages/perseus-integration", default-features = false }
 # perseus-warp = { path = "../../../packages/perseus-warp", features = [ "dflt-server" ] }
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(client)'.dependencies]

examples/core/i18n/Cargo.toml

@@ -17,11 +17,11 @@ urlencoding = "2.1"
 [dev-dependencies]
 fantoccini = "0.17"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(engine)'.dependencies]
 tokio = { version = "1", features = [ "macros", "rt", "rt-multi-thread" ] }
 ## **WARNING!** Before running this example outside the Perseus repo, replace the below line with
 ## the one commented out below it (changing the path dependency to the version you want to use)
 perseus-warp = { package = "perseus-integration", path = "../../../packages/perseus-integration", default-features = false }
 # perseus-warp = { path = "../../../packages/perseus-warp", features = [ "dflt-server" ] }
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(client)'.dependencies]

examples/core/idb_freezing/Cargo.toml

@@ -15,11 +15,11 @@ wasm-bindgen-futures = "0.4"
 [dev-dependencies]
 fantoccini = "0.17"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(engine)'.dependencies]
 tokio = { version = "1", features = [ "macros", "rt", "rt-multi-thread" ] }
 ## **WARNING!** Before running this example outside the Perseus repo, replace the below line with
 ## the one commented out below it (changing the path dependency to the version you want to use)
 perseus-warp = { package = "perseus-integration", path = "../../../packages/perseus-integration", default-features = false }
 # perseus-warp = { path = "../../../packages/perseus-warp", features = [ "dflt-server" ] }
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(client)'.dependencies]

examples/core/idb_freezing/src/templates/about.rs

@@ -22,7 +22,7 @@ fn about_page<G: Html>(cx: Scope) -> View<G> {
         // We'll let the user freeze from here to demonstrate that the frozen state also navigates back to the last route
         button(id = "freeze_button", on:click = move |_| {
             // The IndexedDB API is asynchronous, so we'll spawn a future
-            #[cfg(target_arch = "wasm32")]
+            #[cfg(client)]
             spawn_local_scoped(cx, async move {
                 use perseus::state::{IdbFrozenStateStore, Freeze};
                 // We do this here (rather than when we get the render context) so that it's updated whenever we press the button

examples/core/idb_freezing/src/templates/index.rs

@@ -32,7 +32,7 @@ fn index_page<'a, G: Html>(cx: BoundedScope<'_, 'a>, state: &'a IndexPropsRx) ->
 
         button(id = "freeze_button", on:click = move |_| {
             // The IndexedDB API is asynchronous, so we'll spawn a future
-            #[cfg(target_arch = "wasm32")] // The freezing types are only available in the browser
+            #[cfg(client)] // The freezing types are only available in the browser
             spawn_local_scoped(cx, async {
                 use perseus::state::{IdbFrozenStateStore, Freeze, PageThawPrefs, ThawPrefs};
                 // We do this here (rather than when we get the reactor) so that it's updated whenever we press the button
@@ -54,7 +54,7 @@ fn index_page<'a, G: Html>(cx: BoundedScope<'_, 'a>, state: &'a IndexPropsRx) ->
 
         button(id = "thaw_button", on:click = move |_| {
             // The IndexedDB API is asynchronous, so we'll spawn a future
-            #[cfg(target_arch = "wasm32")] // The freezing types are only available in the browser
+            #[cfg(client)] // The freezing types are only available in the browser
             spawn_local_scoped(cx, async move {
                 use perseus::state::{IdbFrozenStateStore, Freeze, PageThawPrefs, ThawPrefs};
                 let idb_store = match IdbFrozenStateStore::new().await {

examples/core/index_view/Cargo.toml

@@ -14,11 +14,11 @@ serde_json = "1"
 [dev-dependencies]
 fantoccini = "0.17"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(engine)'.dependencies]
 tokio = { version = "1", features = [ "macros", "rt", "rt-multi-thread" ] }
 ## **WARNING!** Before running this example outside the Perseus repo, replace the below line with
 ## the one commented out below it (changing the path dependency to the version you want to use)
 perseus-warp = { package = "perseus-integration", path = "../../../packages/perseus-integration", default-features = false }
 # perseus-warp = { path = "../../../packages/perseus-warp", features = [ "dflt-server" ] }
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(client)'.dependencies]

examples/core/js_interop/Cargo.toml

@@ -11,15 +11,15 @@ sycamore = "^0.8.1"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dev-dependencies]
+[target.'cfg(engine)'.dev-dependencies]
 fantoccini = "0.17"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(engine)'.dependencies]
 tokio = { version = "1", features = [ "macros", "rt", "rt-multi-thread" ] }
 ## **WARNING!** Before running this example outside the Perseus repo, replace the below line with
 ## the one commented out below it (changing the path dependency to the version you want to use)
 perseus-warp = { package = "perseus-integration", path = "../../../packages/perseus-integration", default-features = false }
 # perseus-warp = { path = "../../../packages/perseus-warp", features = [ "dflt-server" ] }
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(client)'.dependencies]
 wasm-bindgen = "0.2"

examples/core/js_interop/src/templates/index.rs

@@ -1,14 +1,14 @@
 use perseus::prelude::*;
 use sycamore::prelude::*;
-#[cfg(target_arch = "wasm32")]
+#[cfg(client)]
 use wasm_bindgen::prelude::wasm_bindgen;
 
 fn index_page<G: Html>(cx: Scope) -> View<G> {
     view! { cx,
         // We'll use JS to change this message manually
         p(id = "message") { "Hello World!" }
         button(id = "change-message", on:click = |_| {
-            #[cfg(target_arch = "wasm32")]
+            #[cfg(client)]
             change_message()
         }) { "Change message with JS" }
     }
@@ -19,7 +19,7 @@ pub fn get_template<G: Html>() -> Template<G> {
 }
 
 // Of course, JS will only run in the browser, so this should be browser-only
-#[cfg(target_arch = "wasm32")]
+#[cfg(client)]
 // This path should be relative to the root of your project
 // That file will then be hosted behind `/.perseus/` and automatically fetched as needed
 #[wasm_bindgen(module = "/src/changeMessage.js")]

examples/core/plugins/Cargo.toml

@@ -15,11 +15,11 @@ toml = "0.5"
 [dev-dependencies]
 fantoccini = "0.17"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(engine)'.dependencies]
 tokio = { version = "1", features = [ "macros", "rt", "rt-multi-thread" ] }
 ## **WARNING!** Before running this example outside the Perseus repo, replace the below line with
 ## the one commented out below it (changing the path dependency to the version you want to use)
 perseus-warp = { package = "perseus-integration", path = "../../../packages/perseus-integration", default-features = false }
 # perseus-warp = { path = "../../../packages/perseus-warp", features = [ "dflt-server" ] }
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(client)'.dependencies]

examples/core/preload/Cargo.toml

@@ -11,14 +11,14 @@ sycamore = "^0.8.1"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dev-dependencies]
+[target.'cfg(engine)'.dev-dependencies]
 fantoccini = "0.17"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(engine)'.dependencies]
 tokio = { version = "1", features = [ "macros", "rt", "rt-multi-thread" ] }
 ## **WARNING!** Before running this example outside the Perseus repo, replace the below line with
 ## the one commented out below it (changing the path dependency to the version you want to use)
 perseus-warp = { package = "perseus-integration", path = "../../../packages/perseus-integration", default-features = false }
 # perseus-warp = { path = "../../../packages/perseus-warp", features = [ "dflt-server" ] }
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(client)'.dependencies]

examples/core/preload/src/templates/index.rs

@@ -3,7 +3,7 @@ use sycamore::prelude::*;
 
 fn index_page<G: Html>(cx: Scope) -> View<G> {
     // We can't preload pages on the engine-side
-    #[cfg(target_arch = "wasm32")]
+    #[cfg(client)]
     {
         // Get the reactor first, which is the one-stop-shop for everything
         // internal to Perseus in the browser

examples/core/router_state/Cargo.toml

@@ -11,11 +11,11 @@ sycamore = "^0.8.1"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 
-[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+[target.'cfg(engine)'.dependencies]
 tokio = { version = "1", features = [ "macros", "rt", "rt-multi-thread" ] }
 ## **WARNING!** Before running this example outside the Perseus repo, replace the below line with
 ## the one commented out below it (changing the path dependency to the version you want to use)
 perseus-warp = { package = "perseus-integration", path = "../../../packages/perseus-integration", default-features = false }
 # perseus-warp = { path = "../../../packages/perseus-warp", features = [ "dflt-server" ] }
 
-[target.'cfg(target_arch = "wasm32")'.dependencies]
+[target.'cfg(client)'.dependencies]

examples/core/router_state/src/templates/index.rs

@@ -4,7 +4,7 @@ use sycamore::prelude::*;
 fn router_state_page<G: Html>(cx: Scope) -> View<G> {
     let load_state_str = create_signal(cx, "We're on the server.".to_string());
 
-    #[cfg(target_arch = "wasm32")]
+    #[cfg(client)]
     {
         use perseus::router::RouterLoadState;
         let load_state = Reactor::<G>::from_cx(cx).router_state.get_load_state(cx);